MirrorNest
← Tous les guides

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.

Système : Debian 12+ / Ubuntu 22.04+NetworkingVPNSite officiel ↗Documentation officielle ↗
Ce guide est élaboré à partir de la documentation officielle de Headscale, dont le lien figure ci-dessus — vérifiez toujours les noms exacts des paquets/versions avant d'exécuter ces commandes sur un serveur de production, car les versions de la distribution et du projet évoluent avec le temps.

  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