🖥️ tuna-cli 0.36 — интерфейс в терминале и большое обновление

За последние два релиза консольный клиент tuna-cli изменился сильнее, чем за весь предыдущий год. Главное — у туннелей появился полноэкранный интерфейс в терминале: вместо бегущего текстового лога вы видите ленту запросов, метрики, сессии баз данных и SSH и можете разобрать любой запрос, не выходя из консоли.

Обновиться до 0.36.1 можно по инструкции, а сам клиент теперь подскажет нужную команду — об этом ниже.

Интерфейс в терминале

Интерфейс включается сам, когда вы запускаете tuna http, tuna tcp, tuna ssh, tuna postgres, tuna redis или tuna kubernetes в терминале. В шапке всегда видны аккаунт, адрес туннеля и локальный адрес, куда он ведёт, ссылка на инспектор и статус подключения. Если туннель запущен с ограничениями доступа или опциями, в шапке появляются строки Access и Options — например, basic auth (1) · cidr deny 203.0.113.0/24 и rate limit 20/s · cors, так что видно, с какими настройками туннель работает прямо сейчас. Пароли и ключи не показываются, только их количество. Основная часть экрана зависит от типа туннеля.

HTTP: лента запросов и метрики

Новые запросы появляются сверху, над лентой — счётчики: всего запросов, rpm, p50 и p90 времени ответа, число ответов 4xx и 5xx. По Enter открываются детали запроса с заголовками и отформатированным JSON-телом, r повторяет запрос, а / фильтрует ленту по методу, пути или статусу. Отлаживать вебхук или API стало заметно удобнее: не нужно переключаться в браузер, чтобы понять, что именно пришло.

Postgres и Redis: сессии и запросы

Слева список сессий, справа — события выбранной: запросы с подсветкой, число строк в ответе, ошибки. y копирует запрос в буфер обмена. Видно, какие запросы шлёт ваше приложение или коллега, подключившийся к базе через туннель.

SSH: живой просмотр и запись сессий

Для tuna ssh интерфейс показывает инструкцию для подключения и ленту сессий, включая отказы в доступе. Enter на активной сессии открывает её просмотр в реальном времени, на завершённой — воспроизведение записи.

Горячие клавиши

Клавиша	Действие
c	Скопировать адрес туннеля
i	Открыть инспектор в браузере
Q	Показать QR-код адреса — удобно открыть сайт на телефоне
l	Показать или скрыть лог
↑ ↓, g / G	Навигация по ленте
Ctrl+C	Остановить туннель и выйти

Полный список клавиш для каждого типа туннеля — в документации.

Если нужен старый добрый лог

Интерфейс не мешает автоматизации: он не включается, если вывод перенаправлен в файл или пайп, туннель запущен как сервис, задана переменная CI или NONINTERACTIVE, а также когда tuna запускает ИИ-агент — Claude Code, Cursor и другие. Вернуть текстовый лог вручную можно флагом --log=stdout или переменной TUNA_TUI=0:

tuna http 8080 --log=stdout

Туннели

Unix-сокеты

tuna http и tuna tcp умеют публиковать приложение, которое слушает не порт, а unix-сокет — например, gunicorn или php-fpm за прокси:

tuna http unix:///run/gunicorn.sock

Инспектор, повтор запросов и политики трафика работают так же, как с портом. Через TCP-туннель можно, например, временно открыть Docker API — только обязательно ограничьте доступ своим IP через --cidr-allow: доступ к docker.sock равносилен root-доступу к хосту.

Политика трафика по ссылке и сжатие ответов

Политику трафика для tuna http теперь можно загрузить по https-ссылке — одна политика в репозитории на все машины команды:

tuna http 8080 --policy-url=https://gitlab.com/example/policies/-/raw/main/policy.yml

Новое действие compress_response сжимает ответ приложения в br, zstd, gzip или deflate, если оно не сделало этого само. Ответ сжимается на лету, поэтому SSE и потоковые ответы продолжают работать.

Заодно политика стала строже: если файл из --policy-file не найден, политика не парсится или у аккаунта нет подписки Team, туннель не запустится — раньше клиент выводил предупреждение и продолжал работу. Подробнее — в разделе Ошибки политики.

Trigger получает данные события

tuna trigger раньше просто запускал команду на входящий вебхук или письмо. Теперь команда получает само событие: тело запроса или письмо приходит на stdin, а метод, путь, query и заголовки — в переменных окружения TUNA_REQUEST_* и TUNA_MAIL_*. Так можно, например, запускать деплой только по push в main:

deploy.sh

#!/bin/sh
set -e
[ "$TUNA_REQUEST_HEADER_X_GITLAB_EVENT" = "Push Hook" ] || exit 0
jq -e '.ref == "refs/heads/main"' > /dev/null || exit 0
/opt/app/deploy.sh

SMTP-триггер теперь срабатывает на каждое принятое письмо, а не один раз на соединение, а локальный адрес SMTP-сервера задаётся флагом --listen-address.

Проверка подписи вебхуков GitHub и Sentry

--verify-webhook=github и --verify-webhook=sentry теперь проверяют HMAC-SHA256 от тела запроса так, как описано в документации провайдеров. Раньше настоящие доставки от GitHub и Sentry получали 401 — если вы из-за этого отключали проверку, самое время включить её обратно.

Секреты в консоли

В tuna-cli 0.35 сильно вырос CLI секретов: работа с отдельными секретами, управление проектами и окружениями, секреты файлом без записи на диск, офлайн-режим и отпечатки значений. Об этом — отдельный пост.

Мелочи, которые экономят время

• Подсказка по обновлению. Когда выходит новая версия, клиент показывает готовую команду обновления для вашего способа установки: brew, winget, apt, dnf, zypper, скрипт установки или Docker. tuna version показывает способ установки и проверяет наличие новой версии.
• Подсветка справки. В --help выделены команды, флаги и примеры.
• Подтверждение удаления. Перед удалением доменов, портов, туннелей, API-ключей, секретов и проектов клиент переспрашивает. Пропустить вопрос — флаг --yes.
• tuna whoami показывает, под каким аккаунтом авторизован клиент.

Что проверить при обновлении

• Удаление в скриптах требует --yes. Если команду удаления, например tuna domain clear или tuna secrets delete, запускают без терминала — в CI или cron, — без флага --yes она сразу завершится ошибкой.
• API-ключи выпускаются только в личном кабинете. Команды tuna api-key create и tuna session terminate удалены: сервер больше не позволяет выпускать ключи и завершать веб-сессии по API-ключу. Ключи создаются в личном кабинете.
• Новый репозиторий пакетов. Пакеты для Linux переехали в реестр code.tuna.am, а пакет называется tuna-cli. На Debian и Ubuntu обычный apt upgrade сам переключит репозиторий, на RHEL, Fedora и openSUSE репозиторий нужно один раз сменить вручную — команды есть в инструкции по обновлению.
• Сроки поддержки старых версий. Для пользователей без подписки версии 0.32.x перестают работать 1 октября 2026 года, 0.33.x — 1 ноября, 0.34.x — 1 декабря, 0.35.x — 1 января 2027 года. Полная таблица — в политике обновления.

Полный список изменений по версиям — в журнале изменений.

Оставьте отзыв

Если вам нравится пользоваться Tuna, или наоборот вы недовольны чем либо, то пожалуйста оставьте отзыв.

Помощь

Мы ценим наших пользователей и детально изучаем все обращения, если у вас возникли проблемы с tuna – обязательно свяжитесь с нами одним из способов:

• Электронная почта
• Telegram сообщество