Comece aqui · Segmentação e sessões

Como definir o IP de saída por parâmetros no nome de usuário.

País, estado dos EUA, cidade, provedor, identidade da sessão e tempo de vida. Seis parâmetros, em qualquer ordem, em ambos os gateways compartilhados.

4 minutos de leitura 6 seções Atualizado 21 de setembro de 2026

Sintaxe#

Comece com seu nome de usuário e anexe -key-value pares. Chaves e valores estão em letras minúsculas; a ordem não importa; a senha permanece inalterada. Sem nenhum parâmetro, a saída é escolhida em qualquer país e muda a cada conexão.

Anatomia

USER-cc-us-state-tx-city-austin-sid-a1b2c3-ttl-30m:PASS
│    │     │        │           │          │
│    │     │        │           │          └─ hold it for 30 minutes
│    │     │        │           └─ session id: same id, same IP
│    │     │        └─ city (letters and digits only)
│    │     └─ US state (United States only)
│    └─ country, ISO 3166-1 alpha-2
└─ your username

Parâmetros#

Parâmetro	Valores	Significado
-cc-	Código do país com duas letras: `us`, `de`, `br`, `jp`	Saia desse país. 199 países em residencial; o pool móvel cobre os países listados na finalização da compra.
-estado-	Código do estado dos EUA: `tx`, `ca`, `ny`	Saia desse estado. Requer `-cc-us`; não disponível para outros países.
-cidade-	Nome da cidade, somente letras minúsculas e dígitos: `newyork`, `berlin`, `saopaulo`	Saia dessa cidade. Requer `-cc-`. Cada página do país lista suas cidades disponíveis com o valor exato.
-asn-	Número do sistema autônomo sem o `AS` prefixo: `7922`, `3320`	Saída anunciada por esse provedor. Combine com `-cc-`. No pool móvel é assim que você escolhe uma operadora.
-sid-	Letras e dígitos, até 32 caracteres: `a1b2c3`, `job42`	Sessão persistente. Solicitações que carregam o mesmo ID compartilham uma saída até que o tempo de vida termine ou o dispositivo fique offline. Um novo ID significa um novo IP.
-ttl-	Minutos ou horas, de `1m` para `24h`: `10m`, `2h`	Vida útil de uma sessão fixa, contada a partir da primeira solicitação. Padrão `10m` quando `-sid-` está presente sem `-ttl-`.

Rotação e sessões#

Sem -sid- o gateway escolhe uma nova saída para cada nova conexão ele recebe. Clientes que mantêm uma conexão ativa ou que enviam muitas solicitações através de um CONNECT túnel, mantenha a mesma saída enquanto a conexão durar. Para alternar em cada solicitação, desative o keep-alive ou feche a conexão após cada chamada; para manter um IP entre conexões, use um ID de sessão.

Igual -sid- valor, mesmo IP, em qualquer número de conexões paralelas. Execute quantas sessões forem necessárias ao mesmo tempo; não há limite.
Quando o tempo de vida expira ou a família se desconecta, a próxima solicitação com esse ID recebe um novo IP que ainda corresponde aos outros parâmetros. Projete para isso: uma mudança de IP no meio do fluxo é possível em qualquer rede residencial.
Para forçar uma alteração imediatamente, altere o id. Os IDs têm como escopo sua conta e não custam nada.
Existem sessões fixas nos pools residenciais e móveis. ISP dedicado, datacenter e proxies de dispositivos móveis são um IP fixo e ignoram -sid- e -ttl-.

Exemplos#

Você quer	Nome de usuário
Um novo IP em qualquer país em cada conexão	USER
Um novo IP dos Estados Unidos em cada conexão	USER-cc-us
Uma família no Texas	USER-cc-us-state-tx
Qualquer IP em Berlim	USER-cc-de-cidade-berlin
Um IP de Berlim retido por dez minutos	USER-cc-de-city-berlin-sid-7f3a9
Um IP japonês retido por duas horas	USER-cc-jp-sid-tokyo1-ttl-2h
Um assinante da Comcast (AS7922)	USUÁRIO-cc-us-asn-7922
Clientes móveis da Deutsche Telekom, realizada 15 minutos	USUÁRIO-cc-de-asn-3320-sid-m1-ttl-15m
Vinte sessões brasileiras paralelas	USUÁRIO-cc-br-sid-w01… USUÁRIO-cc-br-sid-w20

Nomes de cidades#

Um valor de cidade é o nome da cidade em ASCII minúsculo com espaços, hifens, apóstrofos e acentos removidos: New York torna-se newyork, São Paulo torna-se saopaulo, Düsseldorf torna-se dusseldorf, Frankfurt am Main está listado como frankfurt. Use o valor impresso na página do país em vez de adivinhar; essa é a string exata que o gateway corresponde.

O que acontece quando um parâmetro não pode ser respeitado#

Caso	Resposta	O que fazer
Chave desconhecida ou valor malformado (`-country-us`, `-ttl-90x`)	`400 Bad Request`	Corrija a corda; o corpo da resposta nomeia o parâmetro.
`-city-` ou `-state-` sem `-cc-`, ou `-state-` fora dos EUA	`400 Bad Request`	Adicionar `-cc-us` ou elimine o parâmetro.
Nenhuma saída atualmente online para a combinação (uma cidade pequena mais um ASN, por exemplo)	`502 Bad Gateway`	Tente novamente e amplie: drop `-asn-`, então `-city-`.
Parâmetros enviados para um endereço dedicado	Ignorado	Nada; o IP é fixo.

Proxies

Menu