BlankTrail Proxy 文档
BlankTrail Proxy 是一款本地代理,可为您的自动化、采集和测试工具赋予真实的浏览器网络身份。本文档涵盖安装、控制面板、系统托盘以及完整的本地 API。
什么是 BlankTrail Proxy?
BlankTrail Proxy 运行在您自己的机器或服务器上,位于您的工具与互联网之间。将任何支持 HTTP 或 SOCKS5 代理的应用程序指向一个 BlankTrail Proxy 端口,每一个请求都会带着一致、真实的浏览器指纹发出——无需修改您的脚本。
它可与浏览器自动化框架(Playwright、Puppeteer、Selenium)、采集器和解析器、普通 HTTP 客户端以及反检测浏览器配合使用。每个代理端口都拥有自己的身份和自己的上游代理,因此您可以并行运行许多互相独立的工作单元。
- 按端口应用的真实浏览器 TLS 和 HTTP/2 身份。
- 按端口配置的上游代理和多跳链路(SOCKS5、HTTP、OpenVPN、VLESS)。
- 内置控制面板、系统托盘启动器和完整的本地 API。
- 可选的响应缓存,帮助降低按 GB 计费的代理开销。
- DNS / IPv6 防泄漏保护,在端口上线前先检查出口。
核心概念
本文档和整个控制面板中会反复出现以下几个术语:
| 术语 | 含义 |
|---|---|
| 代理端口 | 您将工具指向的本地 TCP 端口(SOCKS5 或 HTTP)。每个端口都可独立配置。 |
| 配置文件 / 身份 | 端口所呈现的浏览器身份——浏览器系列、版本和操作系统。您可以将其随机化、从数据库中选取,或捕获一个真实身份。 |
| 上游代理 | 您的流量在经过 BlankTrail Proxy 之后所通过的外部代理出口。可选——留空即直连。 |
| 链路 / 首跳 | 放置在上游代理之前的可选附加代理或隧道,让您可以组合出多跳路由。 |
| 网关 | 已保存的 OpenVPN 或 VLESS 配置文件,端口(或链路)可通过它进行路由。 |
| 预设 | 已保存的端口配置,可稍后重新应用,并整理到文件夹中。 |
| 域名路由规则 | 将特定域名通过不同上游代理路由,或对其应用不同设置的规则。 |
| 端口池 | 从代理列表打开的一批端口,用于大规模并发工作——非常适合采集器、解析器、发布器及类似的自动化系统。 |
| 术语 | 含义 |
|---|---|
| TLS 解析(MITM) | 端口的常规模式:连接由我们的根证书拆解,因此可以对外发送所选指纹,并对内容进行缓存、记录日志以及交给挑战解题器处理。 |
| TLS 直通 | 端口不拆解连接:对外发送的是客户端自身的指纹。此时指纹伪装、缓存、请求日志与 Challenge Breaker 都不起作用——没有可读取的内容。该复选框位于打开端口对话框中;不慎开启会失去打开该端口的全部意义。 |
| 拦截(TUN) | 当应用无处填写代理时,通过系统把某个程序或整台机器的流量引入端口的方式。它依赖一个独立的特权服务,在 Windows 上可用。 |
| 许可席位(设备) | 许可与设备绑定,且席位数量有限。重装系统或克隆虚拟机会被视为新设备:请在账户中释放席位。 |
快速上手
- 安装 BlankTrail Proxy,并允许它安装其根证书(参见“安装”)。
- 在 http://127.0.0.1:8891 打开控制面板并激活您的许可证。
- 点击“+ 打开端口”,选择一个快速上手预设(浏览器或 HTTP 客户端),然后打开一个端口。
- 将您的工具指向该端口——例如 socks5://127.0.0.1:20134。
- 发送一个请求,确认您的流量以预期的身份发出。
说明控制面板在本地 http://127.0.0.1:8891 运行。端口可配置,但标准安装的默认端口为 8891。