v2.1.2 核心优化与多架构发布 (#561)

* feat: v2.1.0 核心重构与功能增强 ## 架构重构 - 全局变量消除，迁移至 Config/State 对象 - SMB 插件融合（smb/smb2/smbghost/smbinfo） - 服务探测重构，实现 Nmap 风格 fallback 机制 - 输出系统重构，TXT 实时刷盘 + 双写机制 - i18n 框架升级至 go-i18n ## 性能优化 - 正则表达式预编译 - 内存优化 map[string]struct{} - 并发指纹匹配 - SOCKS5 连接复用 - 滑动窗口调度 + 自适应线程池 ## 新功能 - Web 管理界面 - 多格式 POC 适配（xray/afrog） - 增强指纹库（3139条） - Favicon hash 指纹识别 - 插件选择性编译（Build Tags） - fscan-lab 靶场环境 - 默认端口扩展（62→133） ## 构建系统 - 添加 no_local tag 支持排除本地插件 - 多版本构建：fscan/fscan-nolocal/fscan-web - CI 添加 snapshot 模式支持仅测试构建 ## Bug 修复 - 修复 120+ 个问题，包括 RDP panic、批量扫描漏报、 JSON 输出格式、Redis 检测、Context 超时等 ## 测试增强 - 单元测试覆盖率 74-100% - 并发安全测试 - 集成测试（Web/端口/服务/SSH/ICMP） * fix(ci): 移除 PR 对 Project 自动化的触发 * fix: Elasticsearch未授权检测优先于爆破 (#554) * fix: 修复RDP爆破高误报率问题 (#555) - 移除 screen.go 中错误的认证结果覆盖逻辑 - 启用 NLA 协议的 ErrorCode 字段检测 - 添加 PubKeyAuth 验证确保认证真正成功 - 修复 io.go 中错误被静默忽略的问题 - 修复 socket.go/io.go 中可能导致 panic 的代码 - 修复 screen.go 中文件句柄泄漏和 log.Panic * fix: 修复-user/-pwd凭据参数不生效的问题问题原因： - Parse()解析凭据后更新globalConfig - 但BuildConfigFromFlags()创建新Config时使用默认字典 - 导致解析的UserPassPairs等凭据信息被丢弃修复内容： 1. initialize.go: 将Parse解析的凭据结果应用到新Config 2. credential.go: 单用户密码对时创建UserPassPairs 3. rdp.go: 单凭据测试时跳过指纹识别，减少连接次数 * feat: RDP使用NLA仅验证模式，避免挤掉已登录用户 - 添加ErrNLAAuthSuccess标志用于NLA验证成功信号 - tpkt层支持nlaAuthOnly模式，验证成功后不建立完整会话 - x224层正确传播NLA验证结果 - rdpCrack改用NlaAuth进行凭据验证 * fix: 修复进度条在Windows终端满屏重复输出的问题 - 添加终端宽度检测，动态调整进度条长度 - 使用空格覆盖清除旧内容，避免残留 - 简化进度条格式，确保不超过终端宽度 * feat: 优化日志颜色方案，区分漏洞和普通信息 - 新增 LogVuln 级别（红色），用于漏洞和重要发现 - 密码爆破成功、未授权访问、POC漏洞等改用红色显示 - 普通信息（扫描统计等）改为白色 - Web指纹保持绿色 * refactor: 精简化输出，移除冗余启动信息 - 移除showParseSummary开局配置输出 - 移除LogPluginInfo/LogPluginInfoWithPort插件信息输出 - 移除alive_scanner冗余统计输出 - 移除port_scan_start扫描开始提示 - 移除handleUDPPorts SNMP死代码 - 移除相关i18n条目 * chore: 版本号更新为2.1.1 * fix: 降级依赖版本以保持Go 1.20兼容性 * feat(ldap): 添加NTLM Hash认证支持 (#433) * chore: 清理无用的 replace 指令 * fix(ping): 修复 TTL expired 导致主机误判为存活的问题在 ExecCommandPing 中增加错误关键词检测，当 ping 输出包含 TTL expired、Destination unreachable 等错误信息时，不再将目标主机标记为存活。 Fixes #454 * fix(proxy): 修复透明代理导致输出全端口的问题在代理初始化时主动探测代理行为，通过连接 RFC 5737 保留的测试地址来检测是否存在"全回显"问题。如果探测到代理不可靠，则在端口扫描时跳过所有端口，避免误报。 - 新增 proxyReliable 标志位标记代理可靠性 - 新增 ProbeProxyBehavior 函数探测代理行为 - 端口扫描前检查代理可靠性并输出警告 Fixes #495 * refactor: 移动debug模块到common/debug子包 * fix(web): 修复-u模式下Web插件未执行的问题 * fix: 优化输出格式和颜色显示 - 网段统计格式改为 10.253.0.0/16 网段存活: 26 - WebTitle基础信息改为白色，指纹识别单独绿色输出 - 移除重复的端口数量输出 * fix: URL解析自动补全协议头 -uf 文件中 192.168.1.1:8080 自动转为 http://192.168.1.1:8080 * fix: 修复-u/-uf模式下URLs丢失导致0目标扫描的问题 Parse阶段将URLs设置到全局状态，但Initialize随后创建新状态并覆盖了全局状态，导致URLs数据丢失。现在在创建新状态前先保存并迁移Parse阶段设置的URLs和HostPorts数据。 * fix: 智能检测HTTP/HTTPS协议并优化URL显示 - 修复-u/-uf模式URLs丢失导致0目标扫描问题 - detectProtocol改为主动TLS握手检测，不依赖服务名 - WebTitle输出显示完整协议(http/https) - 隐藏标准端口(80/443)使输出更简洁 * refactor: 精简parsers包，统一配置构建入口 - 删除冗余的中间层（XXXInput、XXXParser类） - 新增 config_builder.go 统一配置构建 - parsers包从3000+行精简至~540行 - 保留核心函数：ParseIP、ParsePort、文件读取、凭据解析 * test: 扩展parsers单元测试覆盖边缘情况 - 新增内网简写解析测试(192/172/10) - 新增完整IP范围和无效CIDR测试 - 新增Windows行尾(CRLF)处理测试 - 新增凭据和哈希文件解析测试 - 新增端口解析边缘情况测试 - 测试覆盖率达到94.2% * refactor: 优化控制台输出格式 - 去掉时间戳，保留[*][+]前缀 - Web输出合并WebTitle和WebFinger为一行 - 有指纹显示绿色[+]，无指纹显示白色[*] - 格式: code:xxx len:xxx title:xxx server:xxx [指纹] - 服务探测格式: [Product:xxx ||Version:xxx] Banner:(xxx) - 字段对齐，输出更清爽 * feat: 添加凭据测试未发现弱密码的提示 - credential_tester.go: 失败时设置 Type=ResultTypeCredential - scanner.go: 根据结果类型在 error 级别输出'未发现弱密码'提示 - 新增 i18n 翻译 brute_no_weak_pass 使用 -log all 或 -log error 可看到此提示 * refactor(logging): 重构日志级别为层级过滤设计 - LogLevel 从 string 改为 int 类型，支持层级比较 - 层级设计：Debug(0) < Base(1) < Info(2) < Success(3) < Vuln(4) < Error(5) - 设置一个级别后，显示该级别及以上的日志 - Error 级别始终显示，不会被配置过滤掉 - 保留向后兼容别名（LevelAll, LevelInfoSuccess 等） - 更新测试以匹配新的层级过滤行为 * style(logging): Error级别日志改为黄色显示 * style(findnet): NetInfo输出改为每行一个IP * refactor(ms17010): 优化错误提示，明确指出SMBv1不支持等情况 * fix(credential): 修复凭据测试结果不一致的问题问题原因： 1. 未知错误类型不重试，导致服务端限流时跳过正确密码 2. SSH 错误分类不够准确，某些临时错误未被识别修复内容： 1. 未知错误改为可重试（可能是临时问题） 2. 增加 SSH 特有的网络错误识别（handshake failed, disconnect 等） * fix(portfinger): 修复SMB2服务指纹识别和NetInfo输出问题 - 添加SMB2ProgNeg探针支持现代Windows的SMB2协议 - 修复Go regexp对高位字节的UTF-8兼容问题，使用Latin-1转换 - 修复探针失败后连接重建逻辑 - 修复vendor_product字段名不匹配问题 - 修复NetInfo多行输出被其他日志打断的问题 * fix(config): 从默认端口移除9100，避免触发打印机打印 (#517) * feat(proxy): 增强代理端口扫描的深度验证机制 - 新增4阶段深度验证：Banner读取→探测发送→响应等待→最终判定 - 新增SOCKS5错误码和代理错误文本检测 - 优化ProbeProxyBehavior探测逻辑，发送数据验证连接可达性 - 解决透明代理/全回显代理导致的假阳性问题 * fix(proxy): 修复代理深度验证的若干问题 - detector.go: 修复 AutoConfigureProxy 覆盖探测结果的问题只有未探测过时才设置默认 proxyReliable 值 - port_scan.go: 改进深度验证机制 - 使用带 Host header 的 HTTP GET 请求替代 OPTIONS - 延长响应等待超时至 2s 以适配慢速服务器 - 正确重置连接 deadline 避免影响后续操作 * refactor: 统一 common 包文件命名风格 Flag.go -> flag.go * refactor(proxy): 删除自定义 contains() 函数，改用标准库 - 用 strings.Contains() 替代手写的 contains() - 删除过时的注释 * fix(parsers): 修复带横杠域名被误识别为IP范围的问题如 111-555.sss.com 这类域名因包含 - 被错误解析为 IP 范围，添加 looksLikeIPRange() 检查，只有 - 前是有效 IP 才走范围解析 * fix(proxy): 修复代理模式下服务识别错误和端口漏扫问题 - port_scan.go: 验证通过后重建干净连接，避免HTTP GET探测污染服务识别 - port_scan.go: 优化验证策略，用轻量CRLF探测替代HTTP GET，超时从2.2s降至0.6s - manager.go: 修正ProbeProxyBehavior判断逻辑，超时应视为代理正常转发 * fix(pool): 移除线程池预分配，优化大规模扫描内存占用 WithPreAlloc(true) 会预先创建所有 worker goroutine，在大规模扫描(如 25域名×65535端口)时可能导致内存问题 * refactor(logging): 统一日志前缀，删除废弃的 LogBase - 删除 LogBase 函数，所有调用迁移到 LogInfo/LogError - 新增 PrefixDebug ([.]) 前缀，所有日志级别现在都有前缀 - 修复日志输出缩进不一致的问题 - 删除未使用的 PrefixDefault 常量 * perf(icmp): 实现自适应等待算法优化存活检测性能 - 新增 waitAdaptive 函数，监控响应增量实现智能提前结束 - 算法保守原则：最小等待1s + 连续500ms无新响应才提前结束 - 添加100ms检查间隔避免CPU空转 - 保留原有最大等待时间(3s/6s)作为兜底 - 添加完整单元测试覆盖各种场景优化效果： - 全部响应：~100ms (原3s) - 无响应：~1s (原3s) - 部分响应后稳定：~1.5s (原3s) * perf(scan): 实现启发式优化提升扫描体验 1. 端口优先级排序：高价值端口(80,443,22,3389等)优先扫描 - 用户能更快看到有意义的结果 - 不影响端口喷洒策略 2. TCP 补充探测：ICMP 响应率<10%时自动启用 - 对未响应主机用 TCP 80/443/22/445 补充探测 - 解决防火墙过滤 ICMP 导致漏检的问题 * refactor(grdp): 精简RDP库，删除认证检测不需要的代码 - 删除 VNC 协议支持 (protocol/rfb, client/rfb.go) - 删除完整客户端框架 (client/) - 删除 RemoteApp 等插件 (plugin/) - 删除 RLE 图形解压 (core/rle.go) - 删除绘图指令处理 (pdu/orders.go, pdu/gdi.go) - 精简 screen.go，移除截图和完整会话功能 - 移除未使用的 RGB 转换函数 grdp 代码从 13,044 行精简至 7,581 行，削减 42% * refactor(common): 删除死代码，优化代码风格 - 删除未使用的 joinStrings/joinInts 函数 - 删除未使用的 memStats 字段和 getMemoryInfo 方法 - 简化 parsePasswords 中的循环为 append(...) 形式 * refactor(services): 统一数据库插件的DBWrapper 4个数据库插件(MySQL、PostgreSQL、MSSQL、Oracle)都有相同的sql.DB包装代码，合并为通用的SQLDBWrapper，减少重复。 * refactor(core,grdp): 删除未使用的死代码 - 移除 BaseScanStrategy.LogPluginInfoWithPort 方法（无调用者） - 移除 mcs.go 中被注释的旧 connect 函数实现 * refactor: 删除 deadcode 检测出的未使用函数 - proxy/detector.go: 删除 IsSOCKS5Standard, IsProxyInitialized - findnet.go: 删除 NetworkInfo.OneLine, TreeFormat 方法 - port_scan.go: 删除 estimateScanTime 函数 - web_scanner.go: 删除 GetFingerprints 函数 - 清理相关测试代码 * refactor: 删除更多未使用的死代码 - parse.go: 删除 RemoveDuplicate 函数及其测试 - parsers.go: 删除 excludeHosts, removeDuplicates 别名函数 - 更新测试使用真正的函数名 * fix(test): 修复 TestParseIP_InvalidIPRange 测试用例 - 删除不合理的测试用例（无效IP被当作普通主机名处理是设计行为） - 修复测试逻辑，只在真正通过时输出"正确" * fix(scan): 移除域名预解析，保留原始域名进行扫描域名预解析会将域名转换为IP，导致虚拟主机场景下HTTP访问失败（Host头变成IP而非域名，无法正确路由） * fix(scan): 修复 -hf 参数无法单独使用的问题 * fix(proxy): 修复透明代理环境下 SOCKS5 代理全端口误报问题问题：在透明代理(TUN模式)环境下使用 SOCKS5 代理扫描时，会出现全端口开放的误报，因为代理可靠性检测被透明代理污染。修复方案（参考 fscanx）： 1. 将探针从 CRLF 改为 HTTP GET，更有效检测真实连接状态 2. 删除 "uncertain" 状态，无响应一律判定为端口关闭 3. 调整超时时间以适应代理链路延迟 Fixes #524 * feat(telnet): 新增 telnetd RCE 命令执行验证，修复未授权访问日志级别 * fix: 修复 i18n.Tr vet 报错、Unicode 测试用例，移除过期域名 - 移除 i18n.Tr 中错误的 fmt.Sprintf fallback，消除 go vet 误报 - 修复 match_engine_test Unicode 测试用例与 Latin-1 转换逻辑不匹配 - README 移除过期的 fscan.club 域名 - 添加 .gitattributes 统一换行符为 LF * refactor: 统一控制台输出风格，使用统一的日志函数手动合并 PR #558 的改动，适配重构后的代码路径 * fix(ci): 修复版本注入和CI触发配置 - goreleaser ldflags 指向正确的包路径 common.version/commit/date - version 改为 var 支持 ldflags 注入，banner 显示 commit 和构建日期 - test-build 触发分支增加 dev-* 通配 * fix(ci): 修复 Windows 产物 .exe.exe 双后缀问题 * feat(ci): 扩展构建架构支持 MIPS/ARM/FreeBSD/Solaris
2026-09-22 03:10:42 +08:00 · 2026-04-25 17:39:16 +08:00
parent 594f567650
commit 760c8ea502
927 changed files with 82001 additions and 24995 deletions
@@ -0,0 +1,564 @@
+package lib
+
+import (
+	"bytes"
+	"compress/gzip"
+	"errors"
+	"fmt"
+	"io"
+	"math/rand" //nolint:gosec // G404: math/rand用于生成测试数据，非加密用途
+	"net/http"
+	"net/url"
+	"strconv"
+	"strings"
+	"sync"
+	"time"
+
+	"github.com/google/cel-go/cel"
+	"github.com/google/cel-go/checker/decls"
+	"github.com/google/cel-go/common/types"
+	"github.com/google/cel-go/common/types/ref"
+	"github.com/google/cel-go/interpreter/functions"
+	"github.com/shadow1ng/fscan/common"
+	"github.com/shadow1ng/fscan/common/i18n"
+	exprpb "google.golang.org/genproto/googleapis/api/expr/v1alpha1"
+)
+
+// 基础CEL环境缓存（避免重复创建，减少内存分配）
+var (
+	baseEnvOnce    sync.Once
+	baseEnv        *cel.Env
+	baseProgramOpt []cel.ProgramOption
+)
+
+// 包级POC配置
+var (
+	pocConfigOnce sync.Once
+	pocDNSLog     bool // DNSLog配置缓存
+)
+
+// InitPOCConfig 初始化POC配置（在扫描开始前调用一次）
+// 这样CEL回调函数可以使用包级变量而非GetGlobalConfig
+func InitPOCConfig(dnsLog bool) {
+	pocConfigOnce.Do(func() {
+		pocDNSLog = dnsLog
+	})
+}
+
+// NewEnv 创建一个新的 CEL 环境（使用缓存避免重复注册函数）
+func NewEnv(c *CustomLib) (*cel.Env, error) {
+	cachedCELEnvOnce.Do(func() {
+		cachedCELEnv, cachedCELEnvErr = cel.NewEnv(cel.Lib(c))
+	})
+	return cachedCELEnv, cachedCELEnvErr
+}
+
+// initBaseEnv 初始化基础CEL环境（只执行一次）
+func initBaseEnv() {
+	baseEnvOnce.Do(func() {
+		// 收集所有函数声明
+		var allDeclarations []*exprpb.Decl
+		allDeclarations = append(allDeclarations, registerStringDeclarations()...)
+		allDeclarations = append(allDeclarations, registerEncodingDeclarations()...)
+		allDeclarations = append(allDeclarations, registerCryptoDeclarations()...)
+		allDeclarations = append(allDeclarations, registerRandomDeclarations()...)
+		allDeclarations = append(allDeclarations, registerMiscDeclarations()...)
+
+		// 收集所有函数实现
+		var allImplementations []*functions.Overload
+		allImplementations = append(allImplementations, registerStringImplementations()...)
+		allImplementations = append(allImplementations, registerEncodingImplementations()...)
+		allImplementations = append(allImplementations, registerCryptoImplementations()...)
+		allImplementations = append(allImplementations, registerRandomImplementations()...)
+		allImplementations = append(allImplementations, registerMiscImplementations()...)
+
+		// 保存程序选项供后续使用
+		//nolint:staticcheck // SA1019: cel.Functions已废弃但CEL库尚未提供替代方案
+		baseProgramOpt = []cel.ProgramOption{cel.Functions(allImplementations...)}
+
+		// 创建基础环境
+		var err error
+		baseEnv, err = cel.NewEnv(
+			cel.Container("lib"),
+			cel.Types(&UrlType{}, &Request{}, &Response{}, &Reverse{}),
+			//nolint:staticcheck // SA1019: cel.Declarations已废弃但CEL库尚未提供替代方案
+			cel.Declarations(
+				decls.NewIdent("request", decls.NewObjectType("lib.Request"), nil),
+				decls.NewIdent("response", decls.NewObjectType("lib.Response"), nil),
+				decls.NewIdent("reverse", decls.NewObjectType("lib.Reverse"), nil),
+			),
+			//nolint:staticcheck // SA1019: cel.Declarations已废弃但CEL库尚未提供替代方案
+			cel.Declarations(allDeclarations...),
+		)
+		if err != nil {
+			common.LogError(i18n.Tr("webscan_cel_init_failed", err))
+		}
+	})
+}
+
+// GetBaseEnv 获取基础CEL环境
+func GetBaseEnv() *cel.Env {
+	initBaseEnv()
+	return baseEnv
+}
+
+// GetBaseProgramOptions 获取基础程序选项
+func GetBaseProgramOptions() []cel.ProgramOption {
+	initBaseEnv()
+	return baseProgramOpt
+}
+
+// ExtendEnvWithVars 扩展基础环境，添加POC特定的变量声明
+func ExtendEnvWithVars(varDecls []*exprpb.Decl) (*cel.Env, error) {
+	base := GetBaseEnv()
+	if base == nil {
+		return nil, fmt.Errorf("基础CEL环境未初始化")
+	}
+	if len(varDecls) == 0 {
+		return base, nil
+	}
+	//nolint:staticcheck // SA1019: cel.Declarations已废弃但CEL库尚未提供替代方案
+	return base.Extend(cel.Declarations(varDecls...))
+}
+
+// MakeVarDecl 根据变量名和表达式创建变量声明
+func MakeVarDecl(key, value string) *exprpb.Decl {
+	switch {
+	case strings.HasPrefix(value, "randomInt"):
+		//nolint:staticcheck // SA1019: decls.NewIdent已废弃但CEL库尚未提供替代方案
+		return decls.NewIdent(key, decls.Int, nil)
+	case strings.HasPrefix(value, "newReverse"):
+		//nolint:staticcheck // SA1019: decls.NewIdent已废弃但CEL库尚未提供替代方案
+		return decls.NewIdent(key, decls.NewObjectType("lib.Reverse"), nil)
+	default:
+		//nolint:staticcheck // SA1019: decls.NewIdent已废弃但CEL库尚未提供替代方案
+		return decls.NewIdent(key, decls.String, nil)
+	}
+}
+
+// Evaluate 评估 CEL 表达式
+func Evaluate(env *cel.Env, expression string, params map[string]interface{}) (ref.Val, error) {
+	// 空表达式默认返回 true
+	if expression == "" {
+		return types.Bool(true), nil
+	}
+
+	// 编译表达式
+	ast, issues := env.Compile(expression)
+	if issues.Err() != nil {
+		return nil, fmt.Errorf("表达式编译错误: %w", issues.Err())
+	}
+
+	// 创建程序（使用缓存的程序选项）
+	program, err := env.Program(ast, GetBaseProgramOptions()...)
+	if err != nil {
+		return nil, fmt.Errorf("程序创建错误: %w", err)
+	}
+
+	// 执行评估
+	result, _, err := program.Eval(params)
+	if err != nil {
+		return nil, fmt.Errorf("表达式评估错误: %w", err)
+	}
+
+	return result, nil
+}
+
+// URLTypeToString 将 TargetURL 结构体转换为字符串
+func URLTypeToString(u *UrlType) string {
+	var builder strings.Builder
+
+	// 处理 scheme 部分
+	if u.Scheme != "" {
+		builder.WriteString(u.Scheme)
+		builder.WriteByte(':')
+	}
+
+	// 处理 host 部分
+	if u.Scheme != "" || u.Host != "" {
+		if u.Host != "" || u.Path != "" {
+			builder.WriteString("//")
+		}
+		if host := u.Host; host != "" {
+			builder.WriteString(host)
+		}
+	}
+
+	// 处理 path 部分
+	path := u.Path
+	if path != "" && path[0] != '/' && u.Host != "" {
+		builder.WriteByte('/')
+	}
+
+	// 处理相对路径
+	if builder.Len() == 0 {
+		if i := strings.IndexByte(path, ':'); i > -1 && strings.IndexByte(path[:i], '/') == -1 {
+			builder.WriteString("./")
+		}
+	}
+	builder.WriteString(path)
+
+	// 处理查询参数
+	if u.Query != "" {
+		builder.WriteByte('?')
+		builder.WriteString(u.Query)
+	}
+
+	// 处理片段标识符
+	if u.Fragment != "" {
+		builder.WriteByte('#')
+		builder.WriteString(u.Fragment)
+	}
+
+	return builder.String()
+}
+
+// CustomLib 自定义CEL库配置
+type CustomLib struct {
+	envOptions     []cel.EnvOption
+	programOptions []cel.ProgramOption
+}
+
+// 缓存CustomLib实例和CEL环境，避免重复注册CEL函数导致冲突
+var (
+	cachedCustomLib     CustomLib
+	cachedCustomLibOnce sync.Once
+	cachedCELEnv        *cel.Env
+	cachedCELEnvOnce    sync.Once
+	cachedCELEnvErr     error
+)
+
+// NewEnvOption 创建新的CEL环境配置（使用缓存避免重复注册）
+func NewEnvOption() CustomLib {
+	cachedCustomLibOnce.Do(func() {
+		cachedCustomLib = createCustomLib()
+	})
+	return cachedCustomLib
+}
+
+// createCustomLib 实际创建CustomLib（只执行一次）
+func createCustomLib() CustomLib {
+	c := CustomLib{}
+
+	// 收集所有函数声明
+	var allDeclarations []*exprpb.Decl
+	allDeclarations = append(allDeclarations, registerStringDeclarations()...)
+	allDeclarations = append(allDeclarations, registerEncodingDeclarations()...)
+	allDeclarations = append(allDeclarations, registerCryptoDeclarations()...)
+	allDeclarations = append(allDeclarations, registerRandomDeclarations()...)
+	allDeclarations = append(allDeclarations, registerMiscDeclarations()...)
+
+	c.envOptions = []cel.EnvOption{
+		cel.Container("lib"),
+		cel.Types(&UrlType{}, &Request{}, &Response{}, &Reverse{}),
+		//nolint:staticcheck // SA1019: cel.Declarations已废弃但CEL库尚未提供替代方案
+		cel.Declarations(
+			decls.NewIdent("request", decls.NewObjectType("lib.Request"), nil),
+			decls.NewIdent("response", decls.NewObjectType("lib.Response"), nil),
+			decls.NewIdent("reverse", decls.NewObjectType("lib.Reverse"), nil),
+		),
+		//nolint:staticcheck // SA1019: cel.Declarations已废弃但CEL库尚未提供替代方案
+		cel.Declarations(allDeclarations...),
+	}
+
+	// 收集所有函数实现
+	var allImplementations []*functions.Overload
+	allImplementations = append(allImplementations, registerStringImplementations()...)
+	allImplementations = append(allImplementations, registerEncodingImplementations()...)
+	allImplementations = append(allImplementations, registerCryptoImplementations()...)
+	allImplementations = append(allImplementations, registerRandomImplementations()...)
+	allImplementations = append(allImplementations, registerMiscImplementations()...)
+
+	c.programOptions = []cel.ProgramOption{
+		//nolint:staticcheck // SA1019: cel.Functions已废弃但CEL库尚未提供替代方案
+		cel.Functions(allImplementations...),
+	}
+
+	return c
+}
+
+// CompileOptions 返回环境编译选项
+func (c *CustomLib) CompileOptions() []cel.EnvOption {
+	return c.envOptions
+}
+
+// ProgramOptions 返回程序运行选项
+// 返回空切片，函数实现通过 GetBaseProgramOptions() 在 Evaluate() 时注入
+// 这避免了多次创建环境时重复注册函数导致的冲突
+func (c *CustomLib) ProgramOptions() []cel.ProgramOption {
+	return nil
+}
+
+// UpdateCompileOptions 更新编译选项，处理不同类型的变量声明
+func (c *CustomLib) UpdateCompileOptions(args StrMap) {
+	for _, item := range args {
+		key, value := item.Key, item.Value
+
+		// 根据函数前缀确定变量类型
+		var declaration *exprpb.Decl
+		switch {
+		case strings.HasPrefix(value, "randomInt"):
+			// randomInt 函数返回整型
+			//nolint:staticcheck // SA1019: decls.NewIdent已废弃但CEL库尚未提供替代方案
+			declaration = decls.NewIdent(key, decls.Int, nil)
+		case strings.HasPrefix(value, "newReverse"):
+			// newReverse 函数返回 Reverse 对象
+			//nolint:staticcheck // SA1019: decls.NewIdent已废弃但CEL库尚未提供替代方案
+			declaration = decls.NewIdent(key, decls.NewObjectType("lib.Reverse"), nil)
+		default:
+			// 默认声明为字符串类型
+			//nolint:staticcheck // SA1019: decls.NewIdent已废弃但CEL库尚未提供替代方案
+			declaration = decls.NewIdent(key, decls.String, nil)
+		}
+
+		//nolint:staticcheck // SA1019: cel.Declarations已废弃但CEL库尚未提供替代方案
+		c.envOptions = append(c.envOptions, cel.Declarations(declaration))
+	}
+}
+
+// 随机数生成器（带互斥锁保护，确保并发安全）
+//
+//nolint:gosec // G404: 用于生成测试数据，非加密用途
+var (
+	randSource = rand.New(rand.NewSource(time.Now().UnixNano()))
+	randMu     sync.Mutex
+)
+
+// randomLowercase 生成指定长度的小写字母随机字符串
+func randomLowercase(n int) string {
+	const lowercase = "abcdefghijklmnopqrstuvwxyz"
+	randMu.Lock()
+	defer randMu.Unlock()
+	return RandomStr(randSource, lowercase, n)
+}
+
+// randomUppercase 生成指定长度的大写字母随机字符串
+func randomUppercase(n int) string {
+	const uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+	randMu.Lock()
+	defer randMu.Unlock()
+	return RandomStr(randSource, uppercase, n)
+}
+
+// randomString 生成指定长度的随机字符串（包含大小写字母和数字）
+func randomString(n int) string {
+	const charset = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+	randMu.Lock()
+	defer randMu.Unlock()
+	return RandomStr(randSource, charset, n)
+}
+
+// reverseCheck 检查 DNS 记录是否存在
+// 使用包级pocDNSLog变量，由InitPOCConfig初始化
+func reverseCheck(r *Reverse, timeout int64) bool {
+	// 检查必要条件（使用包级配置变量）
+	if ceyeAPI == "" || r.Domain == "" || !pocDNSLog {
+		return false
+	}
+
+	// 等待指定时间
+	time.Sleep(time.Second * time.Duration(timeout))
+
+	// 提取子域名
+	sub := strings.Split(r.Domain, ".")[0]
+
+	// 构造 API 请求 TargetURL
+	apiURL := fmt.Sprintf("http://api.ceye.io/v1/records?token=%s&type=dns&filter=%s",
+		ceyeAPI, sub)
+
+	// 创建并发送请求
+	req, _ := http.NewRequest("GET", apiURL, nil)
+	resp, err := DoRequest(req, false)
+	if err != nil {
+		return false
+	}
+
+	// 检查响应内容
+	hasData := !bytes.Contains(resp.Body, []byte(`"data": []`))
+	isOK := bytes.Contains(resp.Body, []byte(`"message": "OK"`))
+
+	if hasData && isOK {
+		common.LogDebug(apiURL)
+		return true
+	}
+	return false
+}
+
+// RandomStr 生成指定长度的随机字符串
+func RandomStr(randSource *rand.Rand, letterBytes string, n int) string {
+	const (
+		// 用 6 位比特表示一个字母索引
+		letterIdxBits = 6
+		// 生成掩码：000111111
+		letterIdxMask = 1<<letterIdxBits - 1
+		// 63 位能存储的字母索引数量
+		letterIdxMax = 63 / letterIdxBits
+	)
+
+	// 预分配结果数组
+	randBytes := make([]byte, n)
+
+	// 使用位操作生成随机字符串
+	for i, cache, remain := n-1, randSource.Int63(), letterIdxMax; i >= 0; {
+		// 当可用的随机位用完时，重新获取随机数
+		if remain == 0 {
+			cache, remain = randSource.Int63(), letterIdxMax
+		}
+
+		// 获取字符集中的随机索引
+		if idx := int(cache & letterIdxMask); idx < len(letterBytes) {
+			randBytes[i] = letterBytes[idx]
+			i--
+		}
+
+		// 右移已使用的位，更新计数器
+		cache >>= letterIdxBits
+		remain--
+	}
+
+	return string(randBytes)
+}
+
+// DoRequest 执行 HTTP 请求
+func DoRequest(req *http.Request, redirect bool) (*Response, error) {
+	// 处理请求头
+	if req.Body != nil && req.Body != http.NoBody {
+		// 设置 Content-Length
+		req.Header.Set("Content-Length", strconv.Itoa(int(req.ContentLength)))
+
+		// 如果未指定 Content-Type，设置默认值
+		if req.Header.Get("Content-Type") == "" {
+			req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
+		}
+	}
+
+	// 执行请求
+	// 检查发包限制
+	if canSend, reason := common.CanSendPacket(); !canSend {
+		common.LogError(i18n.Tr("webscan_request_restricted", req.URL.String(), reason))
+		return nil, fmt.Errorf("发包受限: %s", reason)
+	}
+
+	var (
+		oResp *http.Response
+		err   error
+	)
+
+	if redirect {
+		oResp, err = Client.Do(req)
+	} else {
+		oResp, err = ClientNoRedirect.Do(req)
+	}
+
+	if err != nil {
+		// HTTP请求失败，计为TCP失败
+		common.GetGlobalState().IncrementTCPFailedPacketCount()
+		return nil, fmt.Errorf("请求执行失败: %w", err)
+	}
+
+	// HTTP请求成功，计为TCP成功
+	common.GetGlobalState().IncrementTCPSuccessPacketCount()
+	defer func() { _ = oResp.Body.Close() }()
+
+	// 解析响应
+	resp, err := ParseResponse(oResp)
+	if err != nil {
+		common.LogError(i18n.Tr("webscan_response_parse_failed", err))
+	}
+
+	return resp, err
+}
+
+// ParseURL 解析 TargetURL 并转换为自定义 TargetURL 类型
+func ParseURL(u *url.URL) *UrlType {
+	return &UrlType{
+		Scheme:   u.Scheme,
+		Domain:   u.Hostname(),
+		Host:     u.Host,
+		Port:     u.Port(),
+		Path:     u.EscapedPath(),
+		Query:    u.RawQuery,
+		Fragment: u.Fragment,
+	}
+}
+
+// ParseRequest 将标准 HTTP 请求转换为自定义请求对象
+func ParseRequest(oReq *http.Request) (*Request, error) {
+	req := &Request{
+		Method:      oReq.Method,
+		URL:         ParseURL(oReq.URL),
+		Headers:     make(map[string]string),
+		ContentType: oReq.Header.Get("Content-Type"),
+	}
+
+	// 复制请求头
+	for k := range oReq.Header {
+		req.Headers[k] = oReq.Header.Get(k)
+	}
+
+	// 处理请求体
+	if oReq.Body != nil && oReq.Body != http.NoBody {
+		data, err := io.ReadAll(oReq.Body)
+		if err != nil {
+			return nil, fmt.Errorf("读取请求体失败: %w", err)
+		}
+		req.Body = data
+		// 重新设置请求体，允许后续重复读取
+		oReq.Body = io.NopCloser(bytes.NewBuffer(data))
+	}
+
+	return req, nil
+}
+
+// ParseResponse 将标准 HTTP 响应转换为自定义响应对象
+func ParseResponse(oResp *http.Response) (*Response, error) {
+	resp := Response{
+		Status:      int32(oResp.StatusCode),
+		URL:         ParseURL(oResp.Request.URL),
+		Headers:     make(map[string]string),
+		ContentType: oResp.Header.Get("Content-Type"),
+	}
+
+	// 复制响应头，合并多值头部为分号分隔的字符串
+	for k := range oResp.Header {
+		resp.Headers[k] = strings.Join(oResp.Header.Values(k), ";")
+	}
+
+	// 读取并解析响应体
+	body, err := getRespBody(oResp)
+	if err != nil {
+		return nil, fmt.Errorf("处理响应体失败: %w", err)
+	}
+	resp.Body = body
+
+	return &resp, nil
+}
+
+// getRespBody 读取 HTTP 响应体并处理可能的 gzip 压缩
+func getRespBody(oResp *http.Response) ([]byte, error) {
+	// 读取原始响应体
+	body, err := io.ReadAll(oResp.Body)
+	if err != nil && !errors.Is(err, io.EOF) && len(body) == 0 {
+		return nil, err
+	}
+
+	// 处理 gzip 压缩
+	if strings.Contains(oResp.Header.Get("Content-Encoding"), "gzip") {
+		reader, err := gzip.NewReader(bytes.NewReader(body))
+		if err != nil {
+			return body, nil // 如果解压失败，返回原始数据
+		}
+		defer func() { _ = reader.Close() }()
+
+		decompressed, err := io.ReadAll(reader)
+		if err != nil && !errors.Is(err, io.EOF) && len(decompressed) == 0 {
+			return nil, err
+		}
+		if len(decompressed) == 0 && len(body) != 0 {
+			return body, nil
+		}
+		return decompressed, nil
+	}
+
+	return body, nil
+}