「渊照」是一款功能强大的专业暗链扫描工具，专注于检测网站、HTML文件或目录中的隐蔽链接、隐藏元素和恶意代码。该工具能够智能识别扫描目标类型（本地文件/目录、内网URL、公网URL），并自动调整扫描策略以获得最佳效果，是安全人员进行网站安全审计和应急响应的理想工具。
- 多类型目标支持：自动识别和扫描本地文件、本地目录、内网URL和公网URL
- 差异化扫描策略：根据目标类型应用最优扫描策略
- 递归目录扫描：支持可配置的扫描深度
- 文件过滤机制：支持通过通配符排除特定文件或目录
- 多层次检测机制：HTML代码检测、JavaScript代码分析、CSS代码检测、元标签扫描、注释内容分析
- 高级威胁识别：加密/编码链接检测、可疑域名检测、随机生成域名检测、短链接服务检测、非标准端口检测、可疑查询参数检测
- 特殊隐藏手法检测：CSS隐藏技术、颜色隐藏、零宽字符隐藏、字体大小隐藏等
- 关键字匹配系统：支持CSV格式自定义关键字文件，包含关键字、类别和风险权重
- 智能风险评分：基于多维度风险评估
- 动态内容捕获：使用Chrome无头浏览器执行JavaScript并捕获动态内容
- DOM操作监控：跟踪动态DOM修改
- iframe深度分析：渲染和分析iframe内容
- 网络请求捕获：监控HTTP请求和重定向链
- 多种报告格式：文本报告(txt)、HTML报告(html)、JSON报告(json)、CSV报告(csv)
- 丰富的报告内容：扫描概览、问题详情、风险评估、上下文展示
- 多种扫描模式：基础扫描(basic)、高级扫描(advanced)、全部扫描(all)
- 性能优化选项：可配置并发线程数、请求超时设置、代理服务器支持
- Python 3.8+
pip install -r requirements.txtpython YuanZhao.py --help# 基本扫描 - 单个HTML文件
python YuanZhao.py /path/to/file.html
# 高级扫描 + HTML报告
python YuanZhao.py /path/to/file.html -m advanced -f html
# 详细日志模式
python YuanZhao.py /path/to/suspicious.html --verbose
# 自定义输出目录
python YuanZhao.py /path/to/file.html -o /custom/report/dir
# 特定报告格式（JSON）
python YuanZhao.py /path/to/file.html -f json# 默认深度扫描目录
python YuanZhao.py /path/to/website
# 自定义深度扫描（仅当前目录和一级子目录）
python YuanZhao.py /path/to/website -d 1
# 深度递归扫描
python YuanZhao.py /path/to/website -d 5
# 排除特定文件/目录
python YuanZhao.py /path/to/website --exclude "*.jpg" "*.png" "logs/*" "vendor/"
# 调整线程数（提高性能）
python YuanZhao.py /path/to/website -t 16
# 完整模式 + 多格式报告
python YuanZhao.py /path/to/website -m all -f html -o security_reports --threads 12# 基本网站扫描
python YuanZhao.py https://example.com
# 内网地址扫描
python YuanZhao.py http://192.168.1.100
# 本地开发服务器扫描
python YuanZhao.py http://localhost:8080
# 带路径的URL扫描
python YuanZhao.py https://example.com/news/article
# 设置超时时间
python YuanZhao.py https://example.com --timeout 60
# 使用代理服务器
python YuanZhao.py https://example.com --proxy http://127.0.0.1:8080
# 带认证的代理
python YuanZhao.py https://example.com --proxy http://username:password@proxy.example.com:8080# 无头浏览器扫描（动态内容）
python YuanZhao.py https://dynamic-website.com --headless
# 无头浏览器 + 延长等待时间
python YuanZhao.py https://heavy-js-website.com --headless --js-wait 10
# 自定义关键字检测
python YuanZhao.py /path/to/target --keyword-file custom_keywords.txt
# 基础模式快速扫描
python YuanZhao.py https://example.com -m basic -d 1 -t 5
# 全部模式深度扫描
python YuanZhao.py /path/to/important-site -m all -d 3 -f html --verbose# 应急响应场景
python YuanZhao.py /compromised/webroot -m all -f html -o incident_response --keyword-file malware_keywords.txt --verbose
# 定期安全审计
python YuanZhao.py /path/to/webroot -d 3 -m advanced -f json -o weekly_scan_$(date +%Y%m%d)
# 新闻页面专项扫描
python YuanZhao.py https://example.com/news -m all -d 1 -t 8 --verbose
# 大规模并行扫描
python YuanZhao.py /large/website -d 2 -t 20 --exclude "*.zip" "*.rar" "backup/*"
# 自动化集成扫描（生成JSON报告）
python YuanZhao.py https://example.com -f json -o automated_scan_results --no-color关键字文件为CSV格式，每行包含三个字段：
关键字,类别,风险权重
poker,gambling,8
casino,gambling,9
malware,malware,10
phishing,phishing,9
类别可选值：gambling (博彩)、porn (色情)、malware (恶意软件)、phishing (钓鱼)、other (其他) 风险权重范围：1-10（10为最高风险）
target: 扫描目标（文件路径、目录路径或URL）- 必需参数-d, --depth: 递归扫描深度（默认：3，0表示仅扫描当前文件/目录）-m, --mode: 扫描模式（basic/advanced/all，默认：all）-t, --threads: 并发线程数（默认：8）
-o, --output: 报告输出目录（默认：./reports）-f, --format: 报告格式（txt/html/json/csv，默认：txt）
--timeout: 请求超时时间（秒，默认：30）--proxy: 代理设置
--keyword-file: 自定义关键字文件路径--exclude: 排除的文件或目录--verbose: 显示详细日志信息--no-color: 禁用彩色输出（适用于自动化脚本）
--headless: 启用无头浏览器扫描--browser-type: 无头浏览器类型（支持: chrome，默认: chrome）--js-wait: JavaScript执行等待时间（秒，默认: 3）
Q: 扫描结果中的误报如何处理？ A: 可以通过创建自定义关键字文件调整特定关键词的风险权重来减少误报，或结合扫描模式选择更精确的扫描策略。
Q: 如何提高大型网站的扫描效率？ A: 增加线程数、设置合理的爬取深度，或先使用basic模式进行初步筛选。对于公网网站，建议控制扫描范围。
Q: 为什么有些动态生成的链接没被检测到？
A: 启用无头浏览器模式--headless并适当增加JavaScript执行等待时间--js-wait。
Q: 使用无头浏览器时需要注意什么？ A: 使用无头浏览器会增加资源消耗和时间，建议适当降低线程数，为复杂页面增加等待时间，仅在必要时启用。
YuanZhao/
├── YuanZhao.py # 主程序入口
├── requirements.txt # 依赖列表
├── README.md # 项目说明
├── core/ # 核心模块
│ ├── scanner.py # 扫描引擎
│ ├── detector/ # 各类检测器
│ ├── reporter.py # 报告生成器
│ └── config.py # 配置管理
├── utils/ # 工具类
└── keywords_example.txt # 关键字示例文件
本工具仅供安全测试和应急响应使用，请确保您有足够的授权对目标进行扫描，避免对未经授权的系统进行测试。