Sesiones

Por defecto, cada solicitud rota a una nueva IP. Cuando necesites la misma IP en varias solicitudes, abre una sesión persistente (sticky session).

Modos

Rotación por solicitud

Envía solicitudes sin el flag sid. Cada solicitud utiliza una IP diferente.

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 98.207.12.9

Sesión persistente

Añade sid-<id> al nombre de usuario. El id es cualquier cadena que elijas; las solicitudes posteriores con el mismo id devuelven la misma IP hasta que expire el TTL o la IP se caiga en origen. ttl-<seconds> es opcional y solo es válido junto con sid; sobrescribe la duración predeterminada (120 segundos, mínimo 1). El generador de endpoints del panel también usa 120 por defecto.

customer-USERNAME-country-us-sid-order42             # default 120s lifetime
customer-USERNAME-country-us-sid-order42-ttl-600     # custom 10-minute lifetime

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44  (same)

Elegir un id de sesión

• Elige algo único por flujo de trabajo (order-42, user-a7f3, checkout-2024-11-21-1).
• Dos ejecuciones independientes que compartan el mismo id al mismo tiempo colisionarán en una sola IP persistente.
• El id es arbitrario; Shifter no lo interpreta. Se utiliza como clave de caché.

Cuándo expira la sesión

• Tras ttl segundos, la asignación se elimina y la siguiente solicitud rota a una nueva IP (se conservan los flags de segmentación).
• Si la IP residencial subyacente se desconecta antes, la sesión termina antes de tiempo y la siguiente solicitud rota.

Combinación con la segmentación geográfica

Las sesiones persistentes respetan tus otros flags. Un id de sesión fija una IP dentro de tu filtro:

customer-USERNAME-country-us-city-los_angeles-sid-scrape1            # default 120s
customer-USERNAME-country-us-city-los_angeles-sid-scrape1-ttl-300    # custom 5-min

Todas las solicitudes con el mismo id permanecen en una IP de Los Ángeles durante la duración del TTL.

Precaución

No reutilices un id de sesión entre flujos de trabajo concurrentes. Las solicitudes de distintos scripts recaerán en la misma IP, lo cual se interpreta como comportamiento sospechoso para la mayoría de los sistemas anti-bot.

Sesiones entre máquinas y regiones

Las sesiones persistentes se guardan por región. p.shifter.io conecta cada máquina con su región más cercana, así que el mismo sid usado desde dos máquinas que llegan a regiones distintas obtiene dos IP diferentes. Esto afecta a:

• Un scraper y un solucionador de captchas que usan la misma sesión (el solucionador se conecta desde sus propios servidores).
• Varios servidores, contenedores o funciones en la nube que comparten una sesión.
• Un navegador y un cliente de API independiente que deben parecer el mismo visitante.

Para mantener una sola IP en todas partes, apunta todas las herramientas que compartan la sesión al mismo punto de entrada regional, por ejemplo fra.p.shifter.io:

customer-USERNAME-country-us-sid-order42-ttl-600:PASSWORD@fra.p.shifter.io:443

Una sola máquina que siempre se conecta a través de p.shifter.io normalmente no se ve afectada.

Siguiente paso

• Segmentación geográfica, reduce el conjunto de IPs antes de fijar una.
• Integraciones, ids de sesión en Scrapy, Puppeteer, Playwright.