Proxy Configuration Generator for Five Clients

Python 3 with the Requests package. Save the example as proxy_request.py.

# Python 3 with Requests: python -m pip install requests
# Save as proxy_request.py; run: python proxy_request.py
import sys
import requests

target_url = "https://example.com/"
proxy_url = "http://proxy.example:3128"

try:
    with requests.Session() as session:
        session.trust_env = False
        with session.get(
            target_url,
            proxies={"http": proxy_url, "https": proxy_url},
            timeout=(10, 30),
            allow_redirects=False,
            stream=True,
        ) as response:
            print("HTTP status:", response.status_code)
            response.raise_for_status()
except requests.RequestException as error:
    print("Request failed:", type(error).__name__, file=sys.stderr)
    sys.exit(1)

Continue with the Python Requests proxy guide.

Run in a POSIX shell such as sh, bash or zsh with cURL and sed available. This shell syntax is not for PowerShell.

# POSIX shell (sh/bash/zsh) with cURL; not PowerShell syntax.
# Save as proxy_request.sh; run: sh proxy_request.sh
curl --disable \
  --proxy 'http://proxy.example:3128' \
  --noproxy '' --globoff --proto '=https' \
  --connect-timeout 10 --max-time 30 \
  --silent --show-error --fail \
  --output /dev/null --write-out 'HTTP status: %{http_code}\n' \
  --url 'https://example.com/'

Continue with the cURL proxy guide.

Use Node.js 20 or newer with undici@6. Save the example with the .mjs extension.

// Node.js 20+ with Undici 6: npm install undici@6
// Save as proxy_request.mjs; run: node proxy_request.mjs
import { ProxyAgent, fetch } from 'undici';

const targetUrl = "https://example.com/";
const dispatcher = new ProxyAgent("http://proxy.example:3128");
try {
  const response = await fetch(targetUrl, {
    dispatcher,
    redirect: "manual",
    signal: AbortSignal.timeout(30000),
  });
  console.log("HTTP status:", response.status);
  if (response.body) await response.body.cancel();
  if (response.status >= 400) process.exitCode = 1;
} catch (error) {
  console.error("Request failed:", error.name);
  process.exitCode = 1;
} finally {
  await dispatcher.close();
}

Continue with the Node.js Fetch and Undici guide.

PHP CLI with the cURL extension. Save as proxy_request.php.

<?php
// PHP CLI with the cURL extension; save as proxy_request.php.
// Run: php proxy_request.php
$target = 'https://example.com/';
$proxy = 'http://proxy.example:3128';
$handle = curl_init($target);
$options = array(
    CURLOPT_PROXY => $proxy,
    CURLOPT_PROXYTYPE => CURLPROXY_HTTP,
    CURLOPT_NOPROXY => '',
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_PROTOCOLS => CURLPROTO_HTTPS,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_FAILONERROR => true,
    CURLOPT_WRITEFUNCTION => function ($handle, $data) { return strlen($data); },
);
curl_setopt_array($handle, $options);
$result = curl_exec($handle);
$errno = curl_errno($handle);
$status = (int) curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);
echo "HTTP status: " . $status . "\n";
if ($result === false) {
    fwrite(STDERR, "Request failed; cURL error code: " . $errno . "\n");
    exit(1);
}

Continue with the PHP cURL proxy guide.

PowerShell 7 using .NET HttpClient and an explicit WebProxy. Save as proxy_request.ps1.

# PowerShell 7; save as proxy_request.ps1.
# Run: pwsh -NoProfile -File ./proxy_request.ps1
$ErrorActionPreference = 'Stop'
$target = 'https://example.com/'
$proxy = [System.Net.WebProxy]::new('http://proxy.example:3128')
$proxy.BypassProxyOnLocal = $false
$proxy.BypassList = @()
$handler = [System.Net.Http.HttpClientHandler]::new()
$handler.Proxy = $proxy
$handler.UseProxy = $true
$handler.UseDefaultCredentials = $false
$handler.AllowAutoRedirect = $false
$client = [System.Net.Http.HttpClient]::new($handler)
$client.Timeout = [TimeSpan]::FromSeconds(30)
$response = $null
try {
    $response = $client.GetAsync($target, [System.Net.Http.HttpCompletionOption]::ResponseHeadersRead).GetAwaiter().GetResult()
    $status = [int] $response.StatusCode
    Write-Output ('HTTP status: ' + $status)
    if ($status -ge 400) { exit 1 }
} catch {
    [Console]::Error.WriteLine('Request failed: ' + $_.Exception.GetType().Name)
    exit 1
} finally {
    if ($null -ne $response) { $response.Dispose() }
    $client.Dispose()
}

Continue with the PowerShell proxy guide.