Cómo funciona WireGuard: enrutamiento con claves
AllowedIPs actúa como tabla de rutas y lista de acceso. Entienda el enrutamiento criptográfico, el handshake Noise y la rotación de claves en wg0.conf.
Cómo funciona WireGuard, en una idea
WireGuard vincula cada paquete a una clave pública. El mecanismo se denomina enrutamiento mediante claves criptográficas y constituye todo el diseño: la línea AllowedIPs situada junto a un peer es la tabla de enrutamiento para los paquetes que salen de su máquina y la lista de control de acceso para los paquetes que llegan desde ese peer. Un ajuste cumple dos funciones. Interprete AllowedIPs de esa forma y todos los archivos de configuración de WireGuard resultarán comprensibles.
No existe una tabla de sesiones indexada por dirección IP ni una base de datos de usuarios. Un peer es una clave pública junto con el conjunto de direcciones que esa clave puede usar. El handshake y los temporizadores mantienen válida esa asociación mientras cambia la red subyacente. Si quiere tener un túnel operativo antes de estudiar la teoría, créelo con una VPN WireGuard autohospedada en su propio VPS y vuelva aquí cuando una línea de configuración le resulte inesperada.
AllowedIPs es una tabla de enrutamiento y una lista de control de acceso
Comience por la dirección saliente. El kernel enruta un paquete al dispositivo wg0 de la forma habitual, mediante la tabla de enrutamiento principal. Después, WireGuard compara la dirección de destino de ese paquete con una tabla que contiene los prefijos permitidos de todos los peers, empezando por el prefijo más largo. Una coincidencia identifica un peer; este identifica una clave pública, que a su vez identifica una clave de sesión y un endpoint UDP. El paquete se cifra para ese peer y se envía allí.
Si el AllowedIPs de ningún peer incluye el destino, no se envía nada porque no existe una clave con la que cifrarlo.
ping: sendmsg: Required key not availableEse error sólo significa una cosa: la dirección que intentó alcanzar no figura en ningún peer. Otro error, ping: sendmsg: Destination address required, significa que sí coincidió un peer, pero WireGuard no tiene un endpoint para él porque no se configuró ninguno y todavía no se ha aprendido ninguno.
Ahora, la dirección entrante. Un paquete UDP llega al puerto de escucha. WireGuard obtiene la sesión a partir del índice del receptor incluido en la cabecera, descifra y autentica la carga útil, y después comprueba el contador mediante una ventana deslizante contra repeticiones. Sólo después lee el paquete interno, y una búsqueda del prefijo más largo de la dirección de origen debe identificar al peer emisor autenticado. Si no lo identifica, el paquete se descarta. Con la depuración dinámica habilitada, el kernel imprime el motivo en una línea como esta:
wg0: Packet has unallowed src IP (10.8.0.9) from peer 2 (203.0.113.10:51820)Por eso un peer en el lado del servidor recibe un /32. Un peer configurado con AllowedIPs = 10.8.0.2/32 puede enviar paquetes desde 10.8.0.2 y desde ninguna otra dirección. Si escribe 0.0.0.0/0 en su lugar, ese cliente podrá afirmar cualquier dirección IPv4 de origen cuyo prefijo más largo lo seleccione, pero no una dirección asignada a otro peer mediante un prefijo más específico.
Los prefijos solapados se resuelven según su especificidad, porque la búsqueda usa el prefijo más largo. Los prefijos idénticos en dos peers se comportan de otra forma: la entrada se mueve al peer configurado en último lugar y el primer peer deja de recibir ese tráfico sin que se imprima ningún error. wg show wg0 allowed-ips muestra la tabla que realmente está en el kernel. Esa tabla es la que cuenta cuando el archivo del disco y el estado activo han dejado de coincidir.
Lectura de un archivo de configuración teniendo en cuenta el enrutamiento con claves criptográficas
En el servidor:
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = <server private key>
[Peer]
PublicKey = <laptop public key>
AllowedIPs = 10.8.0.2/32En el cliente:
[Interface]
Address = 10.8.0.2/32
PrivateKey = <laptop private key>
[Peer]
PublicKey = <server public key>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25La misma palabra clave tiene un efecto opuesto en cada lado. En el cliente significa «enviar todos los destinos a este peer». En el servidor significa «aceptar únicamente esta dirección de este peer». La asimetría está en los valores, no en el rol.
La mitad de estas claves no pertenece al protocolo. Address, DNS, MTU, PostUp y SaveConfig pertenecen a wg-quick, el script de shell que activa la interfaz. No son ajustes del protocolo WireGuard; wg-quick los gestiona por separado. wg-quick strip wg0 muestra la configuración reducida que carga realmente la herramienta wg. Es la forma más rápida de ver esta separación.
Qué hace realmente el handshake
El handshake de WireGuard es Noise_IKpsk2, del Noise Protocol Framework. La parte IK es la relevante para un sysadmin: la clave pública estática del responder ya es conocida por el initiator, porque es PublicKey en el bloque [Peer], y el initiator envía su propia clave pública estática dentro del primer mensaje, cifrada. Por tanto, no hay intercambio de certificados ni un intercambio de identidad de ida y vuelta. Un observador pasivo no puede saber qué clave está iniciando la conexión, salvo que tenga la clave privada del responder.
El coste es un único intercambio de ida y vuelta. El mensaje de inicio tiene 148 bytes, la respuesta tiene 92 bytes y los datos empiezan a fluir inmediatamente después. Cada extremo genera un nuevo par de claves efímeras Curve25519 para cada handshake, y las claves de sesión proceden de una cadena de resultados Diffie-Hellman que combina las claves estáticas y efímeras. Después se descartan las claves privadas efímeras, lo que proporciona secreto directo: alguien que registre su tráfico hoy y robe la clave privada del servidor el año que viene no podrá leer lo que registró.
El inicio del handshake contiene una marca de tiempo TAI64N, y cada peer recuerda la marca de tiempo máxima que ha recibido del otro, por lo que se rechaza un inicio reproducido. Los paquetes de datos contienen un contador de 64 bits que se usa como nonce, y el receptor mantiene una ventana deslizante de contadores vistos recientemente. Así, las reproducciones y los reordenamientos importantes se gestionan sin mantener un estado de conexión al estilo de TCP.
Las claves de sesión no duran mucho y los temporizadores están compilados en el programa, no se pueden configurar.
Los datos de este gráfico
[
{
"label": "REKEY_TIMEOUT",
"seconds": 5,
"notes": "resend a handshake initiation that got no answer, plus up to 333 ms of random jitter"
},
{
"label": "KEEPALIVE_TIMEOUT",
"seconds": 10,
"notes": "send a keepalive after receiving data and sending none back"
},
{
"label": "REKEY_ATTEMPT_TIME",
"seconds": 90,
"notes": "stop retrying the handshake and drop the packets queued for that peer"
},
{
"label": "REKEY_AFTER_TIME",
"seconds": 120,
"notes": "the peer that initiated the current session begins a fresh handshake when it next sends"
},
{
"label": "REJECT_AFTER_TIME",
"seconds": 180,
"notes": "the old session key is refused and traffic stops"
}
]Son constantes de la especificación del protocolo, no mediciones. Estos 5 temporizadores ayudan a gestionar el ciclo de vida de la sesión. Cuando una clave de sesión tiene 120 segundos, el peer que inició ese handshake empieza uno nuevo la próxima vez que envía datos; el responder no vuelve a generar la clave con este temporizador. Después de 180 segundos, la clave antigua se rechaza por completo, por lo que el tráfico se detiene hasta que termina un nuevo handshake. Un inicio que no recibe respuesta se reenvía después de 5 segundos, más una variación aleatoria de hasta un tercio de segundo, y los reintentos se detienen después de aproximadamente 90 segundos. Por eso wg show muestra latest handshake como una antigüedad relativa y por eso un túnel activo y saludable mantiene esa antigüedad baja. Si la antigüedad aumenta mientras se envía tráfico activamente, significa que los handshakes están fallando, no que el túnel esté inactivo.
Por qué un peer no tiene un rol de cliente ni de servidor
Ambos extremos ejecutan el mismo código y usan el mismo formato de configuración. No existe un modo de servidor. La asimetría que se observa procede de Endpoint, y Endpoint es opcional.
Un peer con un endpoint configurado puede iniciar un handshake. Un peer sin endpoint espera y después aprende la dirección y el puerto del otro extremo a partir del primer paquete que se autentica correctamente. Ese endpoint aprendido se almacena y se actualiza cada vez que llega un paquete válido desde una dirección nueva. Así funciona el roaming: un portátil que cambia de Wi-Fi a una red móvil mantiene el mismo túnel, porque una sesión se identifica mediante la clave y el índice, no mediante la dirección IP. No se restablece ninguna conexión, porque nunca hubo una conexión en el sentido de TCP.
El mismo mecanismo genera un dato importante: el peer con la dirección pública siempre conserva la última IP pública conocida del otro extremo, y wg show la muestra.
Primitivas fijas, sin negociación
WireGuard no tiene una lista de conjuntos de cifrado. Usa ChaCha20-Poly1305 para el cifrado autenticado, Curve25519 para el acuerdo de claves, BLAKE2s para el hash y HKDF para la derivación de claves. Todas las implementaciones usan estas primitivas. Por tanto, no hay una fase de negociación que analizar ni una vía de degradación a una opción más débil. El coste es real: si una de estas primitivas se rompe, la solución es una nueva versión de todo el protocolo y una actualización en ambos extremos, no un cambio de configuración. Esta única decisión elimina la mayor parte del código y de los modos de fallo que incorpora un túnel basado en TLS. En eso se resume principalmente la comparación de WireGuard frente a OpenVPN.
Por qué el puerto no responde a un escáner
Los mensajes de inicio y respuesta del handshake contienen un campo llamado mac1; las respuestas con cookie no lo contienen. Es un MAC (código de autenticación de mensajes) calculado sobre el mensaje con una clave derivada de la clave pública estática del receptor. Un emisor que no conoce esa clave pública no puede generar un mac1 válido, y el receptor descarta ese paquete sin responder. No envía ningún error, restablecimiento ni mensaje ICMP.
El resultado visible es un escaneo UDP que no recibe ninguna respuesta.
sudo nmap -sU -p 51820 vpn.example.comnmap informa open|filtered, que es la misma respuesta que proporciona para un puerto cuyos paquetes un firewall descarta silenciosamente. En cambio, un puerto UDP sin filtrar y sin ningún proceso escuchando normalmente devuelve un error ICMP de puerto inalcanzable, que nmap informa como closed.
Un segundo campo, mac2, gestiona la presión causada por ataques de denegación de servicio. Cuando el receptor está bajo carga, responde a un mensaje de inicio o respuesta con un mac1 válido, pero sin un mac2 válido, mediante una respuesta con cookie de 64 bytes vinculada a la dirección de origen del emisor. Además, no realiza operaciones costosas con claves públicas hasta que el emisor utiliza esa cookie para calcular un mac2 válido. De este modo, se demuestra que la dirección de origen es accesible antes de realizar operaciones costosas con claves públicas. Esta función sólo se activa bajo carga.
Por qué 0.0.0.0/0 convierte a un peer en la ruta predeterminada
Como AllowedIPs es la tabla de enrutamiento, AllowedIPs = 0.0.0.0/0, ::/0 selecciona ese peer para los destinos que no estén cubiertos por un prefijo más específico asignado a otro peer. Esta es toda la configuración del túnel completo.
El enrutamiento que hace que funcione es más interesante que la línea en sí. Una ruta predeterminada simple a través de wg0 entraría en un bucle, porque el paquete UDP cifrado que transporta el tráfico también tiene que salir de la máquina y coincidiría con su propia ruta predeterminada. wg-quick evita esto mediante el enrutamiento basado en políticas. Marca los paquetes salientes propios de WireGuard con un fwmark, coloca la ruta predeterminada del túnel en una tabla de enrutamiento separada y añade reglas para que sólo el tráfico sin marca llegue a ella. Ejecute ip rule show para ver el resultado:
32764: from all lookup main suppress_prefixlength 0
32765: not from all fwmark 0xca6c lookup 51820
32766: from all lookup main0xca6c es 51820 en hexadecimal, y 51820 también es el número de la tabla. La regla suppress_prefixlength 0 hace que la tabla principal omita su propia ruta predeterminada, por lo que las rutas específicas, como la de la subred local, siguen teniendo prioridad, mientras que todo lo demás pasa a la tabla del túnel. Un túnel dividido no necesita nada de esto: una lista más limitada, como AllowedIPs = 10.8.0.0/24, 10.20.0.0/16, se convierte en rutas normales de la tabla principal.
Un túnel completo no resuelve por sí solo la resolución de nombres, porque el resolver que el cliente obtuvo de la red local normalmente sigue configurado y su ruta es más específica. Es una tarea independiente, explicada en DNS que se filtra fuera de un túnel WireGuard.
Para qué sirve realmente PersistentKeepalive
WireGuard no envía nada cuando no hay tráfico. No hay heartbeat, actualización de sesión ni ningún otro dato en la red. Ese silencio ayuda a conservar batería y también permite el caso del escáner descrito antes, pero interrumpe una configuración concreta.
Un peer detrás de NAT (network address translation) o de un firewall con estado sólo es accesible desde el exterior mientras exista un mapeo en ese dispositivo, y ese mapeo se creó mediante un paquete saliente. Los tiempos de vida habituales de los mapeos UDP empiezan en aproximadamente 30 segundos. Cuando el mapeo caduca, el middlebox descarta los paquetes procedentes del lado público y el túnel parece caído hasta que el peer situado detrás de NAT envía algo. PersistentKeepalive = 25 envía un paquete autenticado vacío cada vez que transcurren 25 segundos sin que ningún paquete autenticado cruce el túnel hacia ese peer o desde él. El tráfico real reinicia la cuenta atrás, por lo que en un túnel con tráfico el paquete vacío rara vez llega a enviarse y, en uno inactivo, el intervalo nunca supera esa duración mínima habitual, de modo que el mapeo permanece abierto.
Configúrelo en el peer situado detrás de NAT. Un servidor con una dirección pública y un puerto UDP abierto no lo necesita, y configurarlo allí sólo añade tráfico. No lo confunda con el keepalive automático, que se activa 10 segundos después de que un peer reciba datos y no tenga nada propio que enviar. Ese mecanismo siempre está activo y no se puede configurar.
El enrutamiento de la LAN por el túnel no es una función de WireGuard
Supongamos que el peer B está en una red doméstica 192.168.50.0/24 y que el peer A debe acceder a ella. Dos sistemas independientes tienen que estar configurados de forma coherente, y sólo uno de ellos es WireGuard.
La parte de WireGuard: añada 192.168.50.0/24 a AllowedIPs de B en A. Así, A selecciona B para ese prefijo y acepta de B los paquetes que llevan esas direcciones de origen, excepto cuando un prefijo más específico selecciona otro peer. Sin esto, el enrutamiento mediante claves criptográficas no tiene una clave para el destino ni permiso para el origen.
La parte del kernel: en B, net.ipv4.ip_forward debe ser 1; de lo contrario, el kernel descarta todos los paquetes descifrados que no estén dirigidos al propio B. La cadena de reenvío del firewall de B debe permitir el tráfico. Los hosts de la LAN necesitan una ruta de retorno hacia 10.8.0.0/24, o B debe aplicar NAT de origen para que las respuestas regresen a través de B.
La función de WireGuard termina cuando entrega el paquete descifrado al kernel. Todo lo que ocurre después corresponde al enrutamiento y filtrado normales de Linux. Por eso este fallo aparece en los contadores de nft list ruleset o en ip -s link show wg0, y no en wg show. Si prefiere administrar los peers mediante una interfaz web, ejecutar wg-easy en Docker genera las entradas de los peers, aunque el reenvío sigue dependiendo del kernel del host y de la compatibilidad del firewall. La misma separación se mantiene cuando una capa de coordinación distribuye el prefijo: anunciar una red privada desde un VPS con un router de subred de Tailscale sustituye la edición manual de AllowedIPs en cada peer, pero todavía debe habilitar el reenvío IP en el router; Tailscale administra sus propias reglas de firewall de forma predeterminada.
Por qué WireGuard funciona en el kernel
wg0 es un controlador de dispositivo de red. Los paquetes llegan a él mediante la pila de enrutamiento normal, los trabajadores del kernel los cifran y salen por un socket UDP sin pasar nunca al espacio de usuario. WireGuard se integró en el kernel principal de Linux 5.6 en marzo de 2020. Ubuntu 24.04 y Debian 13 ya lo incluyen, por lo que sólo falta el paquete wireguard-tools.
Usar una interfaz normal tiene consecuencias prácticas. tcpdump -ni wg0 muestra los paquetes internos en texto claro, mientras que tcpdump -ni eth0 udp port 51820 muestra los paquetes externos cifrados. Compararlos permite determinar de inmediato qué dirección presenta el problema. netfilter y la gestión del tráfico tratan wg0 como cualquier otro enlace. Cuando el módulo del kernel no está disponible, por ejemplo en una virtualización de contenedores que comparte el kernel del host, wireguard-go implementa el mismo protocolo en el espacio de usuario mediante un dispositivo TUN. Esto reduce el rendimiento porque cada paquete cruza dos veces el límite entre el kernel y el espacio de usuario.
Lo que WireGuard no protege
El modelo de amenazas es deliberadamente limitado, y un protocolo tan discreto puede generar falsas expectativas. Conviene dejarlo claro.
- No oculta que usa WireGuard. Los mensajes del handshake tienen tamaños fijos, el primer byte indica el tipo de mensaje y el transporte es UDP. La inspección profunda de paquetes lo reconoce fácilmente, y una red que bloquea las VPN puede bloquearlo. La ofuscación se omitió de forma deliberada.
- No oculta el volumen ni el momento del tráfico. Los datos sólo se rellenan hasta un límite de 16 bytes, por lo que un observador sigue viendo cuándo envía datos y aproximadamente cuánto.
- Conserva el último endpoint conocido. El peer con la dirección pública almacena la IP pública actual del otro extremo, y
wg showla muestra. Junto con una dirección del túnel fija en la configuración, esto forma un identificador estable que sigue al usuario entre redes. En su propio VPS esto no supone un problema. También por eso los servicios comerciales añaden una capa sobre el protocolo. - Autentica una clave, no una persona. Quien posee el archivo de clave privada es el peer. Mantenga
/etc/wireguardcon el modo 700 y los archivos de clave con el modo 600. - No existe una lista de revocación ni una fecha de caducidad. El acceso termina cuando elimina la entrada del peer de todos los servidores que la contienen, y las claves estáticas siguen activas hasta que las elimina.
Nada de esto hace que WireGuard sea débil. Lo hace pequeño, y ese es el objetivo: autentica y cifra, y deja la gestión de identidades y la asignación de direcciones en manos de lo que se construya sobre él. Una capa de coordinación del tipo descrito en WireGuard comparado con Tailscale existe precisamente para cubrir esa carencia y utiliza el mismo plano de datos que acaba de leer. Una vez instalada esa capa, la siguiente decisión es quién puede acceder a un servicio que se ejecuta dentro del túnel. Eso es lo que resuelve la elección entre Tailscale serve y funnel para un solo puerto.
FAQ
¿Qué es el enrutamiento mediante claves criptográficas en WireGuard?
El enrutamiento mediante claves criptográficas es la regla que vincula cada paquete con una clave pública. Cada entrada de par incluye una lista de prefijos en AllowedIPs. En las conexiones salientes, WireGuard selecciona el par comparando el destino del paquete con la lista de cada par, empezando por el prefijo más largo. Por tanto, la lista funciona como una tabla de enrutamiento. En las conexiones entrantes, una vez descifrado y autenticado el paquete, una búsqueda del prefijo más largo de su dirección de origen interna debe seleccionar ese mismo par. De lo contrario, el paquete se descarta. Por tanto, la lista también funciona como una lista de control de acceso. WireGuard no tiene una configuración de enrutamiento independiente ni un firewall interno independiente, porque esa misma lista realiza ambas funciones.
¿Necesito PersistentKeepalive en ambos pares?
No. Configúrelo en el lado que está detrás de NAT (traducción de direcciones de red) o de un firewall con seguimiento de estado, que normalmente es el cliente. WireGuard no envía nada mientras está inactivo, por lo que la asignación que permite al extremo remoto llegar a ese par expira, a menudo en menos de un minuto, y el túnel parece estar caído en una dirección. PersistentKeepalive = 25 envía un paquete autenticado vacío cada vez que transcurren 25 segundos sin tráfico autenticado hacia ese par o desde él. Esto mantiene abierta la asignación. Un par con una dirección pública y un puerto UDP abierto no lo necesita.
¿Por qué el ping a través del túnel muestra "Required key not available"?
Porque la dirección de destino no está dentro de ningún AllowedIPs. Por tanto, el enrutamiento mediante claves criptográficas no encontró ninguna clave con la que cifrar el paquete y el kernel rechazó su envío. Ejecute wg show wg0 allowed-ips y compare el resultado con la dirección a la que está haciendo ping. El error similar Destination address required indica un problema diferente: se encontró un par coincidente, pero WireGuard no tiene ningún endpoint para él porque no se configuró ninguno y todavía no ha llegado ningún paquete autenticado desde ese par.
¿Puede un firewall detectar y bloquear WireGuard?
Sí. WireGuard autentica y cifra el tráfico, y no intenta ocultar que es WireGuard. Los mensajes de inicio y respuesta del handshake tienen un tamaño fijo de 148 y 92 bytes, las respuestas de cookie tienen 64 bytes, el primer byte de cada mensaje identifica su tipo y el transporte es UDP. Por tanto, la inspección profunda de paquetes identifica el protocolo sin dificultad. Las redes que bloquean UDP o identifican protocolos mediante huellas digitales lo detendrán. Ocultar el túnel requiere encapsularlo en otra cosa. Esto necesita una herramienta independiente, no una configuración de WireGuard.