外观主题
阅读语言

Firelin —— 面向 AI 的授权网络评估工具集：端口扫描 / 子域枚举 / 目录枚举 / 指纹识别

软件 本站软件 1天前 更新于 21小时前
https://yxp.hk/p/9YE0A0

📦 开源仓库：yxpil/Firelin

gh-card · yxpil/Firelin

📦 仓库名片 · Powered by gh-card

Firelin

面向 AI Agent（尤其 BIT 生态）的紧凑型网络评估工具集：把授权评估最常用的四项侦察能力收进一个 CLI 和一个 HTTP API，并内置授权门控——智能体无法跳过显式确认直接发起扫描。Rust 单一静态二进制，跨平台。

⚠️ 法律声明：仅可用于自有资产或已获书面授权的资产。扫描类命令未经 --yes-i-have-permission（或 FIRELIN_I_HAVE_PERMISSION=yes）确认即拒绝执行。未经授权扫描计算机系统在绝大多数司法辖区属违法行为。

范围（v0.1 策略）：只侦察、不利用

不做漏洞利用、不做凭据爆破、不修改目标、不发送任何利用载荷。

5 个动作

  • portscan — worker 线程池 TCP connect 扫描；目标支持单 IP / 主机名（全部 A 记录）/ IPv4 CIDR；大于 /17 的网段直接拒绝（0.0.0.0/0 笔误永远不会失控）；默认保守：并发 200、连接超时 800 ms。
  • subdns — DNS 子域枚举：手写最小 DNS 客户端（零第三方解析库），内置约 200 个常见子域标签（或自定义词表），并发查询，输出存活子域及 A 记录。
  • dirscan — 目录/路径枚举：内置约 100 个常见路径（或自定义词表），按状态分类（exists 2xx / redirect 3xx / forbidden 401+403，404/410 忽略）。
  • fingerprint — 单次只读 GET：状态码、Server、X-Powered-By、X-AspNet-Version、X-Generator、<title>、重定向后最终 URL。
  • cidr — 纯计算：CIDR 展开为地址列表（同样规模上限）。

授权门控设计

  • CLI：未确认时扫描命令打印醒目声明并以退出码 2 拒绝；fingerprint/cidr 只读不门控。
  • serve 模式：未带授权标志启动的服务对扫描动作一律 403——不存在"单次调用临时授权"，要扫描就带标志重启。
  • MCP 下拒绝以 isError 结果返回并说明解锁标志，智能体可读懂并请求人工解锁。

接入与使用

firelin serve                    # 默认 127.0.0.1:8755，BIT Remote 协议 /invoke
firelin serve --yes-i-have-permission --token sekrit   # 解锁扫描 + Bearer 鉴权
  • BIT MCP 服务器页添加 http://127.0.0.1:8755/mcp，5 个动作即 5 个 MCP 工具；
  • HTTP API：GET /health、GET /invoke-actions、POST /invoke，--token 同样覆盖 MCP；
  • CLI exec 契约：stdin 管道传 JSON 合并覆盖 CLI 参数（stdin 优先）。

安装

从 Releases 下载（校验和由 Release CI 生成），或 cargo install --git https://github.com/yxpil/Firelin。

许可

Apache-2.0。Neton 观测网络，Firelin 评估网络——配合使用。

🛠 技术栈与开发

  • 开发语言：Rust 100% —— 单一静态二进制；只侦察、不利用（无漏洞利用 / 凭据爆破 / 目标修改 / 载荷投递）
  • 实现亮点：worker 线程池 TCP connect 扫描（保守默认：并发 200 / 超时 800 ms）；手写最小 DNS 客户端（零解析库依赖）做子域枚举；ureq GET 做目录枚举与单请求指纹
  • 接入面：CLI（stdin 管道 JSON 合并）+ BIT Remote /invoke + MCP /mcp（默认 127.0.0.1:8755）；--token Bearer 鉴权覆盖 MCP
  • 合规设计：--yes-i-have-permission 授权门控（CLI 退出码 2 / serve 模式 403，不存在单次临时授权）；网段大于 /17 直接拒绝，0.0.0.0/0 笔误永不失控

📚 文档与链接

  • 仓库：https://github.com/yxpil/Firelin · Releases（校验和由 Release CI 生成）
  • 与 Neton 配合定位：Neton 观测网络，Firelin 评估网络；SECFORGE 可把两者一并聚合为 MCP 工具