Variáveis de ambiente do Tailscale
31 variáveis em 8 categorias
Todas as variáveis estão nesta página, agrupadas por categoria, com tipo, valor padrão, valores aceitos, situação e fonte oficial.A lista sai da documentação e do código do Tailscale, conferidos em 12 de novembro de 2026.
- Versão de referência
- v1.104.7
Argumentos extras
Argumentos extras repassados ao tailscaled.
- Tipo
- Texto
- Padrão
- sem padrão
Argumentos extras repassados ao tailscale up, como --advertise-exit-node ou --ssh.
- Tipo
- Texto
- Padrão
- sem padrão
Autenticação e login
Chave de autenticação usada no login do nó. Também aceita o nome TS_AUTH_KEY. Quando o valor começa com file:, a chave é lida de um arquivo.
- Tipo
- Segredo
- Padrão
- sem padrão
ID do cliente OAuth. Pode ser usado sozinho, quando o provedor gera o ID token automaticamente, ou junto de TS_CLIENT_SECRET ou TS_ID_TOKEN.
- Tipo
- Texto
- Padrão
- sem padrão
Segredo do cliente OAuth usado para gerar chaves de autenticação. Quando o valor começa com file:, o segredo é lido de um arquivo.
- Tipo
- Segredo
- Padrão
- sem padrão
ID token do provedor de identidade para federação de identidade de carga de trabalho. Exige TS_CLIENT_ID.
- Tipo
- Segredo
- Padrão
- sem padrão
Audiência usada ao solicitar um ID token a um provedor de identidade conhecido, para troca com o servidor de controle. Exige
TS_CLIENT_ID.- Tipo
- Texto
- Padrão
- sem padrão
Com
true, o containerboot só faz login quando o nó ainda não está autenticado. Comfalse, o padrão, o login acontece a cada início do container.- Tipo
- Booleano
- Padrão
false
Estado, socket e configuração
Diretório onde o tailscaled guarda o estado. O conteúdo precisa persistir entre reinícios do container. Corresponde a
tailscaled --statedir=.- Tipo
- Texto
- Padrão
- sem padrão
Nome do Secret do Kubernetes onde o estado do tailscaled é guardado. No Kubernetes, o padrão é
tailscale. Um valor vazio desativa o uso de Secret.- Tipo
- Texto
- Padrão
tailscale
Caminho do socket LocalAPI do tailscaled. O padrão na imagem é /tmp/tailscaled.sock.
- Tipo
- Texto
- Padrão
/tmp/tailscaled.sock
Diretório com o arquivo de configuração do tailscaled no formato cap-<capacidade>.hujson. Quando definido, o containerboot só inicia o tailscaled com --config e não executa tailscale up nem tailscale set. Não pode ser usado com TS_HOSTNAME, TS_EXTRA_ARGS, TS_AUTHKEY, TS_CLIENT_ID, TS_CLIENT_SECRET, TS_ID_TOKEN, TS_ROUTES, TS_ACCEPT_DNS ou TS_AUDIENCE.
- Tipo
- Texto
- Padrão
- sem padrão
Kubernetes
Com
true, em um proxy de ingress L7 criado pelo operador do Kubernetes, o containerboot cria regras para encaminhar o tráfego do cluster recebido no IP do Pod até o destino do ingress. O uso é restrito ao operador.- Tipo
- Booleano
- Padrão
false
Com true, configura a interface de rede padrão para melhor desempenho em roteador de sub-rede ou nó de saída. Não funciona com TS_USERSPACE.
- Tipo
- Booleano
- Padrão
false
Proxy e encaminhamento
Encaminha todo o tráfego recebido pelo Tailscale para o IP informado. Não funciona com TS_USERSPACE.
- Tipo
- Texto
- Padrão
- sem padrão
Encaminha todo o tráfego recebido pelo Tailscale para o nome DNS informado, resolvido periodicamente. Voltada ao operador do Kubernetes, para Services do tipo ExternalName. Não funciona com TS_USERSPACE.
- Tipo
- Texto
- Padrão
- sem padrão
Encaminha todo o tráfego não originado no Tailscale para o IP informado, normalmente um IP do tailnet. Não funciona com TS_USERSPACE.
- Tipo
- Texto
- Padrão
- sem padrão
Encaminha todo o tráfego não originado no Tailscale para o nome MagicDNS informado. Não funciona com TS_USERSPACE.
- Tipo
- Texto
- Padrão
- sem padrão
Endereço onde o container escuta um proxy SOCKS5 para o tailnet. Corresponde a
tailscaled --socks5-server=.- Tipo
- Texto
- Padrão
- sem padrão
Endereço onde o container escuta um proxy HTTP para o tailnet. Corresponde a
tailscaled --outbound-http-proxy-listen=.- Tipo
- Texto
- Padrão
- sem padrão
Rede e roteamento
Hostname solicitado para o nó no tailnet.
- Tipo
- Texto
- Padrão
- sem padrão
Rotas de sub-rede anunciadas, separadas por vírgula. Um valor vazio faz o containerboot parar de anunciar rotas anteriores. Para aceitar rotas de outros nós, use TS_EXTRA_ARGS com --accept-routes.
- Tipo
- Lista
- Padrão
- sem padrão
Com
true, o padrão, o tailscaled usa rede em espaço de usuário. Comfalse, usa a rede do kernel e exige/dev/net/tune capacidades adicionais.- Tipo
- Booleano
- Padrão
true
Define se o container usa a configuração de DNS do tailnet.
- Tipo
- Booleano
- Padrão
- sem padrão
Saúde, métricas e inicialização
Com true, publica /metrics no endereço definido em TS_LOCAL_ADDR_PORT.
- Tipo
- Booleano
- Padrão
false
Com true, publica /healthz no endereço definido em TS_LOCAL_ADDR_PORT. A resposta é 200 quando o nó tem ao menos um IP do tailnet e 503 caso contrário.
- Tipo
- Booleano
- Padrão
false
Endereço e porta dos endpoints locais de métricas e de saúde, no formato [endereço]:porta. O padrão [::]:9002 atende em todas as interfaces.
- Tipo
- Texto
- Padrão
[::]:9002
Endereço e porta da verificação de saúde no formato antigo. Está defasada: use TS_ENABLE_HEALTH_CHECK com TS_LOCAL_ADDR_PORT. O código ainda aceita o valor.
Substituída por TS_ENABLE_HEALTH_CHECK com TS_LOCAL_ADDR_PORT. O código do containerboot ainda aceita o valor.
- Tipo
- Texto
- Padrão
- sem padrão
Tempo máximo de espera pela primeira map response do servidor de controle durante a inicialização. Aceita durações do Go, como
90sou3m. O padrão é60s.- Tipo
- Texto
- Padrão
60s
Serve, Funnel e serviços
Caminho do arquivo com a configuração de Serve e Funnel, aplicada depois que o tailscaled sobe. O marcador
${TS_CERT_DOMAIN}é trocado pelo FQDN disponível. O containerboot observa o arquivo e reaplica as mudanças. Não pode ser usado comTS_DEST_IP.- Tipo
- Texto
- Padrão
- sem padrão
Com
true, o padrão, o containerboot anuncia os serviços definidos na configuração de Serve quando não roda no Kubernetes. No encerramento, ele retira o anúncio desses serviços. Definafalsepara configurar o anúncio manualmente.- Tipo
- Booleano
- Padrão
true
Uma VPS para desenvolver com agentes
Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.
Link de parceiro da Promovaweb.