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 配置文件，端口（或链路）可通过它进行路由。 |
| 预设 | 已保存的端口配置，可稍后重新应用，并整理到文件夹中。 |
| 域名路由规则 | 将特定域名通过不同上游代理路由，或对其应用不同设置的规则。 |
| 端口池 | 从代理列表打开的一批端口，用于大规模并发工作——非常适合采集器、解析器、发布器及类似的自动化系统。 |
快速上手
- 安装 BlankTrail Proxy，并允许它安装其根证书（参见“安装”）。
- 在 http://127.0.0.1:8891 打开控制面板并激活您的许可证。
- 点击“+ 打开端口”，选择一个快速上手预设（浏览器或 HTTP 客户端），然后打开一个端口。
- 将您的工具指向该端口——例如 socks5://127.0.0.1:20134。
- 发送一个请求，确认您的流量以预期的身份发出。
说明控制面板在本地 http://127.0.0.1:8891 运行。端口可配置，但标准安装的默认端口为 8891。
接下来阅读
- 安装——在 Windows 或 Linux 上安装并激活您的许可证。
- 控制面板——图文并茂地逐一介绍每个标签页和对话框。
- 连接您的应用——常用工具的代理设置和代码示例。
- API 参考——通过 HTTP 自动化管理端口、配置文件及其他一切。