# Puerto Proxy: segmentación y sesiones en el username

> URL: https://foura.ai/es/blog/proxy-port-username-options
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

## Novedades

Basta una sola letra que falte. Escribe `-contry-de` en el nombre de usuario del proxy y el error tipográfico quedará a la vista, pareciendo exactamente una opción válida.

El puerto proxy de FourA responde a eso con un 400 que enumera cada clave que reconoce. Ese es un pequeño detalle de un producto que [salió de beta el 15 de septiembre](https://foura.ai/blog/foura-digest-2026-09-18): una [URL de proxy en nuestros nodos de salida](https://foura.ai/proxy) para cualquier cliente compatible (un navegador, una herramienta de descarga o el scraper que ya ejecutas), sin necesidad de escribir llamadas a la API. Creas un usuario de proxy en el Dashboard, pegas la cadena y los túneles y el tráfico consumen tu plan del mismo modo que las requests de la API.

Aquí tienes la gramática completa y la razón de ser de cada regla.

## Cómo funciona

El puerto está en `proxy.foura.ai:34004` y utiliza HTTP CONNECT con Basic authentication hacia destinos en los puertos 443 y 80. Las credenciales son usuarios de proxy, separados a propósito de tu API key: un handshake de proxy viaja en texto plano, y un usuario de proxy puede recibir una contraseña nueva sin necesidad de que nadie modifique tu integración con la API.

Todo lo que sigue a las credenciales es una lista de pares `-key-value`, en cualquier orden:

```bash
# Shared network, a German address, one sticky session for this job
curl -x "http://USERNAME-country-de-session-job42:PASSWORD@proxy.foura.ai:34004" \
  https://example.com

# Premium network, an Android address in Germany, held 30 minutes
curl -x "http://USERNAME-network-premium-country-de-os-android-session-s1-lifetime-30:PASSWORD@proxy.foura.ai:34004" \
  https://example.com
```

Shared son las salidas propias de FourA: la opción predeterminada e incluida en tu plan. Premium son direcciones residenciales, tomadas del tráfico premium de tu plan más el saldo adicional que hayas comprado. En la red shared, `-fallback-premium` permite que una conexión pase a una salida premium cuando la compartida no pueda procesarla. Está desactivado a menos que lo solicites y solo se activa mientras tengas saldo premium disponible. Activarlo por defecto implicaría decidir, en tu nombre, gastar ese saldo.

Country se puede repetir, por lo que `-country-de-country-fr` define un alcance de dos países. Region, city, red por número AS, dispositivo (`windows`, `android`, `ios`, `mac`) y `lifetime` (de 3 a 1440 minutos) son exclusivos para premium. Si solicitas una ciudad en la red shared, recibirás un error 400 en lugar de un intento aproximado. Shared se selecciona por país y nada más granular, porque un filtro de ciudad que rara vez se puede cumplir es peor que no tener ningún filtro.

`-session-<name>` (de 1 a 32 letras, dígitos o guiones bajos) hace que las conexiones sean persistentes: cada conexión con ese identificador comparte la misma dirección. En shared, la dirección se mantiene en una ventana deslizante de diez minutos, por lo que dura mientras continúes usándola. En premium, se mantiene durante el `lifetime` que definas o el valor predeterminado de la red. Si omites la sesión, cada conexión saldrá desde una dirección nueva.

Luego están los valores predeterminados guardados. La segmentación guardada en un usuario proxy dentro del Dashboard se aplica a cada conexión que este realiza, lo que permite reducir la cadena a las credenciales básicas. El username sigue teniendo prioridad para su propia conexión, y `any` anula un valor guardado: `-city-any` solicita a una clave que recuerda Múnich que aplique a toda Alemania. Los clientes capaces de enviar headers en una petición CONNECT (curl lo permite con `--proxy-header`) pueden enviar las mismas opciones como `X-Foura-Country`, `X-Foura-Session` y demás, y un header tiene prioridad sobre el username.

## Impacto

La mayor parte de esto se traduce en preguntas que ya no necesitas hacer.

**¿Por qué fue rechazada mi petición?** Cada rechazo tras validar tus credenciales incluye un header `X-Foura-Error` con el motivo en una sola línea. Un código 400 indica la opción y los valores que acepta. Un 429 especifica qué límite de tu plan alcanzaste: túneles abiertos simultáneamente, aperturas de túneles por minuto o tráfico estándar del período de facturación.

**¿A quién pertenece la cuota?** A la cuenta. Los túneles y las aperturas se contabilizan por cuenta y no por usuario proxy, por lo que un segundo juego de credenciales no otorga una cuota adicional. Los bytes se descuentan del ancho de banda de tu plan, y los bytes premium se descuentan de tu cuota premium dentro de ese total, sin sumarse a él. En planes basados en créditos, el puerto incluye sus propios gigabytes, que se recargan desde la página de Billing. No se descuenta nada si no se abre ningún túnel.

**¿Quién gestiona la credencial?** Ahora puede pertenecer a una organización, de modo que el sistema de descargas de una empresa no se detiene cuando alguien se va. Los miembros pueden usarla y leer su contraseña; los administradores y propietarios pueden rotarla, desactivarla o cambiar su segmentación; solo el propietario puede transferirla.

**¿Qué hizo?** Cambia el interruptor de Producto en Overview, Metrics o Activity a Proxy: túneles en las mismas clases de resultado que tus requests de la API, cuántos están abiertos ahora mismo, tiempo de configuración y tráfico, desglosados por usuario de proxy, destino, país de salida o IP del cliente. Una sesión que ya tiene su dirección suele conectarse en mucho menos de un segundo.

Pero el puerto es una tubería, y esa es la contrapartida. Tu cliente habla con el sitio a través del túnel, por lo que los perfiles de navegador, tus [reglas de validación](https://foura.ai/blog/validate-decides-success) y el manejo de páginas interactivas no están en esa ruta. También mide los bytes: una página de rechazo que llega por un túnel abierto cuenta como bytes como cualquier otra, mientras que en la API un request que no tiene éxito no se factura. Mueve bytes a través del puerto; envía a la API las páginas que presentan resistencia.

## Para usuarios avanzados

Una vez consumida la cuota premium, las tres rutas hacia esa red reciben tres respuestas distintas, a propósito. Una conexión que especifica `-network-premium` se rechaza con un 403 que lo indica, porque un cliente atendido silenciosamente desde otro lugar seguiría haciendo peticiones y luego buscaría en la factura una línea premium que nunca aparece. El fallback simplemente no se utiliza, y un valor predeterminado premium guardado en el usuario de proxy pasa a la red compartida, por lo que el túnel aún se abre. Ninguno de ellos decidió gastar en esa conexión.

Se rechazan por completo tres combinaciones en lugar de procesarlas a medias: una segmentación más precisa en la red compartida, `-fallback-premium` junto con `-network-premium`, y una segmentación más precisa mientras un fallback está activo. El puerto solo admite CONNECT, por lo que un cliente que reenvía un request `http://` simple en lugar de tunelizarlo recibe un 405 (curl lo tuneliza con `--proxytunnel`). Y un navegador controlado a través del puerto siempre debe llevar un nombre de sesión, ya que la carga de una sola página abre docenas de conexiones.

¿Varios workers, cada uno en su propia dirección? Asigna a cada uno su propio nombre de sesión:

```python
import requests

TEMPLATE = "http://USERNAME-country-de-session-{name}:PASSWORD@proxy.foura.ai:34004"

def worker_session(name):
    proxy = TEMPLATE.format(name=name)
    s = requests.Session()
    s.proxies = {"http": proxy, "https": proxy}
    return s

workers = [worker_session(f"w{i}") for i in range(4)]
print(workers[0].get("https://example.com").status_code)
```

El Dashboard hace lo mismo a escala: define Sticky, elige cuántas y la pestaña Connection string listará una línea por dirección, como URL o como `host:port:user:pass` para gestores de proxy. ¿Confundido por un rechazo? Añade `-sv` a la llamada curl y redirige `2>&1 | grep -i x-foura-error`. Cada opción está en la [referencia de puertos proxy](https://foura.ai/docs/api/proxy-port), y la parte del Dashboard en [Proxy Users](https://foura.ai/docs/dashboard/proxy).

## Próximos pasos

El primer cliente que creamos sobre proxy users es el nuestro. La [extensión de Chrome de FourA](https://foura.ai/extension) envía tu navegador a través de uno de ellos: elige la red y el país, activa el interruptor y una línea de estado mostrará la dirección que ven los sitios. Es una beta, no está en la Chrome Web Store y se instala desde Tools en el Dashboard en modo de desarrollador. Más adelante, la [facturación por organizaciones](https://updates.foura.ai) estará en el roadmap público, lo cual importa aquí porque el proxy user de una organización le factura hoy a quien sea dueño de esa organización.

Una URL de proxy es el contrato de integración más antiguo que existe, y cada herramienta que tienes ya lo entiende. La parte que valía la pena perfeccionar nunca fue el túnel. Es lo que la cadena delante de él puede significar, y lo que sucede cuando te equivocas.