# curl proxy: HTTP, SOCKS5 y variables de entorno | ProxyJam

curl proxy: envía curl por un proxy HTTP o SOCKS5 con -x y -U, configúralo con variables de entorno y codifica los caracteres especiales de la contraseña.

- Canonical: https://proxyjam.com/es/faq/curl-proxy/
- Updated: 2026-11-22
- Language: es

Usa curl -x http://HOST:PORT -U LOGIN:PASSWORD URL para un proxy HTTP, y socks5h://HOST:PORT para SOCKS5. La opción -U toma la contraseña tal como la escribes. Define http_proxy, https_proxy o all_proxy para cubrir toda una sesión de terminal, y codifica con porcentaje los caracteres especiales cuando el usuario va dentro de la URL.


## Respuestas rápidas sobre curl y los proxies

### ¿Por qué socks5h y no socks5?

Con socks5h, curl envía el nombre del host al proxy para que lo resuelva él; con socks5, curl lo resuelve primero en local. Usa socks5h salvo que necesites la resolución local.

### ¿Dejo http:// en la dirección del proxy para los sitios HTTPS?

Sí. El esquema indica cómo habla curl con el proxy, no con el sitio. Un proxy HTTP transporta las páginas HTTPS a través de un túnel.

### ¿Qué significa un 407 en curl?

El proxy rechazó el usuario y la contraseña o tu dirección. Vuelve a copiar los datos desde el panel y revisa la lista de IP permitidas.



curl es la forma más rápida de probar un proxy y funciona igual en macOS, Linux y Windows.
Sustituye los cuatro marcadores por los valores de una fila de **Mis Proxies** en tu
[panel](https://app.proxyjam.com).

## Proxy HTTP

```
curl -x http://HOST:PORT -U LOGIN:PASSWORD https://example.com/
```

`-x` (forma larga `--proxy`) define el proxy y `-U` (`--proxy-user`) define el usuario. La
contraseña de `-U` se toma tal como la escribes, así que ahí no hace falta codificarla.
Mantén `http://` en la dirección del proxy aunque la página use HTTPS: el esquema indica
cómo habla curl con el proxy. Añade `-I` para imprimir solo las cabeceras, o `-v` para ver
cómo se abre el túnel.

## Proxy SOCKS5

Primero pasa el pedido a SOCKS5 con **Cambiar protocolo** y vuelve a copiar los datos. Después:

```
curl -x socks5h://HOST:PORT -U LOGIN:PASSWORD https://example.com/
```

La `h` hace que sea el proxy quien resuelva el nombre del host. La opción más antigua
`--socks5-hostname HOST:PORT` hace lo mismo. Nuestra página de
[proxies SOCKS5](/es/socks5-proxies/) describe el protocolo.

## Credenciales dentro de la URL

Puedes escribir el usuario en la propia dirección del proxy:

```
curl -x http://LOGIN:PASSWORD@HOST:PORT https://example.com/
```

En ese caso, los caracteres con significado especial en una URL deben codificarse con
porcentaje: `@` pasa a ser `%40`, `:` pasa a ser `%3A`, `/` pasa a ser `%2F`, `#` pasa a ser
`%23` y `%` pasa a ser `%25`. Una contraseña sin codificar se corta en el primero de esos
caracteres, y el proxy responde 407.

## Variables de entorno

Para cubrir todos los comandos curl de la sesión de terminal actual:

```
export http_proxy="http://LOGIN:PASSWORD@HOST:PORT"
export https_proxy="http://LOGIN:PASSWORD@HOST:PORT"
```

En PowerShell queda así:

```
$env:http_proxy = "http://LOGIN:PASSWORD@HOST:PORT"
$env:https_proxy = "http://LOGIN:PASSWORD@HOST:PORT"
```

Pon el valor entre comillas, y una contraseña con caracteres especiales del shell, como
`$`, `&` o `!`, también necesita comillas o escapado; las comillas simples son lo más
seguro en un shell POSIX.

`all_proxy` define un único proxy para todos los protocolos, y `no_proxy` enumera los hosts
que lo omiten. Usa los nombres en minúsculas para `http_proxy`, porque curl ignora la forma
en mayúsculas para HTTP sin cifrar. Quítalas con `unset http_proxy https_proxy`. Los datos
quedan visibles en el historial de tu terminal y en la lista de procesos, así que no lo uses
en un equipo compartido.

## Qué forma usar

Usa `-x` y `-U` para una sola petición y para scripts, porque dejan tu shell intacto. Usa la
forma con URL cuando una herramienta admite una sola cadena de proxy. Usa las variables de
entorno cuando trabajas un rato en la terminal y quieres que todas las llamadas de curl sigan
la misma ruta. En un script, es mejor usar variables definidas dentro del propio script que
otras exportadas de forma global.

## Lee el resultado

Un `200` o una redirección significa que el proxy aceptó el inicio de sesión. Un `407`
significa que no: [el error 407 del proxy](/es/faq/proxy-error-407/) enumera las
comprobaciones, y [la autenticación del proxy fallida](/es/faq/proxy-authentication-failed/)
cubre el modo de lista de IP permitidas. Para confirmar la dirección de salida, carga
[Mi IP](/es/what-is-my-ip/) a través del proxy, o pega el proxy en nuestro
[proxy checker](/es/proxy-checker/), que hace la misma prueba de una petición sin terminal. El mismo proxy en código está en la
página de [Python requests](/es/integrations/python-requests/), y los pedidos y los precios
están en la página de [proxies ISP](/es/isp-proxies/).

