MirrorNest
← Todos os guias

Headscale

Headscale is an open-source, self-hosted implementation of the Tailscale coordination server, letting you run your own private WireGuard-based mesh network without Tailscale's SaaS control plane.

Destino: Debian 12+ / Ubuntu 22.04+NetworkingVPNSite oficial ↗Documentação oficial ↗
Este guia foi elaborado a partir da documentação oficial do Headscale, ligada acima — verifique sempre lá os nomes exatos dos pacotes/versões antes de executar estes comandos num servidor de produção, uma vez que as versões da distribuição e do projeto mudam com o tempo.

  1. 1Download the official .deb package

    HEADSCALE_VERSION="0.23.0" # set to the version you want
    HEADSCALE_ARCH="amd64"
    wget --output-document=headscale.deb "https://github.com/juanfont/headscale/releases/download/v${HEADSCALE_VERSION}/headscale_${HEADSCALE_VERSION}_linux_${HEADSCALE_ARCH}.deb"

    Check the releases page for the current version number before running this.

    Headscale releases ↗

  2. 2Install the package

    The .deb package creates a dedicated headscale user, default config, and a systemd unit for you.

    sudo apt install ./headscale.deb

  3. 3Configure and start headscale

    sudo nano /etc/headscale/config.yaml
    sudo systemctl restart headscale
    sudo systemctl status headscale