Skip to Content
Proxy Setup

Proxy Setup

Proxy settings apply to apps/agent.

Use one of these formats.

For PROXY_PROVIDER=thordata, prefer the ThorData API URL instead of static proxy host/user/pass fields.

PROXY_PROVIDER=thordata
PROXY_SCHEME=http
THORDATA_PROXY_API_URL=https://get-ip.thordata.net/api?td-customer=YOUR_CUSTOMER_ID&sesstype=1&number=5&country=US

Runtime behavior:

  • The agent fetches the proxy list from the API URL on each launch.
  • It picks one random returned proxy.
  • It does not lease the same returned proxy to two workers concurrently.

PROXY_URL

PROXY_URL=http://user:pass@proxy.example.com:8080

Supported schemes:

  • http
  • https
  • socks4
  • socks5

Host and port are required.

Split fields

PROXY_SCHEME=http
PROXY_HOST=proxy.example.com
PROXY_PORT=8080
PROXY_USERNAME=user
PROXY_PASSWORD=pass

Notes:

  • PROXY_SCHEME is optional and defaults to http.
  • PROXY_USERNAME and PROXY_PASSWORD must be set together.
  • PROXY_HOST and PROXY_PORT must be set together.
  • Do not set PROXY_URL together with the split PROXY_* fields.

Runtime behavior

  • The agent creates a local forwarder and points Chromium at it.
  • Upstream proxy authentication is handled by the app, not by Chromium directly.
  • Logs redact credentials and only keep scheme, host, and port.

Operational Guidance

  • Keep proxy credentials out of source control.
  • Track provider-specific failure rates.
  • Increase AGENT_WORKER_CONCURRENCY only after proxy stability is verified.
ProvidersSelf Hosting