Toda credencial de proxy tiene cuatro partes. Entender el papel de cada una resuelve la mayoría de los problemas de acceso antes de que aparezcan.
Los cuatro datos
| Campo | Qué es | Ejemplo |
|---|---|---|
| Host | Dirección del servidor proxy | p1.ejemplo.com |
| Puerto | Puerto que corresponde al protocolo | 8000 |
| Usuario | Identificador de tu credencial | pbx_a1b2c3 |
| Contraseña | Clave de acceso | xY7k... |
Host y puerto dicen adónde conectarse. Usuario y contraseña prueban que tienes derecho a usar ese proxy.
Dónde encontrarlos en el panel
Entra en Mis proxies y abre el proxy que quieres usar. La pantalla muestra los cuatro campos, cada uno con su botón de copiar, además de formatos listos para pegar.
Usa siempre el botón de copiar. Seleccionar con el ratón es una causa frecuente de que se cuele un espacio al final de la credencial, y un espacio invisible genera exactamente el mismo mensaje de error que una contraseña equivocada.
Formatos según el tipo de herramienta
Cada herramienta espera la credencial de una forma distinta. Los cuatro formatos más habituales:
Campos separados: navegadores antidetect y clientes con interfaz gráfica.
Host: p1.ejemplo.com
Puerto: 8000
Usuario: pbx_a1b2c3
Contraseña: tu-contrasena
Cadena con dos puntos: importación por lotes.
p1.ejemplo.com:8000:pbx_a1b2c3:tu-contrasena
URL de conexión: bibliotecas HTTP y variables de entorno.
http://pbx_a1b2c3:[email protected]:8000
socks5://pbx_a1b2c3:[email protected]:8000
Variables de entorno: contenedores, scripts e integración continua.
export HTTP_PROXY="http://pbx_a1b2c3:[email protected]:8000"
export HTTPS_PROXY="http://pbx_a1b2c3:[email protected]:8000"
export NO_PROXY="localhost,127.0.0.1"
El panel ofrece estos formatos con botón de copiar, para que no tengas que armar la cadena a mano.
Caracteres especiales en la contraseña
Si la contraseña contiene caracteres como @, :, / o # y la pones dentro de una URL, hay que codificarla. La @ es el caso crítico: es justo el separador entre la credencial y el host, así que una contraseña con @ rompe la URL.
Codificaciones más comunes:
| Carácter | Codificado |
|---|---|
@ |
%40 |
: |
%3A |
/ |
%2F |
# |
%23 |
| espacio | %20 |
En campos separados no hace falta: el problema solo existe en el formato URL.
Por qué usamos credencial y no autorización por IP
La autorización por IP consiste en registrar de antemano las direcciones que pueden usar el proxy. Es más restrictiva, pero tiene un coste práctico alto: cada vez que cambias de red (sales de la oficina, usas datos del celular (móvil), levantas un VPS nuevo) tienes que registrar la nueva dirección antes de poder conectarte.
Con autenticación por credencial, el mismo proxy funciona desde casa, desde el celular, desde un servidor y desde una máquina virtual, sin registro previo. Para operaciones que corren en más de un sitio, la diferencia de comodidad es grande. En ProxyBox no existe la opción de liberar el acceso por IP: siempre es usuario y contraseña.
Errores de acceso y qué significan
407 Proxy Authentication Required: usuario o contraseña incorrectos, ausentes o con un espacio de más. Vuelve a copiarlos del panel. Todas las causas están en error 407.
Conexión rechazada: no es un problema de autenticación. Es host o puerto incorrectos, o un puerto que no corresponde al protocolo seleccionado.
Tiempo de espera agotado (timeout): la petición no llegó al proxy. Puede ser un firewall local, una red corporativa que bloquea el puerto o un host mal escrito.
Funciona en una herramienta y falla en otra: casi siempre es el formato. La herramienta que falla probablemente espera un formato distinto del que pegaste.
Dejó de funcionar de repente: comprueba que el plan sigue vigente y que la contraseña no se cambió en el panel sin actualizar las herramientas.
Buenas prácticas
- Trata la credencial como una contraseña: da acceso a tu proxy y a tu consumo
- No la compartas en grupos ni canales abiertos
- Si alguien del equipo necesita acceso, mejor un proxy aparte que compartir el mismo
- Al terminar un contrato con un tercero, cambia la contraseña desde el panel
- En un repositorio de código, usa variables de entorno; nunca dejes la credencial en un archivo versionado
Para comprobar que la credencial funciona antes de usarla en una herramienta, sigue la guía para probar el proxy.