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ção | Padrão | Significado |
|---|---|---|
| --subdomain | aleatório | Nome reservado a usar |
| --timeout | 10s | Tempo limite ao encaminhar cada requisição para o seu serviço |
| --access-log | true | Exibe cada requisição que passa pelo proxy |
| --log-level | warn | debug, 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ável | Significado |
|---|---|
| ADDTOTHESE_TOKEN | Token de API; tem prioridade sobre o salvo |
| ADDTOTHESE_CONFIG | Caminho para um arquivo de configuração alternativo |