Headplane Hosting
Headplane es una consola de administración de navegador para un servidor Headscale existente, utilizada para gestionar usuarios, nodos y registros DNS adicionales.
- Un clic desplegar
- 15 GB Espacio en disco necesario
- 1 GB de RAM Memoria necesaria
- Desde 2 € Precio

Enlaces oficiales
Los enlaces oficiales y el sitio web original de Headplane
Lo que obtienes
en AvaHost
El despliegue con un clic, un dominio personalizado, HTTPS gratuito, actualizaciones automáticas de aplicaciones y copias de seguridad programadas vienen con cada aplicación en la nube. Puedes ejecutar múltiples aplicaciones en un servidor, y el acceso a la terminal está incluido.
Esta plantilla no incluye un contenedor de base de datos.

Tecnología
- Imagen de Docker
- ghcr.io/tale/headplane:latest
- Puerto predeterminado
- 0

Cómo funciona Headplane
Headplane es una interfaz web de administración para Headscale, del proyecto tale. La guía de Docker indica ejecutarlo con Headscale en Docker, imagen ghcr.io/tale/headplane. Montas una configuración de Headplane, un directorio de datos y el archivo de configuración de Headscale que la interfaz puede leer. Algunas funciones, incluida la gestión de redes, requieren que la ruta de configuración de Headscale esté compartida y, en el ejemplo documentado, acceso de solo lectura al socket de Docker en la misma máquina. La interfaz se sirve bajo /admin, a menudo en el mismo nombre de host que Headscale, con un proxy inverso enviando esa ruta al puerto 3000 de Headplane y todo lo demás a Headscale.
Se requiere Headscale 0.26.0 o posterior. Si falta ese servidor, Headplane no tiene nada que administrar. No inscribe clientes de Tailscale ni reemplaza la URL de coordinación que esos clientes utilizan. SQLite o PostgreSQL para la tailnet permanecen dentro de Headscale. Headplane mantiene sus propios datos pequeños, incluido el material de sesión derivado del secreto de cookie que estableces.
Características clave de Headplane
Desde el navegador puedes trabajar con usuarios, nodos y registros DNS adicionales cuando esos archivos están montados donde la configuración lo indica. El secreto de cookie debe ser aleatorio y almacenarse, porque bloquea las sesiones. Una configuración de ejemplo se incluye con el proyecto. Los campos interesantes son headscale.url, el secreto de cookie y las rutas a los archivos de Headscale. Apunta headscale.url a la dirección dentro de Docker cuando ambos contenedores comparten una red, no a una URL que use el navegador.
AvaHost actualiza Headplane automáticamente y realiza copias de seguridad de su directorio de datos según un cronograma. Esa copia de seguridad no es una copia de seguridad de Headscale. No se requiere una dirección IP pública dedicada para Headplane en sí. Coloca la dirección pública en la aplicación Headscale. El correo de la aplicación no se incluye con Headplane. El acceso al socket de Docker es poderoso. Solo habilita la integración que describe la guía ascendente y trata ese socket como acceso administrativo a los contenedores del host.

Auto-alojamiento de Headplane: requisitos y costo
La línea base es 512 MB de RAM y medio núcleo de CPU, imagen ghcr.io/tale/headplane, sin base de datos propia. En AvaHost el mínimo recomendado para Headplane es Plan 1 a €2. El paquete incluye implementación de un clic, un nombre de host o una ruta en el nombre de host de Headscale, HTTPS automático, actualizaciones automáticas y copias de seguridad programadas de datos de Headplane. Ya debes tener Headscale 0.26 o más reciente. Esta aplicación no incluye ese servidor ni incluye una dirección IP pública dedicada.
Quién usa Headplane
Las personas que ya decidieron usar Headscale y desean una consola como la que envía Tailscale, bajo /admin, utilizan Headplane. Es la compra incorrecta si Headscale no está en ejecución. También es el paquete incorrecto si estás satisfecho con la CLI de Headscale y no deseas otro servicio montado en los mismos archivos de configuración.
F.A.Q
Headplane comienza en €2 en Plan 1. El precio es la interfaz de administración, no Headscale ni una dirección dedicada para clientes. Si Headscale también se aloja aquí, es una aplicación separada con su propio plan. La interfaz es ligera. La mayor parte de la conversación sobre capacidad pertenece al servidor de coordinación y a DERP, no a este contenedor.
Sí. La configuración habitual es un único hostname: Headscale en la raíz, Headplane bajo /admin, con HTTPS automatizado en ese nombre. El proxy debe enviar /admin a esta aplicación y las otras rutas a Headscale. También puedes usar un hostname separado. DNS sigue siendo tuyo. Los clientes deben seguir configurados con la URL de Headscale, no con la ruta /admin.
AvaHost actualiza Headplane automáticamente y realiza copias de seguridad de sus propios datos según un cronograma. La base de datos de Headscale no está incluida en esa copia de seguridad. Después de una actualización, inicia sesión en /admin y confirma que la lista de nodos se carga correctamente. Guarda la contraseña de la cookie y las rutas de configuración montadas anotadas, porque un montaje incorrecto se parece a un servidor vacío.
No. Upstream requiere Headscale 0.26 o más reciente, y la UI solo edita ese servidor. Ordenar Headplane solo no crea una tailnet. Implementa Headscale primero, o implementa ambos y apunta Headplane hacia él. Los clientes de Tailscale ignoran Headplane. Se comunican con Headscale.
