¿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.

            🚀 Por qué importan las últimas versiones: Headscale evoluciona junto con el protocolo de Tailscale, añadiendo soporte para nuevas funciones de cliente, mejoras en las ACL y correcciones de estabilidad. Ejecutar la última versión te mantiene compatible con los clientes actuales 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 debian.griffo.io

Paso 1: Agregar repositorio

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
sudo apt update
                

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
apt update
                

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 debian.griffo.io?

📊 Comparación de repositorios:

Debian oficial: A menudo meses por detrás, sin las últimas funciones
debian.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 debian.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

            🎯 Perfecto para: Autoalojadores y organizaciones que quieren una VPN mesh privada y segura usando los clientes de Tailscale, pero con control total sobre el servidor de coordinación y sus datos.
        

💝 Apoyar este proyecto

¡Si este repositorio te ahorra tiempo y esfuerzo, considera apoyarlo!

⭐ Dar estrella en GitHub 🐦 Compartir en Twitter

🕸️ Instalar la última versión de Headscale en Debian