Simple proxy format conversion tool
Import common proxy links and turn them into ready-to-use local SOCKS5/HTTP endpoints.
ProxyHub focuses on everyday proxy link handling: import, preview, convert, probe, and expose stable local SOCKS5/HTTP ports. It can run multiple local HTTP/SOCKS proxies at the same time. Built on sing-box.
| Feature | Why it matters |
|---|---|
| Format conversion | Import common proxy links (VLESS, VMess, Trojan, Shadowsocks, Hysteria/Hysteria2, TUIC, SSH, SOCKS5, HTTP) and output local proxy endpoints. |
| Smart routing | Prefer low latency, fail over, balance, or switch manually. |
| Health guard | Probe latency and automatically exclude broken routes. |
| Chain nodes | Chain multiple nodes into one ordered proxy path, with traffic forwarded through each node. |
| Bulk import | Paste links or subscriptions, preview, then import. |
| Backup | Move the proxy setup with one JSON file. |
npm install -g pxhub
pxhubThe proxy-hub command is also installed as a compatibility alias.
Then open:
http://127.0.0.1:3020
Use the same command to update to the latest stable release:
npm install -g pxhub@latestdocker run -d --name proxyhub -p 3020:3020 -v proxyhub-data:/app/data ghcr.io/fy0/proxy-hub:latestThen open:
http://127.0.0.1:3020
Download the latest archive from GitHub Releases, extract it, then run proxy-hub or proxy-hub.exe.
ProxyHub reads runtime settings from the active data directory:
- npm global install:
~/.proxy-hub/config.yaml - source/local binary direct run:
./data/config.yaml
Common keys:
| Key | Purpose |
|---|---|
serveAt |
Service listen address, default :3020. |
dbUrl |
Database DSN, default data.db under the active data directory. |
logLevel |
Service log level. |
Only SQLite DSNs are supported.
This project was developed for learning purposes and is only used by the author for mutual access between two machines in the living room and bedroom at home. It is open sourced to comply with GPL requirements. Users are responsible for any consequences of their own use.
- sing-box: provides the core functionality.
- easy_proxies: inspired the node blocklist and other implementation ideas.
- Linux.do community: provides an open source exchange platform.
ProxyHub is distributed under GPL-3.0-or-later because the released application links against SagerNet sing/sing-box.