Five self-hosted proxy pools, one URL. proxy-pool-collection wraps
five existing, separate services β foxyvpn-pool, urn-pool,
windscribe-pool, a first-party shared-mihomo VPNGate pool, and a
Rayobyte quota pool β behind a single stdlib reverse proxy and one web
page: a left sidebar switches pools with no page reload, and each pool keeps
its own dashboard (unchanged UI) inside the same tab.
Live deployment screenshot, identifiers masked (host, tailnet IP, port, node addresses, client uids and the unauthenticated dashboard alias). OCR-verified: zero hits for any sensitive regex.
Design borrowed from the upstream pools β same left-sidebar UI_HTML card
pattern, same const BASE = location.pathname relative-URL mounting trick β
extended with a first-party reverse proxy and a first-party VPNGate dashboard.
Unofficial community software. Not affiliated with or endorsed by Mozilla, URnetwork, Windscribe, or VPNGate. Only use it with accounts and subscriptions you are authorized to use, in accordance with each provider's terms of service.
- π₯ One page, five pools β FoxyVPN, URnetwork, Windscribe, VPNGate and
Rayobyte behind a single URL with a left sidebar; each tab is its own
dashboard, byte-identical upstream where a
UI_HTMLexists - π VPNGate is a first-party pool, not scraped wrappers β mihomo
mixedlisteners,register.py(/register/rotate/node/status), a provider generator filtering the official VPNGate node lists, an official-only hub and a public-source speed daemon - π The VPNGate tab matches the others β card-per-client, port + current node, alive badge, and one Rotate button; no quota row, because VPNGate has no per-account quota
- π‘ Hardened unified view β fixed upstreams (no
urljoin, no open relay), SSRF-traversal rejection, header allowlist,Hostcheck, no server-side 3xx follow, same-originLocationrewritten under the prefix, loopback by default - π§Ύ No credentials in the repo β every live value lives in
*.examplefiles and a gitignored runtime set; the brand claim is service architecture only - β‘ Two ways to run β
python3 webui/server.pyfor the bare-metal deployment (no database, no extra deps), ordocker compose upfor a one-command demo; the Compose stack adds no runtime dependency to the bare-metal path
Five pools solve five different problems; the three vendored upstreams each already ship a good dashboard. What's missing is the **one-URL switchboard** and a reproducible, credential-free repository describing them all.
| Concern | Separate dashboards | Proxy Pool Collection |
|---|---|---|
| One status page | Visit 3β5 URLs, remember 5 tokens | One page, one URL, five sidebar tabs |
| Fresh clone reproduces | Five separate services, differing deploy docs | One clone, all five pools versioned together |
| VPNGate dashboard | None upstream (first-party only) | Card dashboard with Rotate, matches the family |
| Credentials in repo | Each pool's README says "bring your own" | Every live value externalized; a scanner proves it |
| Upstream updates | Pull four repos, reconcile four layouts | Subtrees pinned to SHAs; update one at a time |
The 3 vendored upstreams ship their own
UI_HTML; this repo mounts them under a path prefix and proxies everything the relative-URL dashboard needs. The VPNGate and Rayobyte dashboards are first-party, in the same house style.
flowchart LR
B[Browser Β· one URL] --> S[webui/server.py Β· stdlib reverse proxy]
S -->|/p/foxy/*| F[foxyvpn-pool Β· byte relay Β· :8080]
S -->|/p/urn/*| U[urn-pool Β· seedphrase pool Β· :8090]
S -->|/p/ws/*| W[windscribe-pool Β· OpenVPN tunnels Β· :8094]
S -->|/p/vg/* static| V[VPNGate ui.html Β· cards + Rotate]
V -->|/p/vg/api/*| R[register.py :8095]
S -->|/p/ray/* static| Y[Rayobyte ui.html Β· read-only cards]
Y -->|/p/ray/api/*| RP[raypool_svc.py :8096]
R --> C[mihomo external-controller :7910]
H[vpngate-hub Β· official sources] --> J[(publish/hub-nodes.json)]
J --> G[gen-provider.py Β· clean filter]
G --> P[providers/hub-nodes.yaml]
P --> C
D[vpngate-speed.py Β· public sources] --> J
Two layers, both self-contained:
- Control planes β each pool is a small stdlib service that turns a shared account/token pool into per-client SOCKS5 exits (byte-relay swap, quota self-management, stable ports).
- Unified view β a reverse proxy serving five tabs; the VPNGate pool exposes no quota concept, so its cards show exit node + a single Rotate button (β urn-pool's "rotate, no picker" UX); the Rayobyte tab is read-only.
| Tab | Source | UI |
|---|---|---|
| π¦ FoxyVPN | pools/foxyvpn-pool/ (subtree, pinned) |
upstream embedded UI_HTML |
| π URnetwork | pools/urn-pool/ (subtree, pinned) |
upstream embedded UI_HTML |
| π Windscribe | pools/windscribe-pool/ (subtree, pinned) |
upstream embedded UI_HTML |
| π VPNGate | shared-mihomo/ (first-party) |
shared-mihomo/webui/ui.html |
| π°οΈ Rayobyte | host ray-pool (external API) |
webui/ray.html (first-party, read-only) |
Three upstream pools are vendored byte-identical as git subtrees pinned to SHAs pinned in each subtree. The rewind point for every upstream update is one subtree; the byte-identical diff is the safety net.
The VPNGate/shared-mihomo half is first-party: HTTP API (register.py), mihomo
config + provider generator, official-only hub (vpngate-hub.py), public-source
speed daemon (vpngate-speed.py), and the Rotate dashboard.
Needs Python 3.11+; no other dependencies.
git clone https://github.com/anton1615/proxy-pool-collection.git
cd proxy-pool-collection
cp webui/config.example.json webui/config.json
# edit webui/config.json: each pool's upstream base URL + tab path + listen/port
python3 -m unittest discover -s tests -v
python3 webui/server.pyOpen the printed URL (default http://127.0.0.1:8787/). The shell always
works: a tab whose upstream is down shows a clean error panel; the other tabs
keep working. Binding a tailnet address is an explicit opt-in in config.json
(listen), and is not automatic β the shell is an unauthenticated reverse
proxy and its trust boundary is the network it binds.
Needs Docker Engine with the Compose plugin. No build step, no config copy:
git clone https://github.com/anton1615/proxy-pool-collection.git
cd proxy-pool-collection
docker compose upOpen http://127.0.0.1:8787/. All five tabs render with mock data β a single
stdlib service stands in for every upstream, so no real pool accounts, VPN
tunnels, or mihomo are involved. docker compose down stops the demo. The
stack runs the same webui/server.py unchanged from the official
python:3.11-slim image, mounting docker/config.example.json via
PPC_CONFIG; edit that file (or repoint PPC_CONFIG) to wire real pools.
This path is demo/dev only. The port is published on 127.0.0.1 because
the shell is unauthenticated; see Security & trust model below.
Still on the bare-metal path, the 4th pool's services each ship a
config.example.env and a systemd unit under
shared-mihomo/{api,mihomo,hub,speed}/:
cp shared-mihomo/api/config.example.env shared-mihomo/api/config.env
# fill in SHARED_MIHOMO_API, SHARED_MIHOMO_REG_STATE, ...
sudo systemctl enable --now shared-mihomo-reg.serviceshared-mihomo/mihomo/ovpn-template.example.json is the placeholder for the
ovpn-template.json the generator loads at runtime.
One page; left sidebar; five tabs. Three tabs show the pool's own dashboard β
no rewrite, no visual translation, because every upstream UI_HTML uses the
same relative-BASE convention; VPNGate and Rayobyte are first-party dashboards
in the same style.
- π¦ FoxyVPN β clients, ports, origins, quota, region switch
- π URnetwork β clients, ports, exits, quota left, relays
- π Windscribe β cards with ports, exit, quota used, node health
- π VPNGate β cards with ports, exit node, alive badge, Rotate button
- π°οΈ Rayobyte β read-only quota cards: accounts, live endpoints, remaining MB, client ports/nodes
The screenshot at the top of this file is a live Windscribe tab.
register.py (stdlib) listens on port 8095 by default and manages the mapping
uid β local port β provider node:
GET /register?uid=<name> # allocate a free port, pin one random alive exit
GET /rotate?uid=<name> # re-roll the same port to a new random exit
GET /node?uid=<name>&name=<node> # pin a specific node
GET /nodes # every node name in the provider
GET /status # current uid β port/node mapping
GET /delete?uid=<name> # release the portAll responses are JSON; no auth (trust boundary = the network, like the pools).
See shared-mihomo/api/register.service.example for the systemd unit.
- The shell is an unauthenticated reverse proxy. Its trust boundary is the network it binds; there is no login, no session, no CSRF token.
- The pools themselves were already unauthenticated on the host.
- The Compose demo publishes its port on
127.0.0.1only (127.0.0.1:8787:8787). A bare8787:8787would bind all host interfaces and expose this unauthenticated proxy to any network peer.host_allowlistis a forgeableHost-header check, not IP access control β the loopback publish is the boundary. Pointing the demo config at real pools is the operator's responsibility, not a trust boundary this project provides. - It is not an open relay: upstream URLs are built by string concatenation
(no
urljoin),../leading//paths are rejected, only an allowlisted header set is forwarded,Hostis replaced with the upstream host, upstream 3xx is never followed server-side, and same-originLocationis rewritten back under/p/<pool>/. - The VPNGate hub consumes only official public VPNGate sources β the official CSV endpoint and the official client data-file endpoint. No third-party credential extracted from a decompiled binary, no GP pipeline, no Cloudflare KV push, no keyed/scraped risk scoring.
- Credentials (CA/cert/key, foxyvpn tokens, urn seedphrases, windscribe accounts)
are never committed;
scripts/sanitize_scan.pyenforces this for first-party files. - Vendored upstream subtrees are byte-identical to their pinned commits.
.
βββ README.md
βββ docker-compose.yml # one-command demo stack
βββ docker/ # demo-only config + single mock upstream
β βββ config.example.json # all five pools -> one mock on :8080
β βββ mock_upstream.py # stdlib HTTP mock
βββ webui/ # the unified shell
β βββ server.py # stdlib reverse proxy (SSRF-safe)
β βββ index.html # left-sidebar tab shell
β βββ windscribe_host.py # serves the Windscribe host snapshot
β βββ config.example.json
βββ pools/
β βββ foxyvpn-pool/ # subtree Β· pinned Β· upstream untouched
β βββ urn-pool/ # subtree Β· pinned Β· upstream untouched
β βββ windscribe-pool/ # subtree Β· pinned Β· upstream untouched
βββ (local only, not tracked)
β βββ windscribe-host-webui/ # deployed Windscribe UI snapshot
βββ shared-mihomo/ # first-party, sanitized
β βββ api/register.py # uidβportβnode, rotate, delete
β βββ mihomo/ # config.yaml.example, gen-provider.py, units
β βββ hub/ # vpngate-hub.py Β· official sources only
β βββ speed/ # vpngate-speed.py Β· public sources only
β βββ webui/ # VPNGate Rotate dashboard (ui.html)
βββ docs/
β βββ images/dashboard-windscribe.png # masked
βββ scripts/sanitize_scan.py
βββ tests/
python3 -m unittest discover -s tests -vPlaywright browser smoke (desktop + mobile, five tabs, zero JS errors):
python3 -m unittest tests.test_integration_smoke -vSkill note: the screenshot at the top of this file was verified by two full-resolution OCR sweeps against every sensitive regex; the masked artifact is what is committed, never the original.
- foxyvpn-pool by anton1615 β MIT Β© anton1615
- urn-pool by anton1615 β MIT Β© anton1615
- windscribe-pool by anton1615 β MIT Β© anton1615
- shared-mihomo, vpngate-hub, vpngate-speed, the unified shell and the VPNGate dashboard β first-party components (MIT)
Internal inventory and implementation plan are kept local and untracked; this repo ships the service architecture only.
