Referencia de la CLI
Un solo binario, addtothese, es todo lo que necesitas: iniciar sesión, abrir túneles y reenviar puertos TCP. Tu sesión se guarda en ~/.addtothese/config.yaml (%USERPROFILE%\.addtothese\config.yaml en Windows).
addtothese login
addtothese login --token att_...
Guarda un token de API. Sin --token, pide el token por la entrada estándar. addtothese logout lo olvida.
addtothese http
addtothese http <port|host:port|url> [--subdomain name]
Expone un servicio HTTP local. Sin --subdomain obtienes un endpoint aleatorio. Con él, el túnel usa un nombre que hayas reservado en el panel. La CLI se reconecta sola tras caídas de red y renueva sus credenciales antes de que caduquen.
| Opción | Valor por defecto | Significado |
|---|---|---|
| --subdomain | aleatorio | Nombre reservado que se usará |
| --timeout | 10s | Tiempo de espera al reenviar cada petición a tu servicio |
| --access-log | true | Muestra cada petición que pasa por el proxy |
| --log-level | warn | debug, info, warn o error |
Protege una URL con códigos por correo
addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'
Solo las personas de tu lista pueden abrir la URL. El visitante introduce su correo; si está en la lista, recibe un código de 6 dígitos válido durante 10 minutos y mantiene la sesión iniciada durante 24 horas. *@company.com permite todo un dominio. Repite el flag para cada dirección o dominio.
Tu servicio recibe la dirección verificada en la cabecera X-AddToThese-Email. Cada ejecución sustituye la lista, así que ejecutar sin --allowed-email vuelve a hacer pública la URL. También puedes editar la lista en la página del endpoint en el panel.
addtothese tcp
addtothese tcp 5432 --subdomain mydb
Expone un puerto TCP sin procesar, como Postgres, SSH o RDP. Quien necesite acceder a él ejecuta el forwarder en su lado, que abre un puerto local conectado a tu servicio:
addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com
Después puede conectarse a localhost:5432 como si la base de datos estuviera en su máquina.
Variables de entorno
| Variable | Significado |
|---|---|
| ADDTOTHESE_TOKEN | Token de API; tiene prioridad sobre el guardado |
| ADDTOTHESE_CONFIG | Ruta a un archivo de configuración alternativo |