Referência da CLI

Um único binário, addtothese, é tudo de que você precisa: fazer login, abrir túneis e encaminhar portas TCP. Seu login fica salvo em ~/.addtothese/config.yaml (%USERPROFILE%\.addtothese\config.yaml no Windows).

addtothese login

addtothese login --token att_...

Salva um token de API. Sem --token, pede o token pela entrada padrão. addtothese logout o esquece.

addtothese http

addtothese http <port|host:port|url> [--subdomain name]

Expõe um serviço HTTP local. Sem --subdomain, você recebe um endpoint aleatório. Com ele, o túnel usa um nome que você reservou no painel. A CLI se reconecta sozinha após quedas de rede e renova suas credenciais antes que expirem.

OpçãoPadrãoSignificado
--subdomainaleatórioNome reservado a usar
--timeout10sTempo limite ao encaminhar cada requisição para o seu serviço
--access-logtrueExibe cada requisição que passa pelo proxy
--log-levelwarndebug, info, warn ou error

Proteja uma URL com códigos por e-mail

addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'

Só as pessoas da sua lista podem abrir a URL. O visitante informa o e-mail; se ele estiver na lista, recebe um código de 6 dígitos, válido por 10 minutos, e continua conectado por 24 horas. *@company.com permite um domínio inteiro. Repita a flag para cada endereço ou domínio.

Seu serviço recebe o endereço verificado no cabeçalho X-AddToThese-Email. Cada execução substitui a lista, então executar sem --allowed-email torna a URL pública de novo. Você também pode editar a lista na página do endpoint no painel.

addtothese tcp

addtothese tcp 5432 --subdomain mydb

Expõe uma porta TCP bruta, como Postgres, SSH ou RDP. Quem precisa acessá-la roda o forwarder do seu lado, que abre uma porta local conectada ao seu serviço:

addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com

Depois, a pessoa pode se conectar a localhost:5432 como se o banco de dados estivesse na máquina dela.

Variáveis de ambiente

VariávelSignificado
ADDTOTHESE_TOKENToken de API; tem prioridade sobre o salvo
ADDTOTHESE_CONFIGCaminho para um arquivo de configuração alternativo