Solución de problemas
¿Algo no funciona? La mayoría de los problemas encajan en uno de los ocho patrones siguientes. Encuentra el síntoma que coincide, sigue el diagnóstico y aplica la solución.
Conexión rechazada o tiempo de espera agotado en el gateway
Sección titulada «Conexión rechazada o tiempo de espera agotado en el gateway»Síntomas: Tu cliente indica “connection refused”, “connection timed out” o “no route to host” al llamar a p.shifter.io:443.
Diagnóstico:
- Confirma que estás apuntando al nuevo gateway:
p.shifter.io:443. Los planes antiguos usan subdominios por puerto comoapollo.p.shifter.io:<port>. - Comprueba que tu IP de origen no está detrás de un firewall que bloquee el tráfico saliente por el puerto 443.
- Prueba la conectividad básica:
nc -vz p.shifter.io 443.
Solución: Si la conectividad básica funciona pero el proxy falla, el problema es de autenticación. Consulta la sección sobre el error 407 más abajo. Si la conectividad básica falla, revisa las reglas del firewall de salida y vuelve a intentarlo desde otra red.
HTTP 407 Proxy Authentication Required
Sección titulada «HTTP 407 Proxy Authentication Required»Síntomas: Todas las solicitudes devuelven 407 Proxy Authentication Required.
Diagnóstico:
- Credenciales incorrectas: un error de escritura en el nombre de usuario o la contraseña.
- Marcador desconocido: un código de país, un slug de ciudad o una cadena de sesión mal formados en el nombre de usuario extendido.
- Contraseña regenerada: la contraseña antigua ya no es válida tras una rotación en el panel. Solución:
- Elimina todos los marcadores y vuelve a intentarlo primero solo con el nombre de usuario y la contraseña básicos. Si funciona, añade los marcadores de nuevo uno a uno.
- Consulta shifter.io/panel en Residential Proxies para confirmar tu contraseña.
- Si has rotado las contraseñas recientemente, propaga el nuevo valor a todos los clientes.
Tiempos de respuesta lentos desde IPs residenciales
Sección titulada «Tiempos de respuesta lentos desde IPs residenciales»Síntomas: Las solicitudes tardan entre 5 y 10 o más segundos. IPs que antes eran rápidas se han ralentizado.
Diagnóstico: Las IPs residenciales proceden de conexiones reales de ISP. Cierta variación en la latencia es normal. La lentitud persistente suele significar:
- El usuario final de esa IP está haciendo un uso intensivo de la conexión (Netflix, subidas grandes).
- El sitio de destino está limitando la velocidad de la IP.
- El filtro del pool es demasiado estrecho y estás recibiendo IPs congestionadas.
Solución:
- Rota con más frecuencia (elimina la sesión persistente o reduce el
ttl). - Amplía tu filtro (elimina la ciudad, conserva solo el país).
- Para proxies ISP: usa Managing IPs → Replace para sustituir la IP lenta por una nueva.
La geolocalización de la IP no coincide con mi destino
Sección titulada «La geolocalización de la IP no coincide con mi destino»Síntomas: Has solicitado country-us-city-new_york y el sitio de destino cree que estás en otro lugar.
Diagnóstico:
- Las IPs residenciales se geolocalizan mediante bases de datos de terceros (MaxMind, IP2Location). Estas bases de datos no siempre coinciden con la propia fuente de geolocalización del sitio de destino.
- Las IPs de operadores móviles y los rangos de ISP recién asignados pueden estar mal clasificados durante semanas.
Solución:
- Vuelve a intentar la solicitud. Shifter asigna una nueva IP en cada solicitud (o en cada sesión persistente) y la siguiente puede tener una geolocalización más precisa en la base de datos del destino.
- Si necesitas una ubicación geográfica garantizada para un destino concreto, ponte en contacto con soporte indicando la URL de destino y la ubicación deseada. Podemos validar previamente las IPs frente a ese destino.
Errores HTTPS, fallos de SSL/TLS
Sección titulada «Errores HTTPS, fallos de SSL/TLS»Síntomas: SSL handshake failed, certificate verify failed o tls: bad record MAC.
Diagnóstico:
- Estás usando una versión antigua de OpenSSL o de Node que rechaza el conjunto de cifrado del gateway.
- La cadena de confianza de los proxies corporativos está rota.
Solución:
- Actualiza la biblioteca TLS de tu cliente. Node 18+, Python requests 2.28+ y curl 7.80+ son versiones conocidas como válidas.
- Fija (pin) el certificado del gateway para evitar problemas de cadena si tu entorno requiere hosts estrictos.
- Solo para depuración:
--proxy-insecureen curl desactiva la verificación del certificado en el tramo del proxy. Nunca despliegues este parámetro en producción.
El sitio de destino sigue bloqueándome
Sección titulada «El sitio de destino sigue bloqueándome»Síntomas: Incluso a través de proxies residenciales con rotación, un destino concreto devuelve CAPTCHAs, errores 403 o cuerpos vacíos.
Diagnóstico: El destino cuenta con protección anti-bot en capas (Cloudflare, Akamai, DataDome) que identifica más allá de la IP. Indicios habituales:
- El User-Agent no coincide con la huella TLS (desajuste JA3/JA4).
- Las cabeceras se envían en un orden distinto al de un navegador real.
- Las API del navegador (detección de WebDriver, indicador navigator.webdriver) revelan automatización.
- La rotación de IP es demasiado agresiva para el modelo de sesión del destino.
Solución:
- Cambia de proxies básicos a la Web Scraping API, que incluye modo sigiloso y resolución de CAPTCHA.
- O bien: abre un ticket indicando la URL de destino. Muchos casos se pueden ajustar desde nuestro lado.
La Web Scraping API devuelve 509 Bandwidth Limit Exceeded
Sección titulada «La Web Scraping API devuelve 509 Bandwidth Limit Exceeded»Síntomas: La Scraping API devuelve 509 aunque todavía te queden créditos en tu plan.
Diagnóstico: 509 significa que se ha agotado la cuota del plan. Si aún te quedan créditos en el panel, comprueba:
- Que estás usando la clave de API correcta (no una de un plan antiguo).
- Que Extra Traffic esté habilitado si quieres que el exceso se convierta a pago por uso.
Solución:
- Confirma que la clave coincide con el plan activo en Web Scraping API → API Keys.
- Activa Billing → Extra Traffic para convertir automáticamente los excesos a precio por crédito.
- Actualiza el plan si te quedas sin recursos con frecuencia.
El pago falló o la suscripción no se activó
Sección titulada «El pago falló o la suscripción no se activó»Síntomas: Has pagado, pero el plan aparece como inactivo, o la renovación falló sin ningún aviso.
Diagnóstico:
- El emisor de la tarjeta bloqueó la transacción (habitual en cargos internacionales sin tarjeta física presente).
- La tarjeta ha caducado o no se completó el desafío 3DS.
- El pago en criptomonedas aún no se ha confirmado (se requieren 6 confirmaciones).
Solución:
- Comprueba el historial de transacciones de la tarjeta en tu aplicación bancaria. Si el cargo fue rechazado, vuelve a intentarlo con otra tarjeta.
- En el caso de las criptomonedas, los pagos son detectados por el procesador al alcanzar 6 confirmaciones en la blockchain. Suele tardar entre 15 y 60 minutos para BTC/ETH.
- Si el cargo se realizó correctamente pero el plan sigue inactivo después de 30 minutos, envía un correo a
hi@shifter.iocon el ID de la factura.
Ver también
Sección titulada «Ver también»- Facturación y precios - reembolsos, facturas, métodos de pago.
- Soporte - canales de contacto, SLA, página de estado.