🖥️ 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 года. Полная таблица — в политике обновления.

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

Leave feedback

If you enjoy using Tuna, or on the contrary you are not happy with something, please leave feedback.

Help

We value our users and carefully review every request. If you have any problems with tuna, please contact us in one of the following ways:

• Email
• Telegram community