Skip to content

Latest commit

Β 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—‚ proxy-pool-collection

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.

Proxy Pool Collection β€” Windscribe tab: one card per client with rotate, quota and node health; identifiers masked.

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.

✨ Highlights

  • πŸ–₯ 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_HTML exists
  • πŸ” VPNGate is a first-party pool, not scraped wrappers β€” mihomo mixed listeners, 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, Host check, no server-side 3xx follow, same-origin Location rewritten under the prefix, loopback by default
  • 🧾 No credentials in the repo β€” every live value lives in *.example files and a gitignored runtime set; the brand claim is service architecture only
  • ⚑ Two ways to run β€” python3 webui/server.py for the bare-metal deployment (no database, no extra deps), or docker compose up for a one-command demo; the Compose stack adds no runtime dependency to the bare-metal path

πŸ€” Why wrap pools this way?

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.

🧠 How it works

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
Loading

Two layers, both self-contained:

  1. 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).
  2. 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.

🦊 FoxyVPN / πŸŒ€ URnetwork / πŸ‹ Windscribe / 🌐 VPNGate / πŸ›°οΈ Rayobyte

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.

πŸš€ Install

Bare metal

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.py

Open 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.

One-command demo (Docker Compose)

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 up

Open 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.service

shared-mihomo/mihomo/ovpn-template.example.json is the placeholder for the ovpn-template.json the generator loads at runtime.

πŸ–₯️ Web UI

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.

βš™οΈ HTTP API (the 4th pool's external contract)

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 port

All responses are JSON; no auth (trust boundary = the network, like the pools). See shared-mihomo/api/register.service.example for the systemd unit.

πŸ›‘ Security & trust model

  • 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.1 only (127.0.0.1:8787:8787). A bare 8787:8787 would bind all host interfaces and expose this unauthenticated proxy to any network peer. host_allowlist is a forgeable Host-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, Host is replaced with the upstream host, upstream 3xx is never followed server-side, and same-origin Location is 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.py enforces this for first-party files.
  • Vendored upstream subtrees are byte-identical to their pinned commits.

🧩 Layout

.
β”œβ”€β”€ 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/

πŸ§ͺ Tests

python3 -m unittest discover -s tests -v

Playwright browser smoke (desktop + mobile, five tabs, zero JS errors):

python3 -m unittest tests.test_integration_smoke -v

Skill 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.

πŸ™ Credits

  • 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.

Releases

Packages

Contributors

Languages