Debian

Что нового

• Добавлены подтверждение получения вызова телефоном и ограниченные повторы приглашения.
• Дубликаты и запоздавшие приглашения отменённых звонков обрабатываются без повторного открытия окна.
• Узел сообщает об ошибках шифрования и отправки сигналов вместо ложного подтверждения отправки.

Совместимость

Установите оба пакета одной версии вместе. Android: 1.0.0, сборка 9.

Установка

1. Скачайте оба файла в одну папку: yandi-node_*.deb и yandi-desktop_*.deb.
2. По желанию проверьте файлы:

   sha256sum yandi-node_*.deb yandi-desktop_*.deb

   и сравните с суммами выше.
3. Установите оба пакета одной командой (APT сам подтянет зависимости):

   sudo apt install ./yandi-node_*.deb ./yandi-desktop_*.deb

4. Запустите оболочку: значок YANDI в меню «Интернет» или команда yandi-desktop. При первом запуске она предложит задать пароль и создать закрытую среду.
5. Чтобы узел работал как системная служба и были открыты порты брандмауэра, следуйте руководству, которое ставится с пакетом: /usr/share/doc/yandi-node/DEPLOYMENT.md.

Сервер без оболочки (только консоль)

Оболочка (окно) не обязательна: узел полностью настраивается и управляется из терминала. Так обычно ставят узел на сервер.

1. Установка только узла

Скачайте только yandi-node_*.deb (пакет оболочки yandi-desktop нужен лишь для окна управления) и установите:

sudo apt install ./yandi-node_*.deb

2. Первая настройка

Запускайте от обычного пользователя (не от root): данные узла лежат в его домашней папке. Мастер спросит язык, длину сид-фразы (по умолчанию 24 слова; можно 12 или 18), задаст пароль владельца, покажет сид-фразу, предложит необязательное контрольное слово, создаст закрытую среду и спросит, где хранить копии связей:

yandi setup

Запишите сид-фразу на бумагу и проверьте. Она показывается один раз и нужна для восстановления; без неё и пароля данные не вернуть. Без терминала: yandi setup --seed-file seed.txt --password-stdin (фраза пишется в новый файл с правами 0600).

3. Копии связей и восстановление

Копии (сопряжённые телефоны, контакты, группы) пишутся в выбранное место, в папку yandi-node; узел сам проверяет запись и предупреждает, если место на системном диске. Хранится 7 автокопий; копия делается при изменениях в течение 10 минут. Позже: yandi admin backup status | set-dir ПУТЬ | now. Восстановление на новой машине: yandi setup --restore (сид-фраза, контрольное слово, номер узла для сверки, по желанию файл .yandibak или папка yandi-node); проверить фразу и слово, ничего не меняя: yandi setup --check.

4. Служба и порты

Пакет сам включает и запускает службу systemd yandi-node@ВАШ_ПОЛЬЗОВАТЕЛЬ для пользователя, который ставил пакет через sudo: узел работает в фоне и поднимается после перезагрузки. До yandi setup он просто ждёт первой настройки. Проверить:

systemctl status yandi-node@$USER
journalctl -u yandi-node@$USER -f

# если служба не включилась сама (например, пакет ставили не через sudo):
sudo systemctl enable --now yandi-node@$USER

Откройте порты (пример для ufw; для nftables см. /usr/share/doc/yandi-node/DEPLOYMENT.md): 8444/TCP — вход для приложения на телефоне; 9000/UDP и 10000/UDP — сеть узлов. Рекомендуем также расширить сетевые буферы (иначе под нагрузкой ядро теряет UDP-пакеты; при старте узел предупреждает, если буфер приёма меньше 4 МБ): по 64 МБ на приём и отправку и более длинную очередь пакетов от сетевой карты. Последняя команда покажет действующие значения: 67108864, 67108864 и 5000.

sudo ufw allow 8444/tcp
sudo ufw allow 9000/udp
sudo ufw allow 10000/udp

printf 'net.core.rmem_max=67108864\nnet.core.wmem_max=67108864\nnet.core.netdev_max_backlog=5000\n' | sudo tee /etc/sysctl.d/99-yandi.conf
sudo sysctl --system

# проверка / check
cat /proc/sys/net/core/rmem_max /proc/sys/net/core/wmem_max /proc/sys/net/core/netdev_max_backlog

По желанию: кольцевой буфер самой сетевой карты задаётся командами ethtool -g (показать) и ethtool -G eth0 rx 4096 tx 4096 (в пределах, которые сообщает карта); у многих карт, например Realtek r8169, его менять нельзя.

5. Управление из консоли

Команда yandi admin спрашивает пароль администратора (сеанс 15 минут). Без аргументов открывает меню; основные команды:

• yandi admin status — состояние узла
• yandi admin devices — устройства и пользователи
• yandi admin pairing owner --host ВАШ_АДРЕС — код и QR для сопряжения телефона
• yandi admin invites show — политика приглашений
• yandi admin device-promote ID — подтвердить приглашённого пользователя
• yandi admin device-remove ID — отвязать устройство
• yandi admin vault status — закрытая среда: замок, смена пароля
• yandi admin bootstrap applications — заявки новых узлов (для владельца списка входных узлов)

6. Подключение телефона

Выполните yandi admin pairing owner --host ВАШ_ВНЕШНИЙ_АДРЕС: узел покажет код сопряжения и QR. В приложении YANDI на первом экране наведите камеру на QR или вставьте текст кода (он начинается с YANDI-PAIR-1:). Код одноразовый.

7. Язык

Язык консоли: ключ --lang ru|en, переменная YANDI_LANG=en или сохранённый выбор (~/.config/yandi/lang). Без выбора берётся язык системы.

8. Журнал, обновление, удаление

• Журнал службы: journalctl -u yandi-node -f.
• Обновление: установите новый пакет поверх старого (sudo apt install ./yandi-node_*.deb), затем sudo systemctl restart yandi-node. Данные сохраняются.
• Удаление программы с сохранением данных: sudo apt remove yandi-node. Полное удаление вместе с данными (затирает и удаляет без следа): sudo apt purge yandi-node; перед этим убедитесь, что сид-фраза записана.

Примечания

• Нужен Debian 12 (bookworm) или новее, 64 бита (amd64): glibc 2.36 или новее.
• Обновление: установите новые файлы так же, поверх старых. Данные сохраняются.
• Удаление: sudo apt remove yandi-desktop yandi-node. Данные остаются в каталоге пользователя, пока вы сами их не удалите.