Repolode
Enviar
juanfont

juanfont/headscale

Implementação open source e self-hosted do servidor de controle do Tailscale para criar sua própria rede mesh baseada em WireGuard.

Alternativa open source a:Tailscale

Ver no GitHub
Estrelas
44,970
Forks
2,614
Issues abertas
135
Último commit
há 16 horas

O que é?

O Tailscale é uma VPN baseada em WireGuard que conecta dispositivos em uma rede overlay usando travessia de NAT. O servidor de controle gerencia a troca de chaves públicas do WireGuard entre os nós, atribui endereços IP aos clientes, impõe limites entre usuários, permite compartilhar máquinas e distribui rotas anunciadas. O Headscale é uma reimplementação open source e self-hosted desse servidor de controle, permitindo que você execute a camada de coordenação por conta própria em vez de depender do serviço hospedado do Tailscale.

O Headscale foi projetado para um único tailnet, adequado ao uso pessoal ou a uma pequena organização, e não para cobrir todo o escopo do serviço comercial. É possível configurar os clientes oficiais do Tailscale para usar uma instância do headscale. O projeto é escrito em Go, e a documentação descreve os sistemas operacionais e recursos compatíveis com os clientes.

O projeto não tem afiliação com a Tailscale Inc. Seu desenvolvimento é orientado pela comunidade de entusiastas e usuários de self-hosting, e o repositório inclui um módulo NixOS e builds de desenvolvimento da branch principal.

Recursos principais

  • 01Implementa o servidor de controle do Tailscale para coordenar nós WireGuard
  • 02Atribui endereços IP e gerencia limites entre usuários
  • 03Permite compartilhar máquinas e anunciar rotas entre nós
  • 04Disponibiliza um módulo NixOS e builds de contêiner e binários

Casos de uso

  • Executar uma rede mesh privada para um homelab ou dispositivos pessoais
  • Disponibilizar um tailnet self-hosted para uma pequena equipe open source
  • Manter o servidor de coordenação sob seu próprio controle em vez de usar um serviço hospedado

Início rápido

  1. 1

    Clone o repositório

  2. 2

    Entre no shell de desenvolvimento do Nix (recomendado)

    nix develop
  3. 3

    Execute a suíte de testes

    make test
  4. 4

    Compile o programa

    make build

Antes de usar

  • O README não oferece suporte à execução do Headscale atrás de proxies reversos nem em contêineres.
  • Para operar um servidor de controle, é necessário configurar um cliente compatível com Tailscale e cuidar da hospedagem própria.

Em coleções

Apps auto-hospedados

Tópicos

#tailscale#wireguard#vpn#self-hosted#networking#go#tailscale-control-server#tailscale-server

Perguntas frequentes

O que é headscale?
Implementação open source e self-hosted do servidor de controle do Tailscale para criar sua própria rede mesh baseada em WireGuard. O Tailscale é uma VPN baseada em WireGuard que conecta dispositivos em uma rede overlay usando travessia de NAT. O servidor de controle gerencia a troca de chaves públicas do WireGuard entre os nós, atribui endereços IP aos clientes, impõe limites entre usuários, permite compartilhar máquinas e distribui rotas anunciadas. O Headscale é uma reimplementação open source e self-hosted desse servidor de controle, permitindo que você execute a camada de coordenação por conta própria em vez de depender do serviço hospedado do Tailscale.
headscale é gratuito? Qual é a licença?
headscale é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
headscale ainda é mantido?
Manutenção ativa. O último commit de headscale foi em 24 de out. de 2026.
Para que posso usar headscale?
Executar uma rede mesh privada para um homelab ou dispositivos pessoais Disponibilizar um tailnet self-hosted para uma pequena equipe open source Manter o servidor de coordenação sob seu próprio controle em vez de usar um serviço hospedado
Como instalar headscale?
Clone o repositório Entre no shell de desenvolvimento do Nix (recomendado): nix develop Execute a suíte de testes: make test Compile o programa: make build
Onde consigo headscale?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/juanfont/headscale

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados