Easy Proxies

A subscription-first proxy node importer, tester, pool manager, and multi-port gateway powered by sing-box.

Easy Proxies is a community-maintained fork of jasonwong1991/easy_proxies. This fork focuses on a redesigned WebUI, subscription importing, reliable node testing, node lifecycle management, and an easier multi-port workflow.

What it does

Easy Proxies turns one or more proxy subscription URLs into local HTTP/SOCKS5 ports:

Paste subscription URLs
  -> parse nodes
  -> test every node
  -> automatically add passed nodes to the pool
  -> assign local ports starting at 24000
  -> copy and use the generated ports

The default runtime mode is multi-port, so every passed node receives its own local port. Automatically add passed nodes to the pool is enabled by default for first-time use.

✨ Key features

🔗 Subscription-first WebUI workflow.
Imports HTTP/HTTPS subscriptions, URI lists, Base64 content, and Clash/Mihomo YAML.
⚡ Concurrent and asynchronous node testing with live progress.
🧩 Keeps candidate, pooled, and failed nodes instead of silently dropping failures.
Automatically promotes passed imports to the node pool by default.
🔌 One local port per node in the default multi-port mode.
Optional pool and hybrid runtime modes.
Batch retest, country detection, subscription refresh, port inspection, and logs.
Probe target selection between https://www.gstatic.com/generate_204 and https://cp.cloudflare.com/generate_204.
WebUI and REST API served from the same management endpoint.

🖼️ WebUI preview

Show all interface screenshots

Import and create ports

Available ports

Candidate nodes

Failed nodes

Batch tools

Port status

Logs

Settings

Getting started

Follow the English User Guide for two startup methods:

Clone the source, build Easy Proxies locally, and start the binary.
Download the matching binary package from Releases and start it.

Import formats and protocols

Import formats:

HTTP/HTTPS subscription URL
Proxy URI list
Base64-encoded URI list
Clash/Mihomo YAML proxies section

Common protocols include VLESS, VMess, Trojan, Shadowsocks, ShadowsocksR, Hysteria, Hysteria2, TUIC, AnyTLS, HTTP/HTTPS, SOCKS4, and SOCKS5. Actual protocol availability depends on the sing-box version and build tags.

Runtime modes

Mode	Behavior
`multi-port`	Default. Assign one local port to every pooled node.
`pool`	Expose one shared proxy entry and schedule across pooled nodes.
`hybrid`	Enable the shared pool entry and per-node ports together.

multi_port is accepted in configuration files and normalized to multi-port.

Development and contributing

For source setup, build tags, tests, branch conventions, and the pull request workflow, see CONTRIBUTING.md.

Troubleshooting

The user guide covers startup errors, missing ports, browser-saved import options, and macOS Gatekeeper handling. When a passed node does not use the expected port, check the WebUI port page because occupied ports are skipped automatically.

Upstream and acknowledgements

jasonwong1991/easy_proxies — upstream project
SagerNet/sing-box — proxy platform and protocol implementation

🔗 Community

linux.do: Learn AI at L-Site!!!

License

Distributed under the MIT License. This project retains attribution for the upstream project and MIT-licensed portions on which it is based.