DocumentationProxiesRotation and Sticky Sessions

Rotation and Sticky Sessions

Sticky vs Rotating IPs

Sticky IP: The current IP remains unchanged as long as it does not expire, allowing continuous use. If it expires, a new IP is automatically assigned.

Rotating IP: A new IP is provided with each request, regardless of whether the previous IP has expired.

Session parameters

Rotation behavior is controlled through the r_ and s_ options in the connection string:

  • r_<sessionDuration>: How long a session keeps the same IP, such as 0m, 1m, 5m, 60m. A duration of 0m requests a fresh (rotating) IP on each request, while a non-zero value keeps a sticky IP for that period.
  • s_<sessionId>: The session identifier. Reuse the same session ID to keep the same IP for the configured duration, or use a new session ID for each request to rotate IPs.

Example: -r_5m-s_test-session-123 keeps the same IP for up to 5 minutes for requests sharing the test-session-123 session ID.