Proxy Workbench

找到适用于你所使用站点的代理

从公开列表或你自己的文件中收集地址，针对你的服务进行检测，并在应用、导出文件或脚本中使用结果。Proxy Workbench 在本地运行，提供浏览器界面、CLI、轮换代理网关和 API。

Windows · macOS · Linux | HTTP(S) · SOCKS4 · SOCKS5 | 12 种界面语言

English · Русский

下载 · 网站 · 快速开始 · 界面 · CLI · API

_{使用合成示例数据的界面导览。实际代理可用性取决于来源和你的检测。}

功能简介

免费代理列表很快就会失效。Proxy Workbench 将候选代理转化为一份依据你自己的成功标准进行衡量的列表：

收集： 从包含 150 个条目的目录中选择；新安装默认启用 106 个受支持的源。你也可以导入自己的列表。地址会被规范化并去重。
检测： 通过每个候选代理向一个或多个目标 URL 发起真实请求。设置可接受的 HTTP 状态码、正文文本或哈希、重试阈值、超时，以及可选的信誉或匿名性检查。
使用： 筛选并导出结果，连接到位于 127.0.0.1:8899 的本地轮换网关，或从 API 读取最新发布的列表。池和计划可以刷新它。

界面及其本地 API 默认绑定到回环地址。无头服务可以通过单独的 API 令牌有意对外暴露。

📸 截图

_{扫描 — 配置目标并跟踪进度}	_{结果 — 查看、筛选、排名并导出}
_{详情 — 检查单次尝试和错误}	_{浅色主题 — 从页眉切换}
_{源 — 内置目录和你自己的列表}	_{轮换网关 — 连接设置和路由控制；启动前处于离线状态}
_{池与计划 — 期望大小、储备和刷新规则}	_{API 密钥 — 权限和限制；不显示密钥}

_{此处显示的代理结果、指标和位置均为合成数据；IP 使用 RFC 5737 文档范围。源目录为内置目录。不暗示任何可用的公共代理。}

🧭 八个标签页

标签页	你可以在其中做什么
扫描	选择目标站点和成功规则，使用预设或调整检测，启动并恢复扫描，并跟踪实时进度。
结果	检查新鲜、过期、失败和未知结果；筛选和排序代理；查看单次尝试；构建 TXT、CSV、JSON、PAC、Clash 和 sing-box 导出。
轮换网关	查看网关健康状况和池大小，复制其本地 HTTP/SOCKS5 端点，并获取客户端设置示例。
移动端与客户端	复制或下载 sing-box 和 Clash/Mihomo 配置。通过链接设置 Telegram，或在启用经过身份验证的局域网模式后通过二维码设置。
源	选择受支持的公共源，导入你自己的列表，检查源产出和错误，并管理可选的国家/地区数据库。
池与计划	为某个列表和配置文件维持目标数量的通过代理；设置刷新间隔、免打扰时段和预算。
API 密钥	为经过身份验证的 `/v1` 控制 API 签发和管理限定范围的密钥。密钥仅显示一次。
工作原理	了解工作流程，阅读设置指南，排查空结果，并访问诊断和维护工具。

界面提供深色和浅色主题以及 12 种语言。支持 HTTP(S)、SOCKS4、SOCKS5 和 IPv6。检测可以使用多个目标 URL、重复尝试、状态/正文/哈希条件、本地拒绝列表、可选的 DNSBL 区域，以及可选的匿名性判定。完整选项记录在下面的 CLI、网关和 API 章节中。

🚀 快速开始

选择适合你系统的构建版本。最新发布版包含安装程序、便携式压缩包、校验和以及 Python wheel。

系统	安装或运行	要求
macOS，Apple Silicon	下载 `proxy-workbench-3.0.4-macos-arm64.dmg`；将应用拖入 Applications。	无需 Python
macOS，Intel	下载 `proxy-workbench-3.0.4-macos-x86_64.dmg`；将应用拖入 Applications。	无需 Python
Windows x64	运行 `proxy-workbench-3.0.4-windows-x64-setup.exe`；也提供便携式 ZIP 和单独的 CLI `.exe`。	无需 Python
Linux，或任何装有 Python 的操作系统	`pipx install git+https://github.com/DavidVoitenko/proxy-workbench` 然后 `proxy-workbench`	Python 3.11+ 和 pipx
源码检出	Windows 上使用 `Start.bat`，macOS 上使用 `Start.command`，或 Linux 上使用 `./run.sh`。	Python 3.11+
Docker 服务器/NAS	设置 `PROXY_WORKBENCH_API_TOKEN` 并使用 `compose.yml` 运行 `docker compose up -d`。	Docker；无头 CLI/API/网关，无 GUI

不带参数的 proxy-workbench 会启动应用程序：界面会在浏览器中打开，在 macOS 上菜单栏项会显示正在发生的事情，并提供暂停、启动、“登录时启动”和退出。第二次启动它会连接到已在运行的实例，而不是打开一个竞争实例。proxy-workbench run … 和下面的其他命令与 ./run.sh … 的工作方式相同。

proxy-workbench                  # the application: interface + menu bar + one instance
proxy-workbench gui              # the interface alone, no menu bar
proxy-workbench --no-desktop     # the same, spelled the other way
proxy-workbench --print-paths    # which data/cache/log folders this launch would use

已安装的构建版本将数据保存在你自己的每用户文件夹中（%LOCALAPPDATA%\proxy-workbench、~/Library/Application Support/proxy-workbench 或 ~/.local/share/proxy-workbench），绝不会写入其自身的程序文件夹；源码检出会将 data/ 保留在项目旁边；PROXY_WORKBENCH_DATA 会覆盖以上所有设置。便携模式为可选启用：在程序旁边放置一个空的 proxy-workbench-portable.json，它就会将数据保存在自身旁边。

发布安装程序未进行代码签名。macOS Gatekeeper 或 Windows SmartScreen 可能会要求你确认首次运行。如果你想验证下载的文件，请比对公布的 SHA-256 校验和；校验和并不能确立发布者的身份。

在 Scan 中，添加你的目标 URL 和成功规则（状态码，以及在有用时添加预期文本）。代理必须通过每个选定的目标。
按下 Find and check。你可以停止，之后从已保存的进度继续。
在 Results 中，查看尝试记录，选择过滤条件和排序顺序，按下 Build export，然后下载你需要的格式。

关闭浏览器标签页不会停止检查。从菜单栏退出（或在终端启动时按 Ctrl+C）会停止检查。

范围与限制： 免费代理地址可能会在无通知的情况下消失或变更；通过检查仅适用于所测量的目标和时间，而非每个网站或未来的连接。国家/地区查询需要可选的离线数据库，匿名性分类需要判定端点。本地网关通过 HTTP 或 SOCKS5 处理 TCP；它不支持 SOCKS5 UDP ASSOCIATE。Docker 运行时没有浏览器 GUI。

proxy-workbench

最受欢迎