Зашифрованные сообщения с ваших серверов без бота с аккаунтом: 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, команды — в руководстве, раздел «Скрипты и серверы».