RustScan - 🤖 The Modern Port Scanner 🤖

项目说明

<di="center" markdown="1">

➡️ [Discord][discord] | [Installation Guide][toc-install] | [Usage Guide][usage-guide] ⬅️

<img src="pictures/rustscan.png" height=400px width=400px>

<!--<u>The Modern Port Scanner.</u>-->
Fast, smart, effective.

![Arch Linux package][badge-1] ![Built with Rust][badge-2] ![GitHub All Releases][badge-3] ![Crates.io][badge-4] ![Discord][badge-5] ![Actions][badge-6]

</div>

🤔 What is this?

![fast][speed-1]

The Modern Port Scanner. Find ports quickly (3 seconds at its fastest). Run scripts through our scripting 引擎 (Python, Lua, Shell supported).

🛠️ Installation

You can install RustScan's binary from our releases page.

We would prefer you to install with a package manager so it is tested and works for your system.

RustScan is in many repositories already. Install it with whate you wish:

![Packaging status]()

RustScan only officially supports Cargo installations, if you want to use that please install Rust and then cargo install rustscan

Example installations include:

MacOS:

Arch:

✨ Features

‼️ Important Links

| <!--Installation Guide--> | <!--Documentation--> | <!--Discord--> |
| :----------------------------------------: | :------------------------------------: | :-------------------------: |
| :book: [Installation Guide][toc-install] | :books: [Documentation][links-table-2] | :parrot: [Discord][discord] |
| | :penguin: ARM Support | |

🙋 Table of Contents

🔭 Why RustScan?

RustScan is a modern take on the port scanner. Sleek & fast. All while pro extensi to you.

Not to mention RustScan uses Adapti to impro over time, making it the best port scanner for you.

🧋 Speed

![fast][speed-1]

Speed is guaranteed . However, if you want to run a slow scan due to stealth, that is possible too.

Firstly, let's talk code.

We ha that check to see if RustScan is significantly slower than the previous . If it is, the continuous integration fails, and we can't commit 代码 to master unless we make it faster.

[HyperFine][speed-2] is used to monitor RustScan's performance over time to answer the question, "Are we getting faster? Are we getting slower?".

Every pull request is re by one person, but more often than not, two people review it. We test it manually and ensure the 代码 doesn't negatively affect performance.

[Read more here][speed-3].

⚙️ Extensible

![scripts][extensible-1]

_RustScan piping results into the custom Python script_

RustScan has a new scripting 引擎 that allows anyone to write scripts in most languages. Python, Lua, and Shell are all supported.

Want to take your found ports and pipe them into Nmap for further analysis? That's possible. Want to run smb-enum if SMB is found open? Possible.

The possibilities are endless -- and you can write scripts in whate you feel comfortable with.

[Read more here][extensible-2].

🌊 Adaptive

![adapti]

_RustScan automatically fine-tunes itself to match the host OS_

RustScan has a cool set of features called "Adapti". These features "learn" about the en you are scanning and how _you_ use RustScan to impro over time.

We use this umbrella term for any feature that fits this criterion. The list constantly changes, so [check out our wiki for more information][adapti].

👩‍🦯 Accessible

![fast][accessible-1]

RustScan is one of the first penetration testing tools that aims to be entirely accessible.

[Most penetration testing tools are not accessible][accessible-2], which negatively affects the whole industry.

RustScan has continuous integration testing that aims to ensure it is accessible, and we are constantly working on ways to improve our accessibility and ensure _e can use RustScan.

🤸 Usage

We have 2 usage guides. [Basic Usage][usage-1] and [Things you may want to do][usage-2].

We also ha about our config file [here][config-file-here].

🎪 Community

[Contributing][community-1] Read this to learn how.

Contributors ✨

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->


<!-- ALL-CONTRIBUTORS-BADGE:END -->

Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tr>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_<b>Bee</b></a><br /><a href="#infra-beeskerritt" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href=" title="Tests">⚠️</a> <a href=" title="代码">💻</a> <a href="#design-beeskerritt" title="Design">🎨</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>SakiiR</b>}</a><br /><a href=" title="代码">💻</a> <a href=" title="Bug reports">🐛</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>smackhack</b>}</a><br /><a href="#ideas-smackhack" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-smackhack" title="Examples">💡</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Bernardo Araujo</b>}</a><br /><a href=" title="代码">💻</a> <a href=" title="Bug reports">🐛</a> <a href="#design-bernardoamc" title="Design">🎨</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Izzy Whistlecroft</b>}</a><br /><a href=" title="Bug reports">🐛</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>imlonghao</b>}</a><br /><a href=" title="Bug reports">🐛</a> <a href="#maintenance-imlonghao" title="Maintenance">🚧</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>royharoush</b>}</a><br /><a href="#ideas-royharoush" title="Ideas, Planning, & Feedback">🤔</a> <a href="#design-royharoush" title="Design">🎨</a></td>
</tr>
<tr>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Atul Bhosale</b>}</a><br /><a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Thomas Gotwig</b>}</a><br /><a href="#platform-TGotwig" title="Packaging/porting to new platform">📦</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Rémi Gourdon</b>}</a><br /><a href=" title="Documentation">📖</a> <a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Ben (CMNatic)</b>}</a><br /><a href=" title="代码">💻</a> <a href=" title="Documentation">📖</a> <a href="#design-cmnatic" title="Design">🎨</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Alessandro Ferrari</b>}</a><br /><a href="#content-Ferryistaken" title="Content">🖋</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Phenomite</b>}</a><br /><a href="#content-Phenomite" title="Content">🖋</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Sandro</b>}</a><br /><a href="#content-SuperSandro2000" title="Content">🖋</a> <a href=" title="Bug reports">🐛</a> <a href=" title="代码">💻</a></td>
</tr>
<tr>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_<b>Cass</b></a><br /><a href="#platform-caass" title="Packaging/porting to new platform">📦</a> <a href=" title="代码">💻</a> <a href=" title="Bug reports">🐛</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Niklas Mohrin</b>}</a><br /><a href=" title="Documentation">📖</a> <a href=" title="代码">💻</a> <a href=" title="Bug reports">🐛</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Artem Polishchuk</b>}</a><br /><a href="#platform-tim77" title="Packaging/porting to new platform">📦</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>buermarc</b>}</a><br /><a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>bergabman</b>}</a><br /><a href=" title="代码">💻</a> <a href=" title="Bug reports">🐛</a> <a href="#design-bergabman" title="Design">🎨</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Dmitry Sa</b>}</a><br /><a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Sebastian Andersson</b>}</a><br /><a href=" title="代码">💻</a></td>
</tr>
<tr>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Matt Corbin</b>}</a><br /><a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>RootSploit</b>}</a><br /><a href="#blog-rootsploit" title="Blogposts">📝</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>eiffel-fl</b>}</a><br /><a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_{<b>Y.Horie</b>}</a><br /><a href=" title="代码">💻</a></td>
<td align="center"><a href=" src=" width="100px;" alt=""/><br />_<b>Oskar</b></a><br /><a href=" title="代码">💻</a> <a href=" title="Tests">⚠️</a></td>
</tr>
</table>

<!-- markdownlint-enable -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the all-contributors specification. Contributions of any kind welcome!

<!--Links-->

[Docker]: "This is the recommended distribution of rustscan"
[kali]: "Read the install guide"
[Kali/Debian]: "Kali Debian"
[Arch-Linux]: "Arch Linux installation of Rustscan"
[Homebrew]: "Homebrew install of Rustscan"
[usage-1]: "Basic Usage of Rustscan"
[usage-0]: "Use Docker Rustscan"
[config-file-here]: "RustScan Configuration File"
[usage-2]: "Things you may want to do with rustscan but don't know how"
[community-1]: "Learn how to contribute"
[distributions-1]: "Open Suse rustscan distribution"
[distributions-2]: "Rustscan in Fedora"
[repology-1]: "Packaging Status"
[install-1]: "Installation guide"
[accessible-2]: "Making Hacking Accessible"
[extensible-2]: "Scripting 引擎"
[speed-2]: "Hyperfine"
[speed-3]: "Increasing Speed & Accuracy"
[toc-community]: "Community"
[links-table-1]: "Full installation guide"
[links-table-2]: "Rustscan"
[discord]: "Discord blog"
[toc-install]: "Installation Guide Wiki"
[toc-docker-usage]: "Docker Installation Guide Wiki"
[usage-guide]:
[adapti]: "Adapti"

<!--Pictures-->

[DockerPic]: "Docker install"
[Kali1]: "Kali Picture"
[Arch]: "Arch Linux"
[Apple]: "Apple"
[rustscan-svg]: "Picture of rustscan repology"
[accessible-1]: pictures/accessible.gif "Fast"
[adaptive-1]: pictures/adaptive.gif "Adaptive"
[extensible-1]: pictures/scripts.gif "Scripts"
[speed-1]: pictures/fast.gif "Speed"
[badge-1]:
[badge-2]:
[badge-3]:
[badge-4]:
[badge-5]:
[badge-6]:

项目信息

开发语言：Rust

Star 数：20502

技术要点

该项目属于黑客技术方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕🤖 The Modern Port Scanner 🤖展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。