headscale-cloudron-app
Paquete oficial para Cloudron que coordina redes privadas compatibles con Tailscale usando Headscale. Incluye persistencia SQLite, autenticación proxy integrada y actualizaciones automáticas desde imágenes públicas de GitHub Container Registry (GHCR) sobre base Alpine 3.24. Optimizado para despliegu
Ficha actualizada 28 sept 2026, 9:44 · upstream 28 sept 2026, 9:42 · release v0.29.4-1
Qué es headscale-cloudron-app
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona un paquete específico para la plataforma Cloudron, facilitando la instalación y gestión de Headscale, el servidor de coordinación compatible con Tailscale basado en WireGuard. La solución integra persistencia de datos mediante SQLite bajo /app/data, protegiendo la interfaz web integrada a través de autenticación proxy de Cloudron y exponiendo opcionalmente un puerto UDP para DERP STUN en 3478.
El sistema incluye una API proxy de solo lectura en el lado del navegador que mantiene el token de API de Headscale en el servidor, mejorando la seguridad. Las imágenes publicadas en GHCR permiten instalaciones directas avanzadas sin credenciales de registro, mientras que un flujo de trabajo GitHub Actions realiza comprobaciones semanales para publicar actualizaciones automáticas cuando cambian las versiones de Headscale, la UI o la imagen base Alpine 3.24.
Los usuarios pueden añadir el URL del almacén de aplicaciones comunitario a Cloudron para instalarlo directamente desde la tienda, o utilizar el comando cloudron install con una imagen específica de GHCR para instalaciones directas. La complejidad es baja, requiriendo aproximadamente 1 GB de RAM y 10 GB de disco, validando que sea adecuado para entornos con recursos limitados pero con necesidades de seguridad robustas en redes privadas.
- Crear una red privada segura para acceso remoto a servidores domésticos o empresariales sin necesidad de NAT traversal complejo.
- Integración sencilla en plataformas Cloudron mediante el almacén de aplicaciones comunitario para gestión centralizada.
- Despliegue directo de imágenes desde GHCR para usuarios avanzados que requieren control total sobre la versión del contenedor.
- Implementación de un servidor de coordinación Tailscale compatible con persistencia local y autenticación proxy integrada.
- Actualización automática de componentes (Headscale, UI, Alpine) mediante flujos de trabajo GitHub Actions sin intervención manual frecuente.
- Persistencia de datos robusta mediante SQLite almacenado en /app/data para evitar pérdida de configuración.
- Autenticación proxy integrada que protege la interfaz web y oculta el token de API del lado del cliente.
- Actualizaciones automáticas semanales desde GitHub Actions que validan metadatos y construyen imágenes nuevas.
- Imágenes públicas en GHCR accesibles sin credenciales para instalaciones directas o actualizaciones manuales.
- Soporte opcional para puerto DERP STUN UDP 3478, mejorando la conectividad de red en entornos restringidos.
- Bajo consumo de recursos con requisitos de 1 núcleo CPU y 1 GB de RAM para funcionamiento estable.
- Instalación estándar dependiente de la plataforma Cloudron, requiriendo su entorno específico para el paquete principal.
- Versión específica de Alpine Linux 3.24 fijada en las imágenes publicadas, limitando actualizaciones del SO base automáticas.
- Almacenamiento SQLite local sin replicación nativa, lo que implica riesgo de pérdida de datos si falla el disco sin backup externo.
- Actualización automática limitada a componentes conocidos; cambios no detectados requieren intervención manual o reempaquetado.
- Puerto UDP 3478 opcional debe configurarse explícitamente para habilitar la funcionalidad DERP STUN completa.
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.
Añadir el URL del almacén de aplicaciones comunitario en Cloudron y buscar "Headscale" en la tienda. Verificar que los puertos HTTP 8080 y UDP 3478 estén abiertos en el firewall. Para instalaciones directas, usar cloudron install con la imagen ghcr.io/jbjardine/headscale-cloudron-app:v0.29.4-1. Monitorizar el flujo de trabajo GitHub Actions para actualizaciones automáticas semanales. Asegurar copias de seguridad periódicas del archivo db.sqlite en /app/data.
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.