TERMINAL / QUICKSTART

Make your first proxy request with cURL.

Check a connection from your terminal before adding it to an application.

Prerequisites

Use a current version of cURL and a POSIX shell such as Bash or zsh. These commands are not PowerShell syntax.

Configuration guide. Purchasing and live connections are not open. Examples require actually provisioned credentials and do not create resources.

Confirm cURL is installed with curl --version. Set the four proxy environment variables in your shell without committing them to scripts or repositories.

curl --version

Environment variables

Keep these values in your server process environment. Do not put proxy passwords or keys in browser code, public repositories or screenshots.

PROXY_HOST: Assigned proxy hostname, without a protocol prefix
PROXY_PORT: The port assigned for the chosen protocol
PROXY_USERNAME: Proxy username, separate from your website email
PROXY_PASSWORD: Proxy password, separate from the account password or API key

Make a request

The example uses an HTTP proxy to reach an HTTPS target. A SOCKS5 endpoint requires a compatible client and its assigned port; an HTTP proxy URL is not interchangeable with SOCKS5.

curl --proxy "http://${PROXY_HOST}:${PROXY_PORT}" \
  --proxy-user "${PROXY_USERNAME}:${PROXY_PASSWORD}" \
  --max-time 30 --fail --silent --show-error \
  "https://httpbin.org/ip"

Check the result

Run the example once. The response should contain the exit IP observed by the test service. Compare it with your assigned resource or the expected region; a rotating plan may use a different exit on later requests.

Troubleshooting

Connection troubleshooting
Symptom	What to check
407	Check the proxy username, password and resource status. Avoid repeated automatic retries.
Timeout / connection error	Check host, port, firewall and protocol. Diagnose with a single request first.
403 / 429	Distinguish target responses from proxy authentication. Respect access rules, lower the rate and stop disallowed requests.
Unexpected exit	Check whether the plan rotates, the session has expired or the region parameter is supported by the resource.

Choose a product for your task