Como instalar o Headscale na Saplo: uma rede privada com clientes Tailscale

O teu computador portátil em casa, o servidor no escritório e o computador de teste de um colega devem funcionar numa única rede privada, embora cada dispositivo utilize uma ligação diferente. O Headscale permite-te gerir uma rede como esta a partir do teu próprio servidor coordenador. Neste guia, vamos mostrar-te como configurar o Headscale na Saplo, ligar os primeiros dispositivos e verificar a comunicação entre eles.

O que é o Headscale

Headscale é uma implementação de código aberto de um servidor de coordenação para clientes Tailscale. Instalas o cliente Tailscale nos teus dispositivos, mas apontas-lhe o teu próprio servidor Headscale. O projeto destina-se principalmente a redes pessoais e pequenas organizações. O âmbito do projeto é descrito na documentação oficial do Headscale.

É uma solução para o administrador de um laboratório doméstico, para um programador que trabalha com várias máquinas ou para uma pequena equipa. Convém começar com dois dos teus próprios dispositivos antes de adicionares o equipamento dos teus colegas e de definires as regras de acesso.

A instalação do Headscale não te dá automaticamente acesso à rede privada de uma Box Saplo. O servidor coordena os dispositivos que tu próprio adicionas a ele. O simples facto de executar a aplicação na Box não faz da Box um participante nesta rede.

Requisitos e alojamento Headscale na Saplo

O plano mais barato que cumpre os requisitos de instalação é o Box S, por 27 € anuais. A receita do Headscale requer um mínimo de 256 MB de RAM e 2 GB de espaço em disco. Se outras aplicações estiverem a ser executadas no Box, verifica também os restantes recursos disponíveis. Podes encontrar uma descrição do serviço na página de alojamento do Headscale na Saplo.

Prepara um Box ativo, o nome da aplicação, o seu endereço de destino e dois dispositivos para tentar a ligação. O Box S fornece um painel e SFTP, mas sem SSH. Podes fazer a instalação a partir do painel e transferir o ficheiro com as instruções iniciais do Catálogo de aplicações via SFTP. Os comandos do cliente Tailscale deste guia devem ser executados no teu computador, não no Box.

Instalação passo a passo

1. Inicia sessão no Painel Saplo e vai para o catálogo de aplicações.
2. Escolhe o Headscale e começa a criar a aplicação.
3. Atribui-lhe um nome, por exemplo my-network, e indica uma Box com recursos disponíveis.
4. Escolhe um Domínio ou um subdomínio disponível *.saploapp.pl. Mantém o endereço exato exibido no painel.
5. Confirma a instalação e espera pela conclusão da implementação. Verifica o Estado e as mensagens da aplicação, em vez de assumires um tempo de espera específico.
6. Conecta-te via SFTP, usando os dados de acesso da tua Box, e encontra o ficheiro HEADSCALE-SETUP.txt no diretório dessa aplicação. Descarrega-o para o teu computador e abre-o como texto.

O instalador prepara o serviço Headscale, uma base de dados SQLite local, a configuração e o utilizador inicial admin. Não é necessário criar uma base de dados separada. O endereço HTTPS é o endereço do servidor coordenador e não um painel de gestão no navegador. Esta instalação não inclui um painel gráfico Headscale separado.

Chave de arranque e primeiro dispositivo

O ficheiro HEADSCALE-SETUP.txt contém o endereço do servidor e o comando de ligação com a chave gerada. A chave de arranque é válida por 24 horas a partir da geração e pode ser usada várias vezes durante este período. Trata o ficheiro inteiro como dados de acesso: não o publiques num repositório ou em capturas de ecrã.

No primeiro computador Linux, instala o cliente a partir do site oficial da Tailscale. Em seguida, executa o comando do ficheiro de arranque no terminal, com as permissões exigidas pelo sistema. O esquema é o seguinte:

sudo tailscale up --login-server=https://YOUR-HEADSCALE-ADDRESS --authkey=KEY-FROM-FILE

Substitui ambos os campos de exemplo pelos teus próprios valores. Não introduzas aqui a palavra-passe do painel da Saplo. A forma de registo com uma chave é descrita na documentação de inicialização do cliente Headscale.

Se o computador já estiver ligado a outra rede Tailscale, planeia a mudança conscientemente. Não utilizes esta forma de mudar a única ligação remota a uma máquina. Para a primeira tentativa, escolhe hardware ao qual tenhas também acesso local.

Se o ficheiro informar que a chave não pôde ser gerada ou que a chave expirou, será necessária uma nova chave criada no Headscale. A Box S não oferece SSH para executar comandos administrativos a partir do ficheiro. Numa situação dessas, entra em contacto com o Suporte da Saplo para obter mais configurações, fornecendo o nome da aplicação e a mensagem, sem enviar a chave. Não elimines uma instalação em funcionamento apenas para repetir o registo do dispositivo.

Segundo dispositivo e verificação de ligação

No segundo computador com Linux, instala o cliente e aponta para o mesmo endereço de servidor. Durante a validade da chave inicial, podes usá-la novamente para esta tentativa. Para Windows, Android e dispositivos Apple, usa as instruções específicas da plataforma na documentação dos clientes Headscale; a forma de apontar o teu próprio servidor depende do sistema.

Em ambos os computadores, verifica o estado do cliente e o endereço atribuído:

tailscale status
tailscale ip -4

Em seguida, no primeiro computador, executa, substituindo o endereço do segundo:

tailscale ping SECOND-DEVICE-ADDRESS

Estes comandos são descritos na documentação CLI Tailscale. Verifica também o serviço específico que pretendes usar, por exemplo, uma ligação SSH ao teu próprio servidor através do seu endereço na rede VPN. O serviço deve estar em execução, e o seu acesso permitido pela firewall e regras de rede. O simples aparecimento do dispositivo na lista não confirma o funcionamento da aplicação.

É aconselhável repetir a tentativa com diferentes ligações à internet, por exemplo, com o segundo computador ligado através do hotspot do telefone. Guarda o resultado e verifica a reconexão após o reinício do cliente.

O que acontece com o tráfego e o acesso

A receita Saplo utiliza o mapa público de retransmissores DERP do Tailscale e não executa o seu próprio DERP. Por isso, um servidor de coordenação próprio não significa que toda a instalação seja independente da infraestrutura Tailscale. Não consideres os parâmetros da Box como uma garantia da largura de banda da ligação entre os dispositivos.

Antes de adicionares uma equipa, planeia utilizadores separados, regras de acesso e como remover dispositivos não utilizados. Um utilizador inicial comum serve para começar a trabalhar, mas não substitui a divisão de permissões pretendida. Mantém uma cópia de segurança segura da configuração e dos dados do Headscale. O ficheiro da chave de arranque não é, por si só, uma cópia de segurança do serviço.

Perguntas Frequentes

Quanto custa o alojamento Headscale?

Para começar, basta o Box S por 27 € anuais. Se partilhares o Box com outras aplicações, tem em conta o consumo de memória e disco de cada uma.

Porque é que não vejo o painel de login no meu domínio?

Esta instalação fornece um servidor de coordenação sem um painel administrativo gráfico. Começa pelo estado da aplicação e pelo ficheiro HEADSCALE-SETUP.txt, e verifica o funcionamento da rede a partir do cliente Tailscale.

Porque é que o dispositivo não se liga?

Compara o endereço do servidor com o ficheiro de arranque, verifica a disponibilidade HTTPS e a validade da chave. Presta atenção se o cliente não está a tentar fazer login no serviço Tailscale predefinido. Guarda o conteúdo do erro, removendo as chaves antes de o encaminhares para o Suporte.

O Headscale substitui o cliente Tailscale?

Não. Nos dispositivos, continuas a usar o cliente Tailscale. O Headscale atua como o teu próprio servidor de coordenação.

É preciso abrir o SSH no Box para começar?

Não para a instalação a partir do catálogo e para a primeira ligação usando uma chave gerada corretamente. A gestão posterior de utilizadores, chaves e políticas de acesso requer ações administrativas do lado do Headscale. Considera isto ao planeares o uso permanente do serviço no Box S sem SSH.

Abre a oferta Headscale na Saplo, inicia a aplicação e começa por ligar dois dos teus próprios dispositivos. Só depois de verificares a comunicação e as regras de acesso é que deves adicionar outras máquinas.