Parámetros de proxies de pago por GB
Los parámetros de selección de los proxies PPG son sufijos que se agregan al usuario del proxy. Usa «Configurar y exportar» en el panel para elegir el pool, el hub, el protocolo, la ubicación y la sesión.
Alcance de la conexión#
Una misma credencial PPG funciona con cada hub elegible y con HTTP o SOCKS5. El pool seleccionado determina el enrutamiento y el precio. Un token flexible selecciona su pool con _pool-.... Un token fijo usa su pool guardado y no necesita ese sufijo; un sufijo de otro pool se rechaza.
UDP#
Los pools marcados como UDP transportan UDP a través del endpoint SOCKS5. Los proxies HTTP transportan solo TCP. La API de pools de pago por GB lo indica como udp. UDP puede llegar a cualquier puerto de destino, excepto a unos pocos servicios que suelen usarse de forma abusiva, como SNMP, NetBIOS, SIP, SSDP y memcached.
Gramática del usuario#
Agrega al usuario base del proxy cero o más segmentos delimitados por guion bajo:
<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles_sid-crawl-42_sttl-600
| Parámetro | Sintaxis | Reglas |
|---|---|---|
pool |
_pool-<auth-key> |
Obligatorio en las credenciales exportadas. Clave del pool en minúsculas, tomada del panel; máximo 80 caracteres. |
country |
_country-<slug> |
Slug geográfico en minúsculas, máximo 80 caracteres. uk se normaliza a gb. |
region |
_region-<slug> |
Requiere country cuando se usa como ruta geográfica canónica. |
state |
_state-<slug> |
Alias de compatibilidad para region. No envíes state y region juntos. |
city |
_city-<slug> |
Requiere tanto country como region. |
sid |
_sid-<session-id> |
Letras, números y guiones tras el saneamiento; al menos 3 caracteres. Solo se usan los primeros 15, así que mantén los ID de sesión únicos dentro de sus primeros 15 caracteres. |
sttl |
_sttl-<seconds> |
Se respeta 1–86400. Con 0 o 86401–999999 se usa actualmente 600; siete o más dígitos no son válidos. |
Usa los slugs del panel en minúsculas. La segmentación por ciudad requiere country y region. state es un alias de compatibilidad de region; no indiques ambos. El alias de país uk, en minúsculas, se normaliza a gb en esta gramática del usuario, a diferencia de la API de proxies gratis.
Ejemplos de geografía#
# country
<base-username>_pool-residential-kilo_country-us
# region inside a country
<base-username>_pool-residential-kilo_country-us_region-california
# city inside a region
<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles
Usa las opciones de geografía que el panel muestra para el pool seleccionado. Un slug sintácticamente válido puede seguir sin estar disponible en ese pool.
Ejemplos no válidos o ambiguos:
<base-username>_city-los-angeles
<base-username>_region-california_city-los-angeles
<base-username>_country-us_region-california_state-california
Sesiones fijas#
sid solicita afinidad de sesión. Tras el saneamiento, el ID de sesión contiene letras, números y guiones, y debe tener al menos 3 caracteres. Solo se usan los primeros 15 caracteres, así que mantén los ID de sesión únicos dentro de esos primeros 15 caracteres.
<base-username>_pool-residential-kilo_country-de_sid-cart-17_sttl-900
sttl controla la duración solicitada de la sesión fija, en segundos. Se respetan los valores 1–86400. Por compatibilidad, el comportamiento actual asigna 600 segundos a 0 y a los valores 86401–999999; los valores de siete o más dígitos no son válidos. Prefiere un valor explícito y válido, y no dependas del comportamiento de respaldo.
Errores y reintentos#
Los fallos de selección de PPG suelen ser el código de error de proxy HTTP 11 con un mensaje específico. Un fallo de contabilización del tráfico es el código 12. El saldo insuficiente es el código 13 con HTTP 402 y requiere revisar o recargar el saldo, no reintentar por red.
Consulta la referencia de errores de proxy para ver los encabezados HTTP observables y las limitaciones de SOCKS5. Para los fallos de upstream de PPG, consulta la guía del código 16.