How omzsk/proxy-farm works
Proxy Farm turns VPN accounts or configuration files into independently managed, local SOCKS5/HTTP proxy ports. The main workflow is provider/location resolution in the manager, account binding and per-port Docker tunnel startup, then proxy health and status management through the web UI or CLI. The README also documents HMA certificate and activation onboarding, file imports, rotations, and proxy checks. Node driver internals and UI request wiring were not sampled, so those relationships are shown only where the README or excerpts support them.
Main entry points: farm.py Farm manager · entrypoint.sh Tunnel node · vendors.py Provider registry · hma_activation.py HMA activation check
Components 24
Provider onboarding
- HMA certificate import
manager/farm.py - HMA activation check
manager/hma_activation.py - Provider registry
manager/vendors.py - Server locations
manager/vendors.py
Farm management
- Farm manager
manager/farm.py - Account pools
manager/farm.py - Port lifecycle
manager/farm.py - Retry and watchdog
manager/farm.py - IP rotation
manager/farm.py - Farm state
manager/farm.py - Proxy diagnostics
manager/farm.py
Tunnel and proxy runtime
- Tunnel node
node/entrypoint.sh - WireGuard driver
node/drivers/wireguard.sh - IKEv2 EAP driver
node/drivers/ikev2-eap.sh - IKEv2 certificate driver
node/drivers/ikev2-cert.sh - OpenVPN driver
node/drivers/openvpn.sh - SOCKS5 and HTTP
node/entrypoint.sh
Other components
- Local user
- VPN config files
- VPN providers
- Avast licensing
- Proxy clients
Connections 26
- Local user → Web UI: manages farm
README.md - Local user → CLI: runs commands
manager/farm.py - VPN config files → Farm manager: imports configs
README.md - Local user → HMA certificate import: syncs certificate
README.md - Local user → HMA activation check: submits code
README.md - HMA activation check → Avast licensing: validates license
manager/hma_activation.py - Local user → Provider registry: adds account
README.md - Provider registry → VPN providers: fetches server list
- Provider registry → Server locations: resolves locations
manager/vendors.py - Farm manager → Provider registry: resolves targets
manager/farm.py - Farm manager → Account pools: binds accounts
manager/farm.py - Farm manager → Port lifecycle: starts and stops
manager/farm.py - Farm manager → Farm state: reads and writes
manager/farm.py - Farm manager → Tunnel node: runs containers
manager/farm.py - Retry and watchdog → Farm manager: retries ports
manager/farm.py - IP rotation → Farm manager: restarts ports
manager/farm.py - Tunnel node → WireGuard driver: selects driver
- Tunnel node → IKEv2 EAP driver: selects driver
- Tunnel node → IKEv2 certificate driver: selects driver
- Tunnel node → OpenVPN driver: selects driver
- Tunnel node → SOCKS5 and HTTP: runs proxy
- Proxy clients → SOCKS5 and HTTP: uses local proxy
README.md - Local user → Proxy diagnostics: tests proxy
README.md - Proxy diagnostics → Tunnel node: executes probe
manager/farm.py - Web UI → Farm manager: manages ports
- CLI → Farm manager: runs operations
manager/farm.py