tdlib_ping — официальный JSON-интерфейс TDLib
Бинарник вызывает td_create_client_id / td_send / td_receive / td_execute из td/telegram/td_json_client.h (рекомендуемый multi-client API), без Node.js.
Контракт stdout — одна строка JSON для mtproxy_checkerd:
{"ok":true,"error":"","exit_code":0}
Сборка в CI (Gitea)
В репозитории есть workflow .gitea/workflows/tdlib_ping.yaml (те же триггеры, что и у публикации Docker: push по любой ветке и любому тегу, плюс workflow_dispatch). TDLib собирается из исходников (тег задаётся в workflow, переменная TDLIB_REF), пакета libtdjson-dev в apt не требуется.
В релиз и в артефакты попадает архив tdlib_ping-linux-amd64.tar.gz: внутри бинарник tdlib_ping-linux-amd64 и libtdjson.so* с rpath=$ORIGIN (всё в одной папке после распаковки).
mkdir -p /opt/tdlib-ping && tar -xzf tdlib_ping-linux-amd64.tar.gz -C /opt/tdlib-ping
chmod +x /opt/tdlib-ping/tdlib_ping-linux-amd64
export MTPROXY_TDLIB_HELPER=/opt/tdlib-ping/tdlib_ping-linux-amd64
При push тега архив прикрепляется к релизу (релиз создаётся при отсутствии); при push ветки или workflow_dispatch — только артефакт прогона в Actions.
Сборка
Linux (Debian/Ubuntu), установите заголовки и библиотеку, например:
Важно: в Ubuntu 24.04 (Noble) и на части окружений Jammy пакета libtdjson-dev в apt может не быть. Тогда соберите TDLib из исходников или возьмите готовый tdlib_ping-linux-amd64.tar.gz из CI (см. выше).
sudo apt-get install -y libtdjson-dev # если пакет есть в вашем дистрибутиве
export CGO_ENABLED=1
go build -tags=tdlib -o tdlib_ping ./cmd/tdlib_ping
Если TDLib собран из git: заголовок подключается как #include <td/telegram/td_json_client.h>, поэтому CGO_CFLAGS должен указывать на корень клона (каталог, внутри которого лежит td/telegram/…), а не на вложенный td/:
export CGO_ENABLED=1
export CGO_CFLAGS="-I/path/to/td-clone"
export CGO_LDFLAGS="-L/path/to/td-clone/build -ltdjson"
go build -tags=tdlib -o tdlib_ping ./cmd/tdlib_ping
macOS: brew install tdlib, затем при необходимости export PKG_CONFIG_PATH=... если pkg-config --libs tdlib находит -ltdjson.
Без libtdjson линковка завершится ошибкой — это ожидаемо.
Сборка без тега (как часть go build ./...):
go build ./cmd/tdlib_ping
получится заглушка, которая печатает JSON с exit_code: 2 и пояснением — чтобы репозиторий собирался без TDLib.
Переменные окружения
| Переменная | По умолчанию | Назначение |
|---|---|---|
MTPROXY_TD_API_ID |
12345 |
Замените на значение с my.telegram.org |
MTPROXY_TD_API_HASH |
демо-строка из примера TDLib | Замените на свой api_hash |
MTPROXY_TDLIB_PING_MS |
45000 |
Общий дедлайн цикла (мс) |
MTPROXY_TDLIB_DATABASE_DIR |
пусто | Если задан — постоянный каталог для database_directory / files_directory (подкаталоги db/ и files/ создаются автоматически). Иначе — временный каталог на каждый запуск |
MTPROXY_TD_USE_TEST_DC |
пусто | Если 1 — use_test_dc: true в setTdlibParameters (иногда помогает обойти ожидание телефона на «чистой» БД) |
Запуск
./tdlib_ping 'tg://proxy?server=HOST&port=PORT&secret=HEX'
Если MTPROXY_TDLIB_DATABASE_DIR не задан, каталоги БД TDLib создаются под уникальным префиксом во временном каталоге на каждый запуск (и удаляются после выхода).
Ограничение
При первом запуске с «чистой» БД TDLib может перейти в authorizationStateWaitPhoneNumber. Тогда helper завершится с ошибкой в JSON — нужен уже проинициализированный database_directory или рабочий сценарий входа. Для типичного мониторинга MTProxy на выделенной машине обычно достаточно повторных запусков с фиксированным каталогом (MTPROXY_TDLIB_DATABASE_DIR, см. таблицу выше).