---

What it does

Free proxy lists go stale quickly. Proxy Workbench turns candidates into a list measured against your own success criteria:

1. Collect: choose from a catalog of 150 entries; 106 supported feeds are enabled by default for new installations. You can also import your own list. Addresses are normalized and deduplicated.
2. Check: make real requests through each candidate to one or more target URLs. Set accepted HTTP status codes, body text or hash, retry threshold, timeouts, and optional reputation or anonymity checks.
3. Use: filter and export the results, connect to the local rotating gateway at 127.0.0.1:8899, or read the latest published list from the API. Pools and schedules can refresh it.

The interface and its local API bind to loopback by default. The headless service can be exposed deliberately with a separate API token.

📸 Screenshots

Scan — configure targets and follow progress	Results — review, filter, rank, and export
Details — inspect individual attempts and errors	Light theme — switch from the header
Sources — bundled catalog and your own lists	Rotating Gateway — connection setup and route controls; offline until started
Pools & Schedules — desired size, reserve, and refresh rules	API Keys — permissions and limits; no secrets shown

_{Proxy results, metrics, and locations shown here are synthetic; IPs use RFC 5737 documentation ranges. The Sources catalog is the bundled catalog. No working public proxy is implied.}

🧭 The eight tabs

Tab	What you do there
Scan	Choose target sites and success rules, use a preset or tune the check, start and resume a scan, and follow live progress.
Results	Inspect fresh, expired, failed, and unknown results; filter and sort proxies; review individual attempts; build TXT, CSV, JSON, PAC, Clash, and sing-box exports.
Rotating Gateway	See gateway health and pool size, copy its local HTTP/SOCKS5 endpoint, and get client setup examples.
Mobile & Clients	Copy or download sing-box and Clash/Mihomo configs. Set up Telegram through a link, or a QR code after enabling authenticated LAN mode.
Sources	Select supported public feeds, import your own lists, inspect source yield and errors, and manage the optional country database.
Pools & Schedules	Keep a target number of passing proxies for a list and profile; set refresh intervals, quiet hours, and budgets.
API Keys	Issue and manage scoped keys for the authenticated /v1 control API. Secrets are shown once.
How it works	Follow the workflow, read setup guidance, investigate empty results, and access diagnostics and maintenance tools.

The interface has dark and light themes and 12 languages. HTTP(S), SOCKS4, SOCKS5 and IPv6 are supported. Checks can use several target URLs, repeated attempts, status/body/hash conditions, a local denylist, optional DNSBL zones, and an optional anonymity judge. The full options are documented in the CLI, gateway, and API sections below.

🚀 Quick start

Choose the build for your system. The latest release has installers, portable archives, checksums, and a Python wheel.