Menú de la documentación

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. Para saber qué cuenta como tráfico cobrado y cómo reducirlo, consulta Cómo se cuenta el tráfico de pago por GB.

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.

Los navegadores no pueden usar UDP a través de su ajuste de proxy: la compatibilidad de Chrome con SOCKS5 retransmite solo TCP, así que HTTP/3 recurre a HTTP/2 y WebRTC puede saltarse el proxy. Para dar UDP (HTTP/3, llamadas WebRTC) a un navegador o a un dispositivo entero, vincula el proxy a un perfil de VPN. Proxies UDP enumera los pools que transportan UDP.

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.

Tope de tráfico y caducidad#

Cada proxy de pago por GB puede tener su propio tope de tráfico y su propia fecha de caducidad. Ambos son opcionales. Úsalos para dar a un cliente, a un miembro del equipo o a una herramienta una cantidad fija de tráfico o un tiempo fijo.

  • Panel. Agrega o edita un proxy en la página «Pago por GB». Límite de tráfico (GB) es el tope en gigabytes; escribe los decimales con punto o coma (2.5 o 2,5). Caduca es una fecha, y el proxy se detiene al final de ese día (UTC). En la lista de proxies, el cuadro «Estadísticas de tráfico» muestra cuánto del límite se ha contado, lo que puede ir un poco por delante del tráfico entregado.
  • API. Envía expiresAt y allowanceBytes cuando crees o cambies un proxy. Ambos se devuelven en cada token.

El tope cuenta todo el tráfico entre tu cliente y el hub, en ambas direcciones y con la sobrecarga del protocolo incluida, así que nunca es menor que el tráfico que se te cobra. Un proxy puede detenerse un poco antes de su tope, pero nunca lo supera. El tope solo rechaza tráfico; lo que se te cobra no cambia. Consulta Tope de tráfico para ver los detalles.

Un proxy que ya usó todo su tope se rechaza con el error de proxy 24. Agregar, cambiar o quitar un tope cierra una vez las conexiones abiertas del proxy, y los clientes se reconectan con el tope nuevo.

Direcciones de proxy#

Configuración > Direcciones de proxy tiene una sola casilla, Usar direcciones neutras. Está desactivada de forma predeterminada. Cuando está activada:

  • las listas de proxies, el generador de proxies y la API muestran nombres de host neutros y nombres de pool neutros;
  • los enlaces para cambiar la IP usan la dirección neutra;
  • las líneas de proxy HTTPS conservan litport.net, porque el certificado HTTPS se emite para ese nombre.

Cambia los nombres que te mostramos para tu propia cuenta. No cambia las direcciones IP de los proxies, los perfiles de VPN, los correos ni la dirección propia del panel. Donde un nombre neutro es igual al estándar, ese nombre no cambia.

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. Un proxy que usó su tope de tráfico es el código 24 con HTTP 403; el código 25 con HTTP 503 significa que no se pudo leer el tope a tiempo, y un reintento breve es adecuado.

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.