Справочник CLI
Один бинарный файл, addtothese, — всё, что нужно: вход, открытие туннелей и проброс TCP-портов. Данные входа хранятся в ~/.addtothese/config.yaml (%USERPROFILE%\.addtothese\config.yaml в Windows).
addtothese login
addtothese login --token att_...
Сохраняет API-токен. Без --token запрашивает токен через стандартный ввод. addtothese logout удаляет его.
addtothese http
addtothese http <port|host:port|url> [--subdomain name]
Открывает доступ к локальному HTTP-сервису. Без --subdomain вы получаете случайный эндпоинт. С ним туннель использует имя, зарезервированное в панели управления. CLI сам переподключается после сбоев сети и обновляет учётные данные до истечения их срока.
| Флаг | По умолчанию | Назначение |
|---|---|---|
| --subdomain | random | Зарезервированное имя |
| --timeout | 10s | Тайм-аут пересылки каждого запроса вашему сервису |
| --access-log | true | Выводить каждый проксированный запрос |
| --log-level | warn | debug, info, warn или error |
Защитите URL кодами по эл. почте
addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'
Открыть URL могут только люди из вашего списка. Посетитель вводит свой адрес эл. почты; если он есть в списке, посетитель получает 6-значный код, действующий 10 минут, и остаётся в системе 24 часа. *@company.com разрешает целый домен. Повторите флаг для каждого адреса или домена.
Ваш сервис получает подтверждённый адрес в заголовке X-AddToThese-Email. Каждый запуск заменяет список, поэтому запуск без --allowed-email снова делает URL публичным. Список также можно изменить на странице эндпоинта в панели управления.
addtothese tcp
addtothese tcp 5432 --subdomain mydb
Открывает доступ к TCP-порту, например Postgres, SSH или RDP. Те, кому нужно к нему подключиться, запускают у себя форвардер, который открывает локальный порт, связанный с вашим сервисом:
addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com
После этого они могут подключаться к localhost:5432, как будто база данных работает на их машине.
Переменные окружения
| Переменная | Назначение |
|---|---|
| ADDTOTHESE_TOKEN | API-токен, переопределяет сохранённый |
| ADDTOTHESE_CONFIG | Путь к альтернативному файлу конфигурации |