🔄 Миграция сервера Prosody 13

📌 Что переносим и почему

При миграции XMPP-сервера недостаточно скопировать только конфиг. Нужно забрать три ключевые директории — иначе потеряются пользователи, история переписки или кастомные модули, установленные через prosodyctl install.

1 На старом сервере — создаём полный архив

Останавливаем Prosody, чтобы гарантировать целостность данных, и архивируем три папки.

# Остановить сервер
systemctl stop prosody

# Создать архив со всеми необходимыми данными
tar -czf /tmp/prosody-full-backup.tar.gz \
    /etc/prosody \
    /etc/letsencrypt \
    /var/lib/prosody

# Запустить Prosody обратно
systemctl start prosody

# Проверить размер архива
ls -lh /tmp/prosody-full-backup.tar.gz

2 Копируем архив на новый сервер

Используйте scp, rsync или WinSCP. Просто переместите файл /tmp/prosody-full-backup.tar.gz на новый сервер.

# Пример через scp (выполняется с локальной машины)
scp user@старый_сервер:/tmp/prosody-full-backup.tar.gz /tmp/
scp /tmp/prosody-full-backup.tar.gz user@новый_сервер:/tmp/

Убедитесь, что архив скопирован без повреждений — сравните размер и, при желании, контрольную сумму:

# На старом сервере
sha256sum /tmp/prosody-full-backup.tar.gz

# На новом сервере
sha256sum /tmp/prosody-full-backup.tar.gz

3 На новом сервере — установка и восстановление

Ключевой момент: на Debian 12 в основных репозиториях лежит Prosody 0.12, а нам нужна 13.x для поддержки SASL2 и Bind 2. Поэтому ставим из bookworm-backports.

# 1. Подключить бэкпорты Debian 12
echo "deb http://deb.debian.org/debian bookworm-backports main" \
    > /etc/apt/sources.list.d/backports.list

# 2. Обновить списки пакетов
apt update

# 3. Установить Prosody 13 из бэкпортов + зависимости
apt install -t bookworm-backports prosody lua-unbound certbot

# 4. Остановить Prosody перед распаковкой
systemctl stop prosody

# 5. Распаковать архив в корень (поверх установленного)
tar -xzf /tmp/prosody-full-backup.tar.gz -C /

# 6. Назначить правильных владельцев
chown -R prosody:prosody /etc/prosody /var/lib/prosody
chown -R root:root /etc/letsencrypt

# 7. Проверить, что кастомные модули на месте
ls -la /var/lib/prosody/custom_plugins/ | grep sasl

# 8. Проверить конфиг
prosodyctl check config

# 9. Запустить Prosody
systemctl start prosody

# 10. Проверить статус
systemctl status prosody

prosodyctl install --server=https://modules.prosody.im/rocks/ mod_sasl2
prosodyctl install --server=https://modules.prosody.im/rocks/ mod_sasl2_bind2

4 Настраиваем автоматическое обновление сертификатов

Чтобы после каждого продления Let's Encrypt сертификаты автоматически импортировались в Prosody, создадим хук в renewal-hooks/deploy/.

# Создать файл хука
nano /etc/letsencrypt/renewal-hooks/deploy/prosody.sh

Вставить содержимое:

#!/bin/sh
/usr/bin/prosodyctl --root cert import /etc/letsencrypt/live

# Сделать скрипт исполняемым
chmod +x /etc/letsencrypt/renewal-hooks/deploy/prosody.sh

# Протестировать обновление (сухая проверка)
certbot renew --dry-run

5 Финальная проверка

После перезапуска убедитесь, что всё функционирует корректно:

• Логи Prosody: journalctl -u prosody -n 30 --no-pager
• Проверка конфигурации: prosodyctl check config
• Подключение клиентом (Conversations, Gajim, Siskin) с вашим JID и паролем
• Проверка, что SASL2/Bind2 работают — в логах при подключении клиента должны быть строки с SASL2 и Bind 2
• Проверка сертификата в браузере (если настроен веб-интерфейс или файлообмен)

Для наблюдения за подключением в реальном времени:

tail -f /var/log/prosody/prosody.log

При подключении Conversations к вашему домену в логе должны появиться строки вида:

c2s...: Authenticated with SASL2
c2s...: Bind 2 resource bound

Если они есть — миграция прошла успешно, и мгновенное подключение при пробуждении от FCM работает.

📋 Шпаргалка: структура бекапа

⚠️ Частые ошибки и их решение

🔑 Как сменить пароль пользователю

После миграции старые пароли остаются прежними — они хранятся в /var/lib/prosody.

Администратор (через prosodyctl)

prosodyctl passwd user@jimm.top

Команда запросит новый пароль дважды.

Самостоятельный сброс

Требуется модуль mod_email_pass. Пользователь получает ссылку на почту. Уточните, включена ли эта опция на вашем сервере.