Tunnix в разработке и ещё не выпущен. Загрузки появятся здесь с первым выпуском.

Локальный HTTP API конфигурации

Только на компьютере: проверка и предпросмотр конфигураций Xray из ваших собственных инструментов.

Включение

Откройте Xray → Локальный API и включите Включить локальный API. API слушает только на 127.0.0.1, по умолчанию на порту 18587. Нажмите Копировать токен, чтобы передать токен доступа доверенному инструменту; Сбросить токен отзывает старый токен.

Запросы

Каждый запрос должен содержать Authorization: Bearer <token>.

ЗапросРезультат
GET /api/v1/infoВерсии API, приложения и ядра, а также платформа
POST /api/v1/config/validateПроверяет конфигурацию
POST /api/v1/config/compileПоказывает конфигурацию времени выполнения, которую сгенерировал бы Tunnix

Тела POST-запросов — JSON с полями kind (outbound, routing, advanced-routing или raw) и text — исходный JSON в виде строки.

curl -s http://127.0.0.1:18587/api/v1/info \
  -H "Authorization: Bearer $TUNNIX_TOKEN"

Ограничения

API не импортирует, не сохраняет и не выбирает серверы и не может запускать или останавливать VPN. HTTP 200 со status: failed означает, что запрос выполнен, но конфигурация не прошла проверку.

Никогда не помещайте токен в URL, историю командной строки или запросы к ИИ. Любой, у кого есть токен, может использовать API на этом компьютере.