ipvolt / field notesDeveloper library

Build a betterconnection.

Practical proxy knowledge, from the first request to the details that matter. Clear examples. Useful distinctions. Fewer assumptions.

Start with your stack
Connection notes01—03
  1. Your client

    cURL · Python · Node.js · Playwright

    Protocol & authentication

  2. Proxy gateway

    Connection · Credentials · Session

    Request & response

  3. Destination

    The service you’re connecting to

A general proxy flow. These guides are independent of any ipvolt service availability.

Read as Markdown

Integration

Connect your stack.

Explicit configuration, bounded requests and a clear way to verify the connection.

Use a proxy with curl

Test an HTTP proxy with curl, separate proxy authentication from destination authentication, and read connection failures without exposing credentials.

Configure Python Requests

Make a Python Requests proxy configuration explicit, encode credentials correctly, and distinguish connect and read timeouts from a total job deadline.

Use a proxy with Node.js fetch

Route Node.js native fetch through an Undici ProxyAgent with explicit authentication, an abort deadline and response cleanup.

Configure a proxy in Playwright

Set an authenticated HTTP proxy for a Playwright browser context, keep test state isolated, and diagnose navigation separately from subresources.

HTTPX async proxies

Configure an HTTPX async proxy client, close streamed responses correctly, and reproduce a PoolTimeout locally before changing your proxy settings.

Concept

Understand the tradeoffs.

Choose a protocol, session model or network type with the right questions in mind.

HTTP vs SOCKS5 proxies

Compare HTTP CONNECT and SOCKS5, understand DNS placement and TLS boundaries, and select a protocol your actual client and provider support.

Rotating vs sticky proxies

Choose rotation around the smallest complete workflow, distinguish exit affinity from cookies, and test what happens when a sticky session ends early.

Mobile vs residential proxies

Compare carrier and household exit networks for QA, keep browser emulation separate, and measure the capabilities your workflow actually needs.

Troubleshooting

Find the failure.

Separate authentication, connectivity and destination errors before changing your setup.

Fix proxy error 407

Diagnose Proxy Authentication Required in a repeatable order: gateway, authentication method, credential encoding, account scope and client configuration.

Proxy environment variables

Diagnose HTTP_PROXY, HTTPS_PROXY, ALL_PROXY and NO_PROXY routing differences in curl, Python Requests and Node.js with an isolated local check.

Diagnose proxy timeouts

Separate proxy DNS, TCP, CONNECT, TLS and response delays with curl timings, then set request deadlines and decide whether a retry is safe.

Country

Check the location.

Browse the country collection

Understand local networks, verify exit locations and ask better questions before choosing a provider.

Netherlands proxies

Evaluate Netherlands proxies with Dutch network context, exit-IP and city checks, ASN evidence, and a practical trial checklist before choosing a provider.

USA proxies

Evaluate USA proxies by country, state and city. Compare network evidence, plan regional checks and measure session behavior before choosing a provider.

UK proxies

Evaluate UK proxies with current carrier context, UK and GB geography, postcode limitations and a practical test plan for country or network requirements.

Germany proxies

Evaluate Germany proxies with current carrier and roaming context, city-location limits, browser-language controls and a practical acceptance checklist.

France proxies

Evaluate France proxies with carrier and brand distinctions, mainland and overseas scope, exit-IP evidence, and a practical localization test matrix.