Tor Browser Automation

核心用法

Tor Browser Automation 是一款基于 Playwright 的匿名浏览器自动化工具，通过 Tor SOCKS5 代理实现真正的网络层匿名。核心功能覆盖四大场景：

1. Tor网络导航：自动路由至.onion隐藏服务，支持自定义代理配置
2. 元素交互与数据采集：快照提取、表单填充、点击操作、链接抓取、文本提取
3. 可视化取证：视口/全页截图，支持输出至指定路径
4. Python API 集成：异步编程模型，支持复杂自动化工作流构建

技术架构采用 Playwright + Chromium 的组合，默认强制使用 Tor 浏览器用户代理和 1920x1080 视口，最大限度模拟真实 Tor Browser 指纹。

显著优点

• 真正的网络匿名：流量经 Tor 三层加密中继，源IP隐藏，区别于普通代理的"假匿名"
• 暗网原生支持：开箱即用的.onion解析能力，无需额外配置
• 双模式操作：CLI 快速执行与 Python API 深度集成兼顾
• 安全沙盒设计：默认 headless 运行，减少攻击面；超时机制和连接状态检查提升稳定性
• 合规导向：文档明确标注合法用途边界，内置安全警示

潜在缺点与局限性

• 性能瓶颈：Tor 网络延迟普遍 200ms-2s，大规模爬取效率极低
• 稳定性问题：.onion 站点可用性波动大，频繁出现超时或电路重置
• 反自动化对抗：主流暗网服务普遍部署 CAPTCHA 和浏览器指纹检测，headless 模式易被识别
• 单点故障依赖：要求本地 Tor 服务运行在固定端口，分布式部署复杂
• 法律灰色地带：部分国家/地区对 Tor 使用有严格监管，存在合规风险

适合人群

• 安全研究员与威胁情报分析师（OSINT 暗网监控）
• 合规审计人员（企业暗网数据泄露排查）
• 新闻工作者（匿名信源保护）
• 学术研究者（暗网生态观察）

常规风险

• 出口节点窥探：Tor 流量在出口节点解密，敏感操作仍需端到端加密
• 时序关联攻击：长期会话可能被流量分析关联
• 恶意.onion内容：暗网存在大量非法信息，意外访问可能触发法律审查
• 配置泄露风险：代理配置错误可能导致真实 IP 暴露至目标站点

建议配置

生产环境应配合 VM/Docker 隔离运行，启用 --headed 模式处理复杂验证，设置 60s+ 超时以应对 Tor 网络波动，并定期轮换 Tor 电路。

核心用法

Tor Browser Automation 是一款基于 Playwright 构建的无头浏览器自动化工具，通过 Tor SOCKS5 代理（默认 127.0.0.1:9050）实现匿名网络访问。核心功能包括：导航至任意 URL（包括 .onion 暗网站点）、页面快照获取（支持交互元素筛选）、元素点击与表单填充、全页或视口截图、链接与文本提取等。提供命令行接口（CLI）和 Python API 两种调用方式，支持自定义代理配置、无头模式、超时设置和用户代理等参数。

显著优点

功能设计完整，覆盖浏览器自动化的常见场景。Playwright 底层保障跨浏览器兼容性和稳定性，异步架构提升执行效率。Tor 网络集成使得安全研究人员能够合法访问暗网资源进行威胁情报收集，同时保护用户隐私。代码结构清晰，配置灵活，支持 Docker 部署，便于隔离环境运行。

潜在缺点与局限性

来源可信度存疑是最大的风险点：开发者 "Admin4Giter" 被威胁情报关联到恶意软件/C2 管理工具。Tor 网络的匿名性虽为功能特性，但也可能被滥用于隐蔽通信或访问非法内容。.onion 站点普遍响应缓慢，需调高超时阈值。部分网站对自动化工具存在反爬虫机制，CAPTCHA 拦截问题在无头模式下难以解决。Bash 工具权限申请存在沙箱逃逸风险。

适合的目标群体

主要面向网络安全研究人员、威胁情报分析师、隐私保护倡导者及合规的安全测试团队。适用于需要匿名访问公开暗网资源、研究 .onion 站点可访问性、或在不暴露身份前提下进行网络数据采集的场景。不适合普通办公自动化、常规网页抓取或来源可信度要求极高的生产环境。

使用风险

来源风险：开发者背景存疑，建议完整代码审计后再使用。法律合规：Tor 网络访问需遵守当地法律法规，某些司法管辖区对暗网访问有明确限制。网络安全：具备访问任意 URL 能力，需实施白名单和流量监控防止数据外传。性能风险：Tor 网络延迟高，依赖本地 Tor 服务运行状态。隐私风险：页面截图和文本提取功能可能触及敏感数据，需严格遵守目标站点服务条款。