From 065ba6fae70240870b2a2573e259b7e5f56e98b4 Mon Sep 17 00:00:00 2001 From: ZacharyZcR Date: Sun, 14 Jun 2026 23:00:26 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20v2.2.0-rc.1=20rele?= =?UTF-8?q?ase=20notes=EF=BC=8C=E8=A6=86=E7=9B=96=E5=85=A8=E9=83=A8=2029?= =?UTF-8?q?=20=E4=B8=AA=20commit=20=E7=9A=84=E5=8F=98=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/release-notes/v2.2.0-rc.1.md | 113 +++++++++++++++++++++++---- 1 file changed, 98 insertions(+), 15 deletions(-) diff --git a/.github/release-notes/v2.2.0-rc.1.md b/.github/release-notes/v2.2.0-rc.1.md index 222efe9..20a7b8c 100644 --- a/.github/release-notes/v2.2.0-rc.1.md +++ b/.github/release-notes/v2.2.0-rc.1.md @@ -8,33 +8,116 @@ ## 与 v2.2.0-rc 的变更 -本版本聚焦**实机测试发现的可靠性问题修复**，无新功能。 +本版本基于大量实机测试反馈，**修复 30+ 个问题，新增自适应扫描系统**。183 个文件变更。 + +--- + +### 🚀 新功能 + +#### 自适应并发调度 + +扫描前自动探测网络环境（RTT、丢包率、fd limit），基于探测数据推导关键参数，替代硬编码默认值： + +- **Timeout**: `median_RTT + 4σ`（覆盖 99.9% 正常连接），下限 1s，上限 10s +- **ModuleThreadNum**: `ThreadNum / 30`，下限 5，上限 50 +- **MaxRetries**: 基于丢包率推导，保证全失败概率 <1% +- **ICMPRate / PocNum**: 跟随环境和并发自动调整 + +线程池升级为 **AIMD + 慢启动**：慢启动阶段 500ms 翻倍，稳态 AIMD（健康 +5%，拥塞 ×0.5），双信号（资源耗尽率 + RTT 趋势）驱动。 + +#### 协议级超时下限（ModuleTimeout） + +新增 `Config.ModuleTimeout()` 方法，保证插件级交互超时不低于 3s。自适应系统将端口扫描超时压到 1s 时，SSH 握手、SNMP 探测、数据库认证等多轮交互协议不再受影响。全部 44 个服务插件已迁移。 + +#### 限流错误分类（ErrorTypeThrottle） + +新增 `ErrorTypeThrottle` 错误类型，区分服务端限流（SSH MaxStartups 等）和真正的网络不可达。限流错误不计入连续失败计数，触发 500ms 退避后继续，避免误判目标不可达而提前放弃。 + +#### Web 版独立入口 + +- 拆分 `main.go` 为 `main_cli.go` 和 `main_web.go` +- Web 版结果存储从内存替换为 SQLite 持久化（纯 Go 零 CGO） + +--- ### 🐛 Bug 修复 -- **UDP 插件在 `-p` 指定端口时被跳过** — 用户指定 `-p 53,161` 等包含 UDP 端口时，DNS/SNMP 等 UDP 插件不会执行。现在按用户指定的端口过滤并正确调度 -- **Redis exploit 操作无超时保护** — exploit 阶段移除了全部 deadline，服务端卡滞时 goroutine 永久阻塞。现在设置 30s 操作超时 -- **Redis readReply 吞没非超时错误** — 只要读到任何数据就忽略所有错误，可能返回截断响应。现在仅对 timeout 类型错误做容忍 -- **service_probe 连接丢失后静默成功** — Write/Read 在 Conn=nil 时返回 nil 而非错误，导致后续探测静默跳过。现在返回明确的 errConnLost -- **SNMP 探测成功但终端无输出** — SNMP 插件缺少 `session.LogVuln` 调用，成功结果只写入文件不在终端显示 +#### 插件调度（#586 #587 #588） -### ⚡ 可靠性改善 +- **非标准端口服务无法匹配插件** — SSH 在 8881 端口，端口匹配失败导致插件不执行。新增服务名称缓存 + 指纹驱动回退匹配 (#588) +- **移除误导性的"无可用插件"日志** — 预检基于静态端口匹配，不代表实际不执行 (#588) +- **默认扫描 POC 结果缺失** — `executeRules` 返回空 `vulName` 导致检测结果被丢弃 (#586) +- **批量扫描（-hf）POC 缺失** — 并发压力下 HTTP 请求瞬时失败未重试，跳过指纹识别和 POC 触发。加入指数退避重试 (#587) +- **UDP 插件在 `-p` 指定端口时被跳过** — 现在按用户指定端口过滤并正确调度 +- **`-full` 模式下 Web 插件跳过 `IsMarkedWebService` 检查** +- **不确定服务补做 HTTP 回退探测**，覆盖自定义 HTTP 框架漏网场景 -- **协议级超时下限（ModuleTimeout）** — 新增 `Config.ModuleTimeout()` 方法，保证插件级交互超时不低于 3s。自适应系统将端口扫描超时压到 1s 时，SSH 握手/SNMP 探测/数据库认证等多轮交互协议不再受影响。全部 44 个服务插件已迁移 -- **SSH 爆破并发优化** — SSH 并发从 30 降至 3，避免触发 OpenSSH MaxStartups 限流导致大量连接被丢弃 -- **SSH 限流错误分类（ErrorTypeThrottle）** — 新增限流错误类型，区分服务端限流（MaxStartups）和真正的网络不可达。限流错误不计入连续失败计数，仅触发 500ms 退避后继续，避免误判目标不可达而提前放弃 -- **SSH 握手 TCP deadline** — 在 SSH NewClientConn 前设置 TCP 级别 deadline 兜底整个握手过程，握手成功后清除 -- **进度条竞态修复** — `ProgressManager.isActive` 从 `bool` 改为 `atomic.Bool`，消除 UpdateProgress 与 FinishProgress 之间的数据竞态 -- **gmtls stdout 竞态修复** — 移除 `suppressGMTLSStdout` 中对 `os.Stdout` 的非同步重定向，消除与 gmtls 内部 goroutine 的数据竞态 -- **Lint 清理** — 修复 cassandra/ipmi/mongodb/webscan 中的 ineffassign、unused、errcheck 问题 +#### UDP 插件 + +- **UDP 插件阻塞导致扫描无法结束** — `conn.Read()` 在目标不响应时无限阻塞。所有 UDP 插件（SNMP/BACnet/DNS/IPMI/TFTP）统一使用 context timeout + conn.Close 双保险 +- **SNMP community 爆破混入通用密码字典** — 57 个通用密码串行探测导致 10 分钟阻塞，精简为 8 个专用 community + +#### SSH + +- **SSH goroutine 泄漏** — `ssh.NewClientConn` 不接受 context，context 取消后底层 TCP 连接未关闭，大规模扫描时泄漏数万 goroutine +- **SSH 握手无 TCP deadline 兜底** — 在 `NewClientConn` 前设置 deadline，握手成功后清除 +- **SSH 爆破并发过高** — 从 30 降至 3，避免触发 OpenSSH MaxStartups 限流 + +#### Redis + +- **Redis exploit 无超时保护** — exploit 阶段移除了全部 deadline，改为 30s 超时 +- **Redis readReply 吞没非超时错误** — 现在仅对 timeout 类型错误做容忍 + +#### POC 引擎 + +- **DetectPocFormat 误判含 transport 的 fscan POC 为 xray 格式** — 修复后 388 个 POC 全部正确加载（之前 8 个失败） +- **CEL clustersend 结果判断错误** — 从字符串比较改为类型断言 +- **CEL wait() 函数 nil Reverse 指针 panic** +- **reverseCheck 无超时** — 加 10s 超时防止 ceye API 阻塞 +- **正则编译结果未缓存** — `doSearch`/`bmatches` 缓存到 `sync.Map` + +#### 参数与输出 + +- **`-gt` 全局超时参数是死代码** — 现在真正生效，超时后取消所有扫描任务 +- **`-nopoc` 禁用 POC 时仍输出错误日志** — 已修复 +- **`-debug` 日志文件写入失败** — `applyLogLevel` 重建 Logger 时丢失 `DebugLogFile` 配置 +- **`-hash` 不支持 LM:NT 格式** — 现在支持 `aad3b435b51404ee:31d6cfe0d16ae931...` 标准格式 +- **`-pwd` 不支持逗号分隔多个密码** — 现在 `-pwd "123,456,root"` 正确拆分 +- **`-nobr` 跳过了 Redis 未授权检测** — 未授权是服务探测不是爆破，不受 `-nobr` 影响 +- **非终端输出时 ANSI 控制码覆盖扫描结果** — 管道/重定向时自动禁用进度条和颜色 +- **静默模式 NDJSON banner 过长** — Redis INFO ~5KB 截断至 200 字符 +- **CSV 漏洞 Type 列为空** — 补全 `type` 字段 +- **SNMP 探测成功但终端无输出** — 补充 `session.LogVuln` 调用 + +#### 其他 + +- **service_probe 连接丢失后静默成功** — `Write`/`Read` 在 `Conn=nil` 时返回明确错误 +- **MongoDB readMongoMsg 未设置读超时** +- **TXTWriter.Close Sync 失败后未关闭文件** +- **MySQL 3306 服务名误识别为 genetec-5400** — nmap 指纹库误匹配，通过 banner 特征校正 +- **gmtls stdout 竞态** — 移除 `os.Stdout` 非同步重定向 + +--- + +### 🏗️ 架构优化 + +- **统一服务缓存** — `webServiceCache` 扩展为通用 `serviceCache`，下沉到 per-session State，消除多实例缓存串台 +- **CEL 表达式编译缓存** — 同一 POC 的所有规则共享编译后的 Program +- **POC 全局状态消除** — `allPocs` 全局变量改为 `pocStore` 按 PocPath 缓存，并发场景不再互相覆盖 +- **进度条竞态修复** — `isActive` 改为 `atomic.Bool` +- **Lint 全量修复** — cassandra/ipmi/mongodb/webscan 的 ineffassign、unused、errcheck + +--- ### 📊 实测验证 | 指标 | v2.2.0-rc | v2.2.0-rc.1 | |------|-----------|-------------| | SSH `-m ssh` 爆破成功率 | ~60% | 100% (10/10) | -| SNMP `-p 161` 终端输出 | ✗ 不显示 | ✓ 正常 | +| POC 加载成功率 | 380/388 | 388/388 | | UDP 插件 `-p` 指定端口 | ✗ 跳过 | ✓ 正确调度 | +| SNMP 终端输出 | ✗ 不显示 | ✓ 正常 | +| UDP 扫描耗时（无响应目标） | ∞ 卡死 | 9s 完成 | | Redis exploit 超时保护 | ✗ 无 | ✓ 30s | ---