Como configurar o Tailscale para acessar o Home Assistant remotamente

Se você já tem o Home Assistant rodando em casa e quer controlar luzes, portões ou climatização mesmo quando estiver fora, o Tailscale oferece uma forma simples e segura de fazer isso. Diferença grande em relação a soluções como o Cloudflare Tunnel: não é necessário registrar um domínio nem configurar proxies complexos – tudo acontece automaticamente dentro da sua tailnet.

Pré‑requisitos

• Home Assistant instalado e acessível via navegador na rede local.
• Uma conta gratuita no Tailscale (plano Personal já permite até seis usuários e dispositivos ilimitados).
• Permissão para instalar add‑ons nas Configurações do Home Assistant.

1. Instalar os add‑ons necessários

1. No painel do Home Assistant, vá em Settings → Apps (antigo Add‑ons).
2. Clique em Install App no canto inferior direito.
3. Pesquise por Tailscale, selecione o add‑on mantido por Frenck e clique em Install.
4. Repita o processo para o Studio Code Server (também mantido por Frenck). Esse add‑on será usado para editar o configuration.yaml.

2. Iniciar o Tailscale e conectar ao seu tailnet

1. Still inside Apps, abra o add‑on Tailscale e escolha Info → Start. Ative também as opções Watchdog e Auto update para manter o serviço sempre atualizado.
2. Acesse o painel web do Tailscale (login.tailscale.com/admin) e, na seção DNS, clique em Rename tailnet. Escolha um nome fácil de lembrar, algo que contenha “tail” e “scores” seguido de .ts.net. Enquanto estiver aqui, verifique se MagicDNS e HTTPS Certificates estão ativados.
3. Volte ao add‑on Tailscale no Home Assistant e clique em Open Web UI. Você será redirecionado para uma página de login; autorize o pop‑up se o navegador bloquear e selecione seu tailnet. Após a mensagem “Login successful”, o dispositivo aparecerá na lista de máquinas do console Tailscale com um ponto verde.

3. Preparar o Home Assistant para usar o Tailscale Serve

Para que o endereço da sua instância fique disponível através da MagicDNS, é preciso acrescentar algumas linhas ao configuration.yaml.

1. No menu Apps, inicie o Studio Code Server. Aguarde alguns instantes até que a interface carregue.
2. No painel lateral, abra o arquivo configuration.yaml (geralmente localizado na raiz da configuração).
3. Role até o final do arquivo e cole o bloco abaixo exatamente como está (respeitando a indentação de dois espaços):

http:
   use_x_forwarded_for: true
   trusted_proxies:
      – 127.0.0.1

Salve o arquivo.

Agora reinicie o Home Assistant para que as alterações tenham efeito:

1. Volte a Settings → System → Restart (clique nos três pontos no canto superior direito e escolha Restart Home Assistant).
2. Repita o reinício mais uma vez – isso garante que o add‑on Tailscale seja reconhecido após a mudança de configuração.

4. Ativar o Tailscale Serve

1. Novamente em Apps, abra o Tailscale e vá até a opção Share Home Assistant with Serve or Funnel.
2. Selecione Serve (não escolha Funnel, pois este último expõe sua instância à internet pública).
3. Depois de ativado, o console do Tailscale mostrará um endereço semelhante a https://homeassistant.seunome.ts.net. Esse é o seu acesso remoto.
4. Copie esse link e cole em qualquer navegador (no celular, laptop ou tablet) enquanto estiver conectado à sua tailnet pelo aplicativo Tailscale. Após um breve handshake de certificados, a interface do Home Assistant será carregada exatamente como se você estivesse na rede local.

5. (Opcional) Usar o Home Assistant como nó de saída ou roteador de sub‑rede

Se o seu aparelho que roda o Home Assistant fica ligado 24 h, você pode aproveitar dois recursos avançados do Tailscale:

• Advertise as exit node: ative essa chave no add‑on Tailscale para rotear todo o tráfego de seus dispositivos através da sua casa, útil ao viajar e precisar acessar serviços com restrição geográfica.
• Advertise subnet routes: permite que dispositivos que não rodam Tailscale (como lâmpadas ESPHome, TVs inteligentes ou cafeteiras) sejam acessíveis de qualquer ponto da tailnet, pois o Home Assistant anuncia a faixa de IP da sua rede local.

Essas opções ficam na mesma tela de configuração do add‑on, bastando marcar as caixas desejadas e salvar.

Considerações finais

Com poucos cliques você já tem um túnel criptografado que deixa sua automação residencial acessível de forma segura, sem abrir portas no roteador ou comprar domínios. O plano gratuito do Tailscale é suficiente para a maioria dos lares, oferecendo até seis usuários e dispositivos ilimitados. Se quiser apoiar o desenvolvimento do Home Assistant, vale lembrar que o projeto também oferece o Nabu Casa, que traz integrações pronta‑uso com assistentes de voz e backups na nuvem.

Pronto! Agora você pode abrir a porta da garagem, aquecer a água do chuveiro ou checar câmeras de segurança de qualquer lugar, sabendo que apenas os dispositivos autorizados na sua tailnet conseguem chegar ao seu Home Assistant.

Veja mais aqui.