¿Qué es Headscale?
Headscale es una implementación de código abierto y autoalojada del servidor de control de Tailscale. Te permite ejecutar tu propio servidor de coordinación para una red mesh privada basada en WireGuard, de modo que tus dispositivos puedan conectarse entre sí de forma segura sin depender del plano de control alojado de Tailscale — mientras sigues usando los clientes estándar de Tailscale.
⚡ Características clave de Headscale
🔐 Plano de control autoalojado
Ejecuta tu propio servidor de coordinación — sin depender de un servicio alojado por terceros.
🌐 Malla WireGuard
Conectividad punto a punto rápida y cifrada entre todos tus dispositivos.
📱 Clientes estándar
Funciona con los clientes oficiales de Tailscale en escritorio, móvil y servidores.
📜 Políticas ACL
Reglas de control de acceso granular para segmentar y proteger tu red.
🎯 ¿Por qué Headscale?
- Control total: Eres dueño del servidor de coordinación y de los datos de tu red
- Sin dependencia de proveedor: Alternativa de código abierto al plano de control alojado
- Usa clientes oficiales: Conserva la experiencia pulida de la app de Tailscale
- Ligero: Un único binario de Go fácil de desplegar
🆕 Aspectos destacados
- Servidor de coordinación: Plano de control de Tailscale autoalojado
- WireGuard: Redes mesh modernas y cifradas
- ACL: Control de acceso basado en políticas
- Multiusuario: Espacios de nombres para separar dispositivos y usuarios
📦 Instalación desde deb.griffo.io
Paso 1: Agregar repositorio
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Existe un espejo gratis para siempre. deb-free.griffo.io sirve paquetes gratis para siempre: sin cuenta, sin suscripción, como máximo 2 meses por detrás del upstream, correcciones de seguridad inmediatas. Ahora mismo incluye cliamp, Ghostty, lazydocker, Oh My Posh y Zed; Headscale no está entre ellas, así que hoy el repositorio de arriba es la única forma de instalarlo — pídelo y puede añadirse.
🧩 Sobre la opción extrepo. extrepo es la herramienta propia de Debian para repositorios externos: escribe el archivo de sources e instala la clave de firma por ti, comprobándola antes contra metadatos firmados. Este repositorio está registrado en ella como griffo, y el espejo gratuito para siempre como griffo-free, así que en Debian (bookworm, trixie, forky y sid) los comandos de arriba son toda la configuración.
extrepo solo configura el archivo de sources y la clave: las credenciales de una suscripción siguen yendo en /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu no está cubierto, porque extrepo publica metadatos solo para las suites de Debian: allí usa los comandos con sudo o como root.
Paso 2: Instalar headscale
# Install latest headscale
sudo apt install headscale
# Verify installation
headscale version# Install latest headscale
apt install headscale
# Verify installation
headscale version🎯 Ejemplos básicos de uso
# Show version
headscale version
# Create a user
headscale users create alice
# Generate a pre-auth key for a user
headscale preauthkeys create --user alice --reusable
# List connected nodes
headscale nodes list
# Serve the control server
headscale serve🚀 ¿Por qué elegir deb.griffo.io?
- Debian oficial: A menudo meses por detrás, sin las últimas funciones
- deb.griffo.io: Última versión disponible horas después del lanzamiento
- Instalación manual: Requiere descargas manuales y configuración del PATH
- Nuestro repositorio: Paquetes prediseñados y listos para usar
- ✅ Últimas funciones: Obtén las funciones y mejoras más recientes de Headscale de inmediato
- ✅ Sin configuración manual: Binarios prediseñados, instalados y actualizados mediante apt
- ✅ Actualizaciones automáticas: Paquetes actualizados horas después de los lanzamientos oficiales
- ✅ Dependencias correctas: Correctamente empaquetado con todas las bibliotecas necesarias
- ✅ Multi-distribución: Funciona en Bookworm, Trixie y Sid
- ✅ Mantenimiento sencillo: Comandos apt simples para las actualizaciones
📦 Repositorio de construcción de paquetes
Los paquetes de Debian se construyen y mantienen automáticamente en este repositorio de GitHub:
- 📁 headscale-debian - Latest release builds
🔗 Paquetes relacionados
También disponible desde deb.griffo.io:
- Garage - Almacenamiento de objetos distribuido compatible con S3
- Forgejo - Forja de software ligera y autoalojada
- k9s - Interfaz de terminal para clústeres de Kubernetes
💝 Apoyar este proyecto
¡Si este repositorio te ahorra tiempo y esfuerzo, considera apoyarlo!