MirrorNest
← Todas las guías

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.

Sistema: Debian 12+ / Ubuntu 22.04+NetworkingVPNSitio oficial ↗Documentación oficial ↗
Esta guía se elaboró a partir de la documentación oficial de Headscale, enlazada arriba — verifica siempre ahí los nombres exactos de paquetes/versiones antes de ejecutar estos comandos en un servidor de producción, ya que las versiones de la distribución y del proyecto cambian con el tiempo.

  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