ikoldakov/proxium repository overview

⁠Proxium

Your own proxy service in one docker run.

HTTP and SOCKS5 proxy with accounts, quotas, speed limits, outgoing IP pools and a web admin panel. Self-hosted. Open source. No config files.

• Source: github.com/koldakov/proxium⁠
• Docs: proxium.koldakov.com⁠
• License: MIT

⁠Quick start

docker run -d --name proxium -p 80:80 -p 8080:8080 -v proxium:/var/lib/proxium \
  -e SUPERUSER_CREATE=true -e [email protected] -e SUPERUSER_PASSWORD=change-me \
  ikoldakov/proxium

1. Open the admin UI at http://localhost⁠ and log in.
2. Add an account under Proxy accounts → Basic, copy its password: it's shown once.
3. Use it:

curl -x http://username:password@localhost:8080 https://ifconfig.me
curl -x socks5h://username:password@localhost:8080 https://ifconfig.me

One image runs the proxy, the API, the admin UI and PostgreSQL. State lives in the /var/lib/proxium volume.

⁠Tags

Platforms: linux/amd64, linux/arm64. Mirror: ghcr.io/koldakov/proxium.

⁠Features

• HTTP and SOCKS5 on the same port, TLS to the proxy on the same port too
• Basic and bearer token accounts with expiry and revocation, trusted networks without credentials
• Connection limits, speed limits, traffic quotas per day, month or in total
• Policy rules by time of day, target domain, IP and port, protocol, client IP
• Outgoing IP pools and dedicated IPs
• Loopback, private networks and cloud metadata blocked by default
• Web admin UI and REST API, admin groups with per-section permissions
• Changes reach the proxy within seconds, no restart

⁠Ports and volume

Several listening or outgoing IPs need --network host (Linux only).

⁠HTTPS for the admin UI

docker run -d --name proxium -p 80:80 -p 443:443 -p 8080:8080 -v proxium:/var/lib/proxium \
  -e ADMIN_HOST=admin.example.com -e ADMIN_TLS=auto \
  ikoldakov/proxium

ADMIN_TLS: off (default), auto (Let's Encrypt), files (own certificate), internal (self-signed).

⁠Main variables

All of them: Configuration⁠. Installation, compose and own database: Installation⁠.