Справочник 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 сам переподключается после сбоев сети и обновляет учётные данные до истечения их срока.

ФлагПо умолчаниюНазначение
--subdomainrandomЗарезервированное имя
--timeout10sТайм-аут пересылки каждого запроса вашему сервису
--access-logtrueВыводить каждый проксированный запрос
--log-levelwarndebug, 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_TOKENAPI-токен, переопределяет сохранённый
ADDTOTHESE_CONFIGПуть к альтернативному файлу конфигурации