Headplane Hosting
Headplane è una console admin del browser per un server Headscale esistente, utilizzata per gestire utenti, nodi e record DNS aggiuntivi.
- Un clic distribuisci
- 15 GB Spazio su disco necessario
- 1 GB di RAM Memoria necessaria
- Da 2 € Prezzo

Link ufficiali
I link ufficiali e il sito web originale di Headplane
Cosa ottieni
su AvaHost
Il deployment con un clic, un dominio personalizzato, HTTPS gratuito, aggiornamenti automatici dell'applicazione e backup programmati sono inclusi con ogni Cloud App. Puoi eseguire più app su un server e l'accesso al terminale è incluso.
Questo template non include un contenitore di database.

Tecnologia
- Immagine Docker
- ghcr.io/tale/headplane:latest
- Porta predefinita
- 0

Come funziona Headplane
Headplane è un'interfaccia di amministrazione web per Headscale, dal progetto tale. La guida Docker dice di eseguirlo con Headscale in Docker, immagine ghcr.io/tale/headplane. Monti una configurazione Headplane, una directory di dati e il file di configurazione Headscale che l'interfaccia utente è autorizzata a leggere. Alcune funzionalità, inclusa la gestione della rete, richiedono il percorso di configurazione Headscale condiviso e, nell'esempio documentato, accesso in lettura al socket Docker sulla stessa macchina. L'interfaccia utente viene servita sotto /admin, spesso sullo stesso hostname di Headscale, con un reverse proxy che invia quel percorso alla porta 3000 di Headplane e tutto il resto a Headscale.
È richiesto Headscale 0.26.0 o successivo. Se quel server manca, Headplane non ha nulla da amministrare. Non registra i client Tailscale e non sostituisce l'URL di coordinamento che quei client utilizzano. SQLite o PostgreSQL per la tailnet rimangono all'interno di Headscale. Headplane mantiene i suoi piccoli dati, incluso il materiale di sessione derivato dal segreto del cookie che imposti.
Funzionalità chiave di Headplane
Dal browser puoi lavorare con utenti, nodi e record DNS extra quando quei file sono montati dove la configurazione specifica. Il segreto del cookie deve essere casuale e archiviato, perché blocca le sessioni. Una configurazione di esempio viene fornita con il progetto. I campi interessanti sono headscale.url, il segreto del cookie e i percorsi ai file Headscale. Punta headscale.url all'indirizzo all'interno di Docker quando entrambi i container condividono una rete, non a un URL che il browser utilizza.
AvaHost aggiorna Headplane automaticamente e esegue il backup della sua directory di dati secondo una pianificazione. Quel backup non è un backup di Headscale. Un indirizzo IP pubblico dedicato non è richiesto per Headplane stesso. Metti l'indirizzo pubblico sull'app Headscale. La posta dell'applicazione non è inclusa con Headplane. L'accesso al socket Docker è potente. Abilita solo l'integrazione che descrive la guida upstream e tratta quel socket come accesso amministrativo ai container dell'host.

Self-hosting Headplane: requisiti e costi
La base è 512 MB di RAM e mezzo core CPU, immagine ghcr.io/tale/headplane, nessun database proprio. Su AvaHost il minimo consigliato per Headplane è Plan 1 a €2. Il pacchetto include distribuzione con un clic, un hostname o un percorso sull'hostname Headscale, HTTPS automatico, aggiornamenti automatici e backup pianificati dei dati Headplane. Devi già avere Headscale 0.26 o più recente. Questa app non include quel server e non include un indirizzo IP pubblico dedicato.
Chi usa Headplane
Le persone che hanno già deciso per Headscale e vogliono una console come quella che Tailscale fornisce, sotto /admin, usano Headplane. È l'acquisto iniziale sbagliato se Headscale non è in esecuzione. È anche il pacchetto sbagliato se sei soddisfatto della CLI Headscale e non vuoi un altro servizio montato sugli stessi file di configurazione.
F.A.Q
Headplane inizia a €2 nel Piano 1. Il prezzo è per l’interfaccia admin, non per Headscale e non per un indirizzo dedicato per i client. Se Headscale è ospitato anche qui, è un’app separata con il suo proprio piano. L’interfaccia è leggera. La maggior parte della conversazione sulla capacità riguarda il server di coordinamento e DERP, non questo container.
Sì. La configurazione tipica prevede un unico hostname: Headscale sulla root, Headplane sotto /admin, con HTTPS automatico su quel nome. Il proxy deve inviare /admin a questa app e gli altri percorsi a Headscale. Puoi anche utilizzare un hostname separato. Il DNS rimane tuo. I client devono comunque essere configurati con l’URL di Headscale, non con il percorso /admin.
AvaHost aggiorna Headplane automaticamente e ne esegue il backup dei dati secondo una pianificazione. Il database di Headscale non è incluso in quel backup. Dopo un aggiornamento, accedi a /admin e verifica che l’elenco dei nodi si carichi ancora correttamente. Conserva il cookie secret e i percorsi di configurazione montati annotati, perché un mount errato appare come un server vuoto.
No. Upstream richiede Headscale 0.26 o versione successiva, e l’interfaccia modifica solo quel server. Ordinare Headplane da solo non crea una tailnet. Distribuisci prima Headscale, oppure distribuisci entrambi e punta Headplane verso di esso. I client Tailscale ignorano Headplane. Comunicano con Headscale.
