Saltar al contenido
← Guía

Cómo se conecta el agente

QUIC cuando la red lo permite, WebSocket cuando no. Sin configurar nada.

Automático

El agente intenta primero QUIC (UDP, el mismo 443). Si la red bloquea UDP —hoteles, oficinas con cortafuegos estrictos, algunos operadores móviles— usa WebSocket sobre TCP 443 y sigue funcionando igual. Si más tarde el camino UDP se abre, cambia solo, sin cortar lo que estaba sirviendo.

Al conectarse, el agente dice por cuál de los dos ha entrado. Con QUIC, perder un paquete no frena al resto de peticiones y cambiar de red (WiFi a móvil) no corta la sesión. Si el servidor se reinicia, el agente instalado como servicio vuelve en unos segundos; lanzado a mano con lnkstart up, puede tardar hasta 30 segundos más.

Forzar WebSocket

En tu máquina

LNKSTART_TRANSPORT=websocket lnkstart up

Para redes donde UDP funciona a ratos, o para comparar.

Para que QUIC esté disponible, el VPS necesita el UDP 443 abierto. Si no lo está, todo sigue funcionando por WebSocket.

Si una red se lleva mal con BBR

Por QUIC, el ritmo al que se envía lo decide BBR: con pérdidas de paquetes (wifi malo, móvil) mantiene la velocidad donde el algoritmo clásico, Cubic, se hunde. Si en una red concreta va peor, se puede volver a Cubic: en la máquina para lo que envía ella (lo que descargan los visitantes) y en el servidor para lo que envía él (lo que suben).

En tu máquina

LNKSTART_QUIC_CONGESTION=cubic lnkstart up

/etc/lnkstart/server.toml

[quic]
listen = "[::]:443"
congestion = "cubic"

En el VPS

sudo systemctl restart lnkstart-server

Detrás de un proxy de oficina

En muchas oficinas no se sale directo a internet: todo pasa por un proxy HTTP. El agente usa el de HTTPS_PROXY si está puesto; para que lo use también instalado como servicio, guárdalo:

En la máquina del agente

lnkstart proxy http://proxy.empresa.local:3128
lnkstart proxy --ca-file ca-empresa.pem

Con usuario: http://usuario:contraseña@proxy:3128. Por un proxy HTTP el agente va por WebSocket (QUIC es UDP y no lo cruza). Si la red abre el TLS con su propia CA, --ca-file la suma a las que el agente trae; nunca las sustituye. lnkstart proxy a secas dice qué está usando, y lnkstart proxy off lo quita.