Skip to main content
Mole presenting SOCKS5

SOCKS5 Proxy

Muti Metroo provides SOCKS5 proxy ingress for client connections.

Configuration​

socks5:
  enabled: true
  address: "127.0.0.1:1080"
  auth:
    enabled: true
    users:
      - username: "user1"
        password_hash: "$2a$10$..."  # bcrypt hash
  max_connections: 1000

Authentication​

Supports two methods:

No Authentication (Method 0x00)​

socks5:
  enabled: true
  address: "127.0.0.1:1080"
  auth:
    enabled: false

Username/Password (Method 0x02)​

socks5:
  enabled: true
  address: "127.0.0.1:1080"
  auth:
    enabled: true
    users:
      - username: "user1"
        password_hash: "$2a$10$N9qo8uLOickgx2ZMRZoMyeIjZAgcfl7p92ldGxad68LJZdL17lhWy"

Generate password hash using the built-in CLI:

muti-metroo hash --cost 12

See CLI - hash for details.

Usage Examples​

cURL​

# No auth
curl -x socks5://localhost:1080 https://example.com

# With auth
curl -x socks5://user1:password@localhost:1080 https://example.com

SSH​

ssh -o ProxyCommand='nc -x localhost:1080 %h %p' user@remote-host

Firefox​

  1. Preferences -> Network Settings -> Manual proxy configuration
  2. SOCKS Host: localhost, Port: 1080
  3. SOCKS v5
  4. Username/password if auth enabled

Metrics​

  • muti_metroo_socks5_connections_active: Active connections
  • muti_metroo_socks5_connections_total: Total connections
  • muti_metroo_socks5_auth_failures_total: Auth failures
  • muti_metroo_socks5_connect_latency_seconds: Connect latency