headscale
headscale es una implementación open source y auto-alojada del servidor de control de Tailscale. Construido sobre FreeBSD 15, permite crear redes privadas seguras mediante malla maestra-maestro sin necesidad de un servidor centralizado tradicional. Soporta despliegues nativos en Podman, AppJail, Bas
Ficha actualizada 27 sept 2026, 20:39 · upstream 27 sept 2026, 20:35 · release sin release detectada
Qué es headscale
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
headscale actúa como el servidor de control para Tailscale, permitiendo a los usuarios crear redes privadas seguras (mesh networks) sin depender de servidores centralizados comerciales. Se basa en FreeBSD 15, lo que aporta estabilidad y rendimiento optimizado para entornos de red distribuidos. Su arquitectura permite la conexión directa entre nodos mediante un servidor DERP embebido, mejorando la latencia y la privacidad.
- Crear redes privadas seguras para acceso remoto a servidores locales sin abrir puertos en el router tradicional.
- Implementar una infraestructura de red maestra-maestro (mesh) descentralizada para múltiples nodos en diferentes ubicaciones.
- Automatizar despliegues en entornos FreeBSD o contenerizados usando Podman, AppJail, Bastille y Ansible.
- Proveer un servidor DERP (Direct RSTP) embebido para mejorar la latencia en conexiones P2P sin componentes externos.
- Gestionar permisos de usuario y grupo mediante variables de entorno (PUID/PGID) en entornos Linux o FreeBSD.
- Base FreeBSD 15: Aporta estabilidad y rendimiento optimizado para redes con arquitectura amd64.
- Multiplataforma: Soporte nativo para despliegues en Podman, AppJail, Bastille y Ansible.
- Auto-alojado: No requiere dependencias de servidores centralizados comerciales ni licencias propietarias.
- Puertos embebidos: Incluye servidor DERP STUN en el puerto 3478 sin necesidad de componentes externos adicionales.
- Configuración flexible: Variables de entorno para UID/GID y zona horaria integradas para gestión de permisos.
- Dependencia de FreeBSD: La imagen oficial está basada en FreeBSD, lo que puede complicar la integración en entornos Linux puros sin capas de compatibilidad.
- Exposición de puertos: En AppJail y Bastille, exponer los puertos 8080/3478 requiere precauciones de seguridad adicionales para evitar accesos no deseados desde hosts remotos.
- Soporte experimental: La implementación en Bastille se marca explícitamente como experimental según la documentación oficial.
- Gestión de volúmenes: Los volúmenes deben montarse manualmente o mediante scripts, ya que no hay un Dockerfile estándar disponible.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendaciones: Usar la etiqueta 'latest' para usuarios generales. Configurar volúmenes de configuración persistentes antes de iniciar. En AppJail y Bastille, evitar exponer puertos si no es necesario para mantener el aislamiento de red. Verificar que los puertos 8080 (TCP) y 3478 (UDP) estén abiertos en el firewall. Asegurar compatibilidad con la arquitectura amd64.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.