Repolode
Enviar
juanfont

juanfont/headscale

Implementación open source y autohospedada del servidor de control de Tailscale para crear tu propia red mesh basada en WireGuard.

Alternativa open source a:Tailscale

Ver en GitHub
Estrellas
44,970
Forks
2,614
Issues abiertos
135
Último commit
hace 16 horas

¿Qué es?

Tailscale es una VPN basada en WireGuard que conecta dispositivos en una red superpuesta mediante NAT traversal. Su servidor de control gestiona el intercambio de claves públicas de WireGuard entre nodos, asigna direcciones IP a los clientes, establece límites entre usuarios, permite compartir máquinas y distribuye las rutas anunciadas. Headscale es una reimplementación open source y autohospedada de ese servidor de control, para que puedas ejecutar por tu cuenta la capa de coordinación en lugar de depender del servicio alojado de Tailscale.

Headscale está pensado para un único tailnet, adecuado para uso personal o una organización pequeña, no para cubrir todo el alcance del servicio comercial. Es posible configurar los clientes oficiales de Tailscale para que se conecten a una instancia de headscale. El proyecto está escrito en Go y su documentación describe los sistemas operativos cliente y las funciones compatibles.

El proyecto no está afiliado a Tailscale Inc. Su desarrollo se guía por la comunidad interesada en el autohospedaje y el uso por aficionados, y el repositorio incluye un módulo de NixOS y compilaciones de desarrollo de la rama main.

Funciones clave

  • 01Implementa el servidor de control de Tailscale para coordinar nodos WireGuard
  • 02Asigna direcciones IP y gestiona los límites entre usuarios
  • 03Permite compartir máquinas y anunciar rutas entre nodos
  • 04Ofrece un módulo de NixOS y compilaciones para contenedores y binarios

Casos de uso

  • Crear una red mesh privada para un homelab o dispositivos personales
  • Proporcionar un tailnet autohospedado a un equipo pequeño de código abierto
  • Mantener el servidor de coordinación bajo tu propio control en lugar de usar un servicio alojado

Inicio rápido

  1. 1

    Clona el repositorio

  2. 2

    Entra en el shell de desarrollo de Nix (recomendado)

    nix develop
  3. 3

    Ejecuta la suite de pruebas

    make test
  4. 4

    Compila el programa

    make build

Antes de usarlo

  • El README no ofrece soporte para ejecutar Headscale detrás de proxies inversos ni en contenedores.
  • Para operar un servidor de control, se necesita configurar un cliente compatible con Tailscale y encargarse del alojamiento propio.

En colecciones

Apps autoalojadas

Temas

#tailscale#wireguard#vpn#self-hosted#networking#go#tailscale-control-server#tailscale-server

Preguntas frecuentes

¿Qué es headscale?
Implementación open source y autohospedada del servidor de control de Tailscale para crear tu propia red mesh basada en WireGuard. Tailscale es una VPN basada en WireGuard que conecta dispositivos en una red superpuesta mediante NAT traversal. Su servidor de control gestiona el intercambio de claves públicas de WireGuard entre nodos, asigna direcciones IP a los clientes, establece límites entre usuarios, permite compartir máquinas y distribuye las rutas anunciadas. Headscale es una reimplementación open source y autohospedada de ese servidor de control, para que puedas ejecutar por tu cuenta la capa de coordinación en lugar de depender del servicio alojado de Tailscale.
¿headscale es gratuito? ¿Qué licencia tiene?
headscale es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿headscale sigue mantenido?
Mantenimiento activo. El último commit de headscale fue el 24 oct 2026.
¿Para qué puedo usar headscale?
Crear una red mesh privada para un homelab o dispositivos personales Proporcionar un tailnet autohospedado a un equipo pequeño de código abierto Mantener el servidor de coordinación bajo tu propio control en lugar de usar un servicio alojado
¿Cómo se instala headscale?
Clona el repositorio Entra en el shell de desarrollo de Nix (recomendado): nix develop Ejecuta la suite de pruebas: make test Compila el programa: make build
¿Dónde consigo headscale?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/juanfont/headscale

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados