Безопасное восстановление Matrix Synapse с помощью дампа PostgreSQL

Используйте пользовательский формат дампа PostgreSQL для резервного копирования базы данных Synapse, исключите таблицу с одноразовыми ключами и восстановите данные в новую, пустую базу данных. Сам по себе дамп базы данных не является полным резервным копированием домашнего сервера: сохраните также конфигурацию Synapse, ключ подписи и локальные носители. Официальные рекомендации Synapse по резервному копированию, проверенные 10 октября 2026 года, специально предостерегают от восстановления поверх существующих таблиц и от восстановления старых одноразовых ключей сквозного шифрования.

Что содержит — и чего не содержит — резервная копия базы данных

Подтверждено: pg_dump создается согласованный снимок, пока PostgreSQL остается в сети; Synapse не нужно останавливать во время выполнения дампа. Дамп только базы данных не включает файлы из хранилища мультимедиа Synapse, homeserver.yamlфайлы конфигурации, на которые есть ссылки, или ключ подписи сервера. Храните их в отдельном защищенном наборе резервных копий. Synapse идентифицирует локально загруженный контент и, если динамические эскизы отключены, локальные эскизы как данные для сохранения. Удаленные кэши мультимедиа и предварительных просмотров URL-адресов, как правило, можно получить или перестроить.

Действие: перед созданием плана восстановления определите имя активной базы данных, роль PostgreSQL, каталог конфигурации Synapse, путь к ключу подписи и путь к хранилищу носителей. Используйте пути, настроенные на вашем сервере; они различаются в зависимости от пакета, контейнера и развертывания.

Распространенное заблуждение: успешный дамп SQL не является доказательством возможности восстановления всего домашнего сервера. Действие: создайте резервные копии базы данных, конфигурации и ключа подписи, а также необходимых локальных носителей и периодически проверяйте возможность их совместного восстановления.

Создайте и проверьте дамп пользовательского формата.

Приведённые ниже команды предполагают наличие хоста Linux с установленными инструментами командной строки PostgreSQL, базы данных с именем synapseи разрешения на выполнение команд PostgreSQL от имени postgresучетной записи операционной системы. Замените имя базы данных и пути значениями из вашей развёртки. Сохраните дамп на защищённом хранилище с достаточным свободным местом; он может содержать личные сообщения и данные учётной записи.

  1. Создайте дамп, исключив содержимое таблицы, которую, по мнению Synapse, нельзя воспроизводить из более старой резервной копии:

    sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump

    -FcВыбирает пользовательский формат архива PostgreSQL, который подходит для pg_restoreобычного SQL и часто имеет меньший размер. Исключение затрагивает данные таблицы; оно не удаляет определение таблицы.

  2. Убедитесь, что файл существует и не пуст, затем выведите оглавление архива:

    ls -lh /secure-backups/synapse.dump
    sudo -u postgres pg_restore --list /secure-backups/synapse.dump

    Листинг подтверждает, что PostgreSQL может прочитать структуру архива; он не доказывает, что каждую строку можно восстановить или что другие файлы резервных копий являются полными. Для более надежной проверки скопируйте дамп в отдельное хранилище резервных копий и проверьте его контрольную сумму после передачи.

Распространенное заблуждение: остановка Synapse необходима для каждого восстановления pg_dump. На официальной странице Synapse говорится, что обычный pg_dumpснимок обеспечивает согласованность данных без остановки Synapse или PostgreSQL. Действие: поддерживайте работу службы для этого логического резервного копирования, но запланируйте окно технического обслуживания для полного восстановления.

Восстановить данные в пустую базу данных.

Восстановление — это операция замены. Сначала остановите Synapse и все рабочие процессы Synapse, чтобы ничто не подключалось к целевой базе данных и не записывало в нее данные во время восстановления. Подтвердите имя целевой базы данных и дамп перед выполнением команд, изменяющих базу данных.

  1. Создайте новую базу данных с кодировкой UTF-8 и владельцем, указанным в конфигурации Synapse. В следующем примере используется следующая роль synapse_user:

    sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

    Если база данных с таким именем уже существует, не восстанавливайте в неё данные вслепую. Следуйте процедуре восстановления, чтобы сохранить или удалить старую базу данных, только после проверки её содержимого и наличия отдельной восстанавливаемой резервной копии.

  2. Загрузите архив в пустую базу данных:

    sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump

    Проверьте код завершения команды и вывод PostgreSQL. Изучите ошибки перед запуском Synapse. Избегайте использования таких параметров, как, --cleanнапример, в качестве быстрого способа восстановления поверх заполненной производственной базы данных; Synapse предупреждает, что существующие таблицы могут вызывать ошибки или незначительные несоответствия.

  3. Если дамп не исключил данные одноразовых ключей, удалите их перед запуском. Подключитесь к восстановленной базе данных и выполните:

    sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'

    Synapse документирует это исключение, поскольку восстановление старых одноразовых ключей может привести к тому, что клиент будет повторно использовать уже использованные ключи, что может вызвать проблемы с расшифровкой сообщений. Удаление этих ключей побуждает клиентов загрузить новые ключи. Если вы следовали рекомендованному исключению, в таблице нет восстановленных строк, и это дополнительное усечение не требуется.

Распространенное заблуждение: все таблицы базы данных можно безопасно восстановить вместе. Действие: исключите их e2e_one_time_keys_jsonиз резервного копирования или очистите базу данных после восстановления, и сделайте это до запуска любого процесса Synapse.

Верните домашний сервер и проверьте его.

По возможности восстановите соответствующую конфигурацию, ключ подписи и необходимые локальные медиафайлы из той же точки восстановления. Сохраните исходный ключ подписи: Synapse использует его для подписи событий и запросов федерации. Если вам необходимо его заменить, следуйте инструкциям Synapse по использованию ключей подписи и настройте старый открытый ключ как старый ключ подписи. База данных, медиафайлы и конфигурация, восстановленные из разных временных точек, могут не отражать одно и то же состояние, поэтому проверьте свой план восстановления на предмет согласованности.

Запускайте Synapse и его рабочие процессы только после завершения восстановления и обработки одноразовых ключей. Просмотрите журналы служб на предмет сбоев подключения к базе данных, отсутствующих ошибок схемы или разрешений, а также проблем с фоновым обновлением. Затем войдите в систему с тестовой учетной записью, проверьте недавнюю историю известной комнаты и откройте локально загруженное вложение. Проверьте службы федерации и приложений, если ваша система их использует. Эти проверки являются практическим дымовым тестом, а не гарантией восстановления каждой комнаты или медиаобъекта.

Зависит от вашей конфигурации развертывания: пути к командам, имена служб, роли базы данных, оркестрация контейнеров и хранение резервных копий зависят от конкретной установки. Данная процедура описывает логическое дампирование и восстановление PostgreSQL, а не восстановление на определенный момент времени, роли PostgreSQL в масштабе кластера или отказоустойчивую архитектуру с высокой доступностью. Для производственных систем ознакомьтесь с документацией по резервному копированию Synapse и документацией по резервному копированию и восстановлению PostgreSQL, чтобы найти методы, соответствующие вашей версии PostgreSQL и целям восстановления. Запишите дату проверки восстановления, версии программного обеспечения и результат; не следует предполагать, что непроверенный архив является восстанавливаемой резервной копией.

Оставить комментарий

Безопасное восстановление Matrix Synapse с помощью дампа PostgreSQL

Создайте резервную копию Synapse с помощью pg_dump, защитите ключ подписи и носители, а затем восстановите данные в чистую базу данных PostgreSQL, не используя повторно устаревшие одноразовые ключи.

Запустите Mjölnir в качестве бота для модерации комнат Matrix с помощью Docker.

Запустите Mjölnir в качестве бота для модерации комнат Matrix с помощью Docker.

Настройте Mjölnir, используя выделенный аккаунт Matrix, зашифрованную комнату управления, Docker Compose, список политик и проверки разрешений.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Откажитесь от устаревшего прокси и настройте встроенную в Synapse функцию Sliding Sync. Проверьте обнаружение клиентов, затем измерьте скорость загрузки списка комнат и поведение при переподключении на совместимом телефоне.

Разместите Element Web на Nginx с пользовательским Homeserver.

Разверните Element Web как статический сайт, укажите в качестве сервера ваш домашний сервер Matrix, добавьте HTTPS и настройте Nginx для обслуживания обновлений без устаревших файлов.

Запустите облегченный домашний сервер Matrix на Raspberry Pi 4.

Настройте Conduit на 64-битном Raspberry Pi 4 с сохранением данных, федерацией HTTPS, защищенной регистрацией и проверкой работоспособности домашнего сервера.

Настройте собственный псевдоним для комнаты Matrix в своем домене.

Присвойте комнате Matrix легкодоступный адрес в вашем домене, используя Element или API Matrix, с проверкой прав доступа, именованием Synapse и федерацией.

Настройте Coturn для надежных голосовых и видеозвонков Matrix.

Настройте coturn и Synapse с использованием совпадающих учетных данных TURN, откройте необходимые порты ретрансляции и убедитесь, что клиенты Matrix могут получать кандидатов на ретрансляцию.

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Перед тем как сделать его доступным по HTTPS, настройте постоянный домашний сервер Synapse с помощью Docker Compose, PostgreSQL, частной конфигурации и проверок.

Настройте тему и фирменный стиль Element Web.

Задайте фирменное название, пользовательские цвета и элементы авторизации для вашей веб-версии Element, при этом понимая, какие части останутся фирменными.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Проверьте, не превысил ли Synapse лимит на количество открытых файлов в одном процессе, установите параметр systemd для нужной службы или рабочего процесса и проверьте текущий лимит.