termchat.app

Зашифрованные сообщения с ваших серверов без бота с аккаунтом: termchat.app 0.8 для скриптов и cron

16 ноября 2026 г.

termchat.app начинался как мессенджер для терминала. Но у терминала есть и другая сторона: скрипты, cron, CI и серверы, которым нужно вам что-то сообщить. Версия 0.8 даёт им такую возможность.

Проблема

«Бэкап не прошёл». «Сборка закончилась». «Диск заполнен на 95 %». Обычно такое шлют через Telegram-бота, ntfy или почту. Это работает, но:

  • текст лежит открытым на чужом сервере;
  • Telegram-боту нужен аккаунт, привязанный к номеру телефона;
  • чтобы ответить с телефона, нужна ещё больше обвязки.

Сквозного шифрования прямо из shell-скрипта, без своей инфраструктуры, почти нет.

Что добавила 0.8

termchat без аргументов по-прежнему открывает экран чата. С командой он делает одно дело и завершается:

termchat send alice "бэкап не прошёл на $(hostname)"
make release; termchat send alice "сборка релиза: код $?"
df -h / | termchat send alice
termchat recv --from alice --wait 600 --json

Сообщение от скрипта идёт ровно так же, как от человека: шифрование Olm, анонимная очередь на relay, Tor, если он включён. Relay их не различает.

На сервере у каждой команды есть ещё --password-file: без него termchat спрашивает пароль с клавиатуры, а у скрипта её нет. Ниже настройка целиком.

Как завести сервер

Шаги для Linux с systemd, команды от root.

1. Установите termchat для всех пользователей сервера (это один статический файл):

curl -fsSL https://raw.githubusercontent.com/prophecy1345/termchat/main/scripts/install.sh | TERMCHAT_INSTALL_DIR=/usr/local/bin sh

2. Системный пользователь, которому принадлежит только личность сервера, его папка и случайный пароль, который может прочитать только он:

useradd --system --home-dir /var/lib/termchat-bot --shell /usr/sbin/nologin termchat-bot
install -d -o termchat-bot -g termchat-bot -m 700 /var/lib/termchat-bot /etc/termchat-bot
head -c 30 /dev/urandom | base64 | sudo -u termchat-bot sh -c 'umask 077; cat > /etc/termchat-bot/pw'

Чтобы не набирать длинную команду в следующих шагах, заведите короткое имя:

bot() { sudo -u termchat-bot env TERMCHAT_HOME=/var/lib/termchat-bot termchat "$@" --password-file /etc/termchat-bot/pw; }

3. Создайте личность. Никнейм — то, что вы увидите в приложении:

bot init --nickname backup-box

4. Свяжите её с собой. В приложении создайте приглашение: Ctrl+O в терминале и десктопе, «Пригласить» на телефоне. Передайте его серверу:

bot add 'termchat:...'

5. Примите запрос от backup-box в приложении. Затем посмотрите, под каким именем сервер видит вас, и отправьте пробное сообщение:

bot contacts                # ваш никнейм, отпечаток, "ok"
bot send alice "привет от $(hostname)"

6. Используйте из systemd. Файл пароля и TERMCHAT_HOME нужно указать в самой службе: служба не видит того, что вы задали в своей оболочке.

# /etc/systemd/system/disk-report.service
[Service]
Type=oneshot
User=termchat-bot
Environment=TERMCHAT_HOME=/var/lib/termchat-bot
ExecStart=/bin/sh -c 'df -h / | /usr/local/bin/termchat send alice --password-file /etc/termchat-bot/pw'

Для расписания добавьте .timer. Если удобнее cron — crontab -u termchat-bot -e, и те же две вещи прямо в строке: 0 9 * * * TERMCHAT_HOME=/var/lib/termchat-bot /usr/local/bin/termchat send alice "доброе утро" --password-file /etc/termchat-bot/pw.

Одна личность выполняет одну команду за раз: если два скрипта запустятся одновременно, второй завершится с кодом 1 и скажет, что личность открыта в другом месте. Наш relay-сервер, заведённый ровно так, теперь присылает владельцу утренний отчёт и сообщение, когда падает сайт.

Решения, которые стоит объяснить

  • Пароль никогда не берётся из переменных окружения. Только из файла, который принадлежит вам и имеет права 600, из stdin или с клавиатуры. Окружение наследует каждый дочерний процесс.
  • Одна отправка — один контакт. Отправки «всем» нет: это была бы рассылка, а их в termchat.app нет намеренно.
  • Сервер не может принимать запросы. Связь заводите вы со своего устройства, поэтому серверная личность не впустит незнакомца.
  • Вывод очищается. Управляющие символы от собеседника не попадут в ваш терминал или лог, а файлы сохраняются только в папку, которую вы указали, и никогда не открываются.
  • Без фоновой службы. Каждая команда подключается и завершается, нет долгоживущего процесса с паролем в памяти. Через Tor это 10–30 секунд на команду, для уведомлений нормально.
  • Коды возврата для скриптов: 0 — сообщение на relay, 3 — контакт не найден или найдено несколько, 4 — не принят вовремя (уйдёт со следующей командой), 5 — этому контакту писать нельзя.

Честно о сервере

Личность на сервере защищена ровно настолько, насколько защищён сам сервер. Её пароль лежит рядом с её состоянием, поэтому тот, кто получил там root, читает её переписку и может писать от её имени. Поэтому это всегда должна быть отдельная личность, которая говорит только с вами, а не ваша основная: это другой ключ с другими очередями, и через неё не добраться до ваших настоящих контактов.

Полное описание решения — в ADR-024, команды — в руководстве, раздел «Скрипты и серверы».

Установить termchat.app