Skip to content
Proxer Proxer v0.5.0

proxer http

Expose a local HTTP service through a tunnel.

proxer http <port> connects a client-initiated tunnel to a public Proxer server and forwards requests to a local HTTP port.


proxer http 3000 --server ws://your-server.example.com:8080 --subdomain demo --token dev-token

  • <port> — local HTTP port to forward to. This positional argument has no environment variable.
  • --server <url> — public Proxer server URL. Proxer always connects to /__proxer__/control internally.
  • --subdomain <name> — register a subdomain route. Omit it to register the root domain route.
  • --token <token> — shared token matching the server.

  • PROXER_SERVER — default value for --server
  • PROXER_SUBDOMAIN — default value for --subdomain
  • PROXER_TOKEN — default value for --token

CLI flags take precedence over environment variables.


Omit --subdomain:

proxer http 3000 --server ws://proxy.example.com:8080 --token dev-token

Requests for proxy.example.com are sent to the local service.


Pass --subdomain:

proxer http 3000 --server ws://proxy.example.com:8080 --subdomain demo --token dev-token

Requests for demo.proxy.example.com are sent to the local service.


If an established control connection drops, the client retries and registers again when the server is reachable. If the initial connection fails before the client is registered, the command may exit.