Headscale: tu propio servidor de control de Tailscale, sin nube ni límites
Tailscale convierte dispositivos dispersos en una LAN privada cifrada con un par de comandos, y en esta casa ya lo vimos: tu red privada cifrada sin abrir un solo puerto. Pero hay una pieza que sigue viviendo fuera: el plano de control. Es el servidor de Tailscale quien reparte las claves, dice a cada nodo dónde están los demás y gestiona los permisos. Headscale es la misma idea, corriendo en tu VPS.
Qué es Headscale (y qué no es)
Headscale es una reimplementación de código abierto (Go, licencia BSD-3) del servidor de coordinación de Tailscale. No es un cliente VPN ni un sustituto de WireGuard: los túneles siguen siendo WireGuard punto a punto entre tus dispositivos, y los clientes que instalas son las aplicaciones oficiales de Tailscale. Lo único que cambia es a quién le preguntan: en lugar de la nube de Tailscale, a tu servidor.
Ganas tres cosas: no hay límite de dispositivos impuesto por un plan gratuito, no hay cuenta externa que pueda bloquearte el acceso a tu propia red, y los metadatos de tu red no salen de tu infraestructura. El precio es que la disponibilidad de tu red depende de ti: si tu VPS se cae, los túneles ya establecidos siguen funcionando, pero ningún nodo nuevo podrá registrarse hasta que el servidor vuelva.
Requisitos
Un VPS con Debian 12 o superior, o Ubuntu 22.04 o superior (basta 1 vCPU y 1 GB de RAM), un dominio con un registro A apuntando a su IP pública, y clientes Tailscale actualizados: Headscale 0.29 exige clientes 1.80.0 o superiores. La versión estable al escribir este artículo es la 0.29.7; comprueba siempre la página de releases del proyecto antes de instalar.
Instalación en Debian o Ubuntu
El proyecto publica paquetes .deb oficiales. Descarga el de tu versión y arquitectura e instálalo con apt:
HEADSCALE_VERSION="0.29.7"
ARCH="amd64" # o arm64 en una Raspberry Pi o un VPS ARM
wget "https://github.com/juanfont/headscale/releases/download/v${HEADSCALE_VERSION}/headscale_${HEADSCALE_VERSION}_linux_${ARCH}.deb"
sudo apt install ./headscale.deb
headscale version
El paquete crea el usuario de sistema headscale y la unidad de systemd. Por defecto escucha solo en 127.0.0.1:8080: no queda expuesto a internet hasta que tú decidas cómo servirlo.
Configuración mínima
Copia el ejemplo y edita solo lo esencial:
sudo cp /usr/share/doc/headscale/examples/config-example.yaml /etc/headscale/config.yaml
sudo nano /etc/headscale/config.yaml
server_url: https://hs.tudominio.com
listen_addr: 127.0.0.1:8080
metrics_listen_addr: 127.0.0.1:9090
grpc_listen_addr: 127.0.0.1:50443
server_url debe coincidir exactamente con la URL que luego pases a tailscale up, incluido el https://. Para el TLS tienes dos caminos: que el propio Headscale pida y renueve el certificado de Let’s Encrypt (tls_letsencrypt_hostname: hs.tudominio.com, listen_addr: 0.0.0.0:443) o dejarlo en 127.0.0.1:8080 detrás de un proxy inverso con nginx o Caddy. Valida y arranca:
sudo headscale configtest
sudo systemctl enable --now headscale
curl -s https://hs.tudominio.com/health
Si /health responde, el plano de control está vivo. Abre en el cortafuegos el 443/tcp y, solo si activas el DERP integrado, el 3478/udp.
Usuarios y registro de nodos
En Headscale los dispositivos pertenecen a usuarios, simples etiquetas de organización, no cuentas con contraseña. Crea el tuyo y una clave de preautenticación:
sudo headscale users create oscar
sudo headscale preauthkeys create --user oscar
La clave es de un solo uso y caduca en una hora por defecto. En el dispositivo, con el cliente oficial ya instalado:
tailscale up --login-server https://hs.tudominio.com --authkey <clave>
tailscale status
Sin clave, el registro es interactivo: tailscale up --login-server https://hs.tudominio.com muestra un identificador que apruebas con headscale auth register --auth-id <id> --user oscar. Comprueba el alta con headscale nodes list.

DERP, ACL y MagicDNS
Cuando dos nodos no pueden establecer un túnel directo (doble NAT, CGNAT, cortafuegos estrictos), Tailscale releva el tráfico por un servidor DERP. Por defecto Headscale usa el mapa público de relays de Tailscale, así que no tienes que hacer nada. Si quieres cortar también esa dependencia, activa su DERP integrado en config.yaml (sección derp.server) y abre el 3478/udp: todo el tráfico relevado pasará por tu VPS.
El control fino de quién puede hablar con quién vive en un fichero de políticas con el formato ACL de Tailscale: grupos, etiquetas y reglas del tipo “el grupo servidores acepta conexiones del grupo admin por el puerto 22”. Sin fichero de políticas, todo nodo puede hablar con todo nodo, suficiente para una red casera. El DNS mágico (MagicDNS) asigna a cada nodo un nombre dentro de tu dominio base, configurable en la sección dns de config.yaml, para que ssh nas funcione sin recordar IPs del rango 100.64.0.0/10.
Copias de seguridad y actualizaciones
Todo el estado vive en una base SQLite en /var/lib/headscale, junto con /etc/headscale/config.yaml. Copia esos dos directorios y podrás restaurar la red entera en otro VPS. Dos reglas: actualiza siempre de versión menor en versión menor, tomando el último parche de cada una, porque el esquema de la base de datos cambia entre versiones; y no instales el cliente de Tailscale en el propio servidor Headscale, porque interfiere con los routers de subred, los relays y el MagicDNS y es una configuración no soportada. Para vigilar que el servicio no se caiga en silencio, apúntalo en tu monitor habitual: monitoriza tus servicios y recibe avisos antes de que caigan.
Checklist final
| Paso | Qué comprobar |
|---|---|
| Dominio | El registro A resuelve a la IP del VPS |
| Instalación | headscale version muestra la versión instalada |
| Configuración | headscale configtest sin errores y /health responde |
| TLS | Certificado válido en https://hs.tudominio.com |
| Nodos | headscale nodes list muestra todos los dispositivos |
| Conectividad | tailscale ping entre dos nodos sin relays inesperados |
| Copia | /var/lib/headscale y /etc/headscale/config.yaml en tu backup |
Headscale no es para todo el mundo: si tu red son tres dispositivos y no te importa la nube de Tailscale, no lo necesitas. Pero si ya montas tu propio WireGuard site-to-site entre dos VPS y te gusta que la infraestructura crítica sea tuya de verdad, es el paso que faltaba. El plano de control deja de ser un servicio que alquilas para convertirse en un proceso más de tu servidor, con sus copias, sus actualizaciones y sus reglas.