Используйте пользовательский формат дампа PostgreSQL для резервного копирования базы данных Synapse, исключите таблицу с одноразовыми ключами и восстановите данные в новую, пустую базу данных. Сам по себе дамп базы данных не является полным резервным копированием домашнего сервера: сохраните также конфигурацию Synapse, ключ подписи и локальные носители. Официальные рекомендации Synapse по резервному копированию, проверенные 10 октября 2026 года, специально предостерегают от восстановления поверх существующих таблиц и от восстановления старых одноразовых ключей сквозного шифрования.
Что содержит — и чего не содержит — резервная копия базы данных
Подтверждено: pg_dump создается согласованный снимок, пока PostgreSQL остается в сети; Synapse не нужно останавливать во время выполнения дампа. Дамп только базы данных не включает файлы из хранилища мультимедиа Synapse, homeserver.yamlфайлы конфигурации, на которые есть ссылки, или ключ подписи сервера. Храните их в отдельном защищенном наборе резервных копий. Synapse идентифицирует локально загруженный контент и, если динамические эскизы отключены, локальные эскизы как данные для сохранения. Удаленные кэши мультимедиа и предварительных просмотров URL-адресов, как правило, можно получить или перестроить.
Действие: перед созданием плана восстановления определите имя активной базы данных, роль PostgreSQL, каталог конфигурации Synapse, путь к ключу подписи и путь к хранилищу носителей. Используйте пути, настроенные на вашем сервере; они различаются в зависимости от пакета, контейнера и развертывания.
Распространенное заблуждение: успешный дамп SQL не является доказательством возможности восстановления всего домашнего сервера. Действие: создайте резервные копии базы данных, конфигурации и ключа подписи, а также необходимых локальных носителей и периодически проверяйте возможность их совместного восстановления.
Создайте и проверьте дамп пользовательского формата.
Приведённые ниже команды предполагают наличие хоста Linux с установленными инструментами командной строки PostgreSQL, базы данных с именем synapseи разрешения на выполнение команд PostgreSQL от имени postgresучетной записи операционной системы. Замените имя базы данных и пути значениями из вашей развёртки. Сохраните дамп на защищённом хранилище с достаточным свободным местом; он может содержать личные сообщения и данные учётной записи.
Создайте дамп, исключив содержимое таблицы, которую, по мнению 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 и часто имеет меньший размер. Исключение затрагивает данные таблицы; оно не удаляет определение таблицы.
Убедитесь, что файл существует и не пуст, затем выведите оглавление архива:
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, чтобы ничто не подключалось к целевой базе данных и не записывало в нее данные во время восстановления. Подтвердите имя целевой базы данных и дамп перед выполнением команд, изменяющих базу данных.
Создайте новую базу данных с кодировкой UTF-8 и владельцем, указанным в конфигурации Synapse. В следующем примере используется следующая роль synapse_user:
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
Если база данных с таким именем уже существует, не восстанавливайте в неё данные вслепую. Следуйте процедуре восстановления, чтобы сохранить или удалить старую базу данных, только после проверки её содержимого и наличия отдельной восстанавливаемой резервной копии.
Загрузите архив в пустую базу данных:
sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump
Проверьте код завершения команды и вывод PostgreSQL. Изучите ошибки перед запуском Synapse. Избегайте использования таких параметров, как, --cleanнапример, в качестве быстрого способа восстановления поверх заполненной производственной базы данных; Synapse предупреждает, что существующие таблицы могут вызывать ошибки или незначительные несоответствия.
Если дамп не исключил данные одноразовых ключей, удалите их перед запуском. Подключитесь к восстановленной базе данных и выполните:
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 и целям восстановления. Запишите дату проверки восстановления, версии программного обеспечения и результат; не следует предполагать, что непроверенный архив является восстанавливаемой резервной копией.