Restaure o Matrix Synapse com segurança usando um dump do PostgreSQL.
Faça backup do Synapse com pg_dump, proteja sua chave de assinatura e mídia e restaure-o em um banco de dados PostgreSQL limpo, sem reutilizar chaves de uso único obsoletas.
Use o formato de dump personalizado do PostgreSQL para fazer um backup do banco de dados Synapse, exclua a tabela de chaves de uso único e restaure em um banco de dados vazio recém-criado. O dump do banco de dados por si só não é um backup completo do servidor doméstico: preserve também a configuração do Synapse, a chave de assinatura e a mídia local. As diretrizes oficiais de backup do Synapse, verificadas em 10 de outubro de 2026, alertam especificamente contra a restauração sobre tabelas existentes e contra a restauração de chaves de criptografia de ponta a ponta antigas.
Verificado: pg_dump cria um snapshot consistente enquanto o PostgreSQL permanece online; o Synapse não precisa ser interrompido durante a execução do dump. Um dump somente do banco de dados não inclui arquivos do armazenamento de mídia do Synapse, homeserver.yamlarquivos de configuração referenciados ou a chave de assinatura do servidor. Mantenha esses itens em um conjunto de backup protegido separado. O Synapse identifica o conteúdo carregado localmente e, quando as miniaturas dinâmicas estão desativadas, as miniaturas locais como dados a serem preservados. Os caches de mídia remota e de visualização de URL geralmente podem ser obtidos ou reconstruídos.
Ação: identifique o nome do banco de dados ativo, a função do PostgreSQL, o diretório de configuração do Synapse, o caminho da chave de assinatura e o caminho do armazenamento de mídia antes de criar um plano de recuperação. Use os caminhos configurados em seu servidor; eles variam de acordo com o pacote, o contêiner e a implantação.
Conceito errado comum: um despejo de SQL bem-sucedido não prova que todo o servidor doméstico pode ser recuperado. Ação: faça backup do banco de dados, da configuração, da chave de assinatura e das mídias locais necessárias e teste periodicamente a restauração de todos eles em conjunto.
Os comandos abaixo pressupõem um host Linux com as ferramentas de linha de comando do PostgreSQL instaladas, um banco de dados chamado <nome_do_banco_de_dados> synapsee permissão para executar comandos do PostgreSQL como a postgresconta do sistema operacional. Substitua o nome do banco de dados e os caminhos pelos valores da sua implementação. Armazene o arquivo de despejo em um local protegido com espaço livre suficiente; ele pode conter mensagens privadas e dados da conta.
Crie o dump, excluindo o conteúdo da tabela que o Synapse indica que não deve ser reproduzida a partir de um backup anterior:
sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump-FcSeleciona o formato de arquivo personalizado do PostgreSQL, que é adequado pg_restoree geralmente menor do que o SQL puro. A exclusão afeta os dados da tabela; ela não remove a definição da tabela.
Verifique se o arquivo existe e não está vazio, depois liste o conteúdo do arquivo:
ls -lh /secure-backups/synapse.dump
sudo -u postgres pg_restore --list /secure-backups/synapse.dumpA listagem confirma que o PostgreSQL consegue ler a estrutura do arquivo; ela não comprova que todas as linhas podem ser restauradas ou que outros arquivos de backup estejam completos. Para verificações mais robustas, copie o dump para um armazenamento de backup separado e verifique o checksum após a transferência.
Conceito errado comum: parar o Synapse é necessário para cada backup pg_dump. A página oficial do Synapse afirma que um snapshot normal pg_dumpé consistente sem a necessidade de parar o Synapse ou o PostgreSQL. Ação: mantenha o serviço online para este backup lógico, mas planeje uma janela de manutenção para uma restauração completa.
A restauração é uma operação de substituição. Primeiro, pare o Synapse e quaisquer processos do Synapse para que nada se conecte ou grave no destino enquanto a recuperação estiver em andamento. Confirme o nome e o dump do banco de dados de destino antes de executar comandos que alterem o banco de dados.
Crie um novo banco de dados com codificação UTF-8 e o proprietário usado na sua configuração do Synapse. O exemplo a seguir usa a função de exemplo synapse_user:
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapseSe o nome do banco de dados já existir, não o restaure cegamente. Siga o procedimento de recuperação para preservar ou remover o banco de dados antigo somente após confirmar seu conteúdo e garantir que você tenha um backup recuperável separado.
Carregue o arquivo no banco de dados vazio:
sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dumpVerifique o status de saída do comando e a saída do PostgreSQL. Investigue erros antes de iniciar o Synapse. Evite opções como --clean`--help` como atalho para restaurar um banco de dados de produção já populado; o Synapse alerta que tabelas preexistentes podem causar erros ou inconsistências sutis.
Se o despejo de memória não excluiu os dados de chave única, limpe-os antes de iniciar o sistema. Conecte-se ao banco de dados restaurado e execute o seguinte comando:
sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'O Synapse documenta essa exceção porque restaurar chaves antigas de uso único pode fazer com que um cliente reutilize chaves que já foram consumidas, o que pode levar a problemas de descriptografia de mensagens. A limpeza dessas chaves solicita que os clientes enviem novas chaves. Se você seguiu a exclusão recomendada, a tabela não terá linhas restauradas e esse truncamento extra será desnecessário.
Conceito errado comum: todas as tabelas do banco de dados podem ser restauradas juntas com segurança. Ação: exclua-as e2e_one_time_keys_jsondurante o backup ou trunque-as após a restauração, e faça isso antes que qualquer processo do Synapse seja iniciado.
Sempre que possível, restaure a configuração, a chave de assinatura e os arquivos de mídia locais necessários a partir do mesmo ponto de recuperação. Mantenha a chave de assinatura original: o Synapse a utiliza para assinar eventos e solicitações de federação. Caso precise substituí-la, siga as orientações do Synapse sobre chaves de assinatura e configure a chave pública antiga como chave de assinatura antiga. Bancos de dados, mídias e configurações restaurados em momentos muito diferentes podem não representar o mesmo estado; portanto, verifique a consistência do seu plano de recuperação.
Inicie o Synapse e seus processos somente após a conclusão da restauração e do processamento da chave de uso único. Analise os logs de serviço em busca de falhas de conexão com o banco de dados, erros de esquema ou permissão ausentes e problemas de atualização em segundo plano. Em seguida, faça login com uma conta de teste, verifique o histórico recente de uma sala conhecida e abra um anexo carregado localmente. Verifique os serviços de federação e de aplicativos, caso sua implantação dependa deles. Essas verificações são um teste prático, não uma garantia de que todas as salas ou objetos de mídia foram recuperados.
Dependendo da sua implementação: caminhos de comando, nomes de serviço, funções de banco de dados, orquestração de contêineres e retenção de backups são específicos da instalação. Este procedimento abrange um dump e restauração lógicos do PostgreSQL, não a recuperação pontual, funções em todo o cluster do PostgreSQL ou um projeto de failover de alta disponibilidade. Para sistemas de produção, consulte a documentação de backup do Synapse e a documentação de backup e restauração do PostgreSQL para métodos que correspondam à sua versão do PostgreSQL e aos seus objetivos de recuperação. Registre a data, as versões de software e o resultado de um teste de restauração; não presuma que um arquivo não testado seja um backup recuperável.
Faça backup do Synapse com pg_dump, proteja sua chave de assinatura e mídia e restaure-o em um banco de dados PostgreSQL limpo, sem reutilizar chaves de uso único obsoletas.
Configure o Mjölnir com uma conta Matrix dedicada, sala de gerenciamento criptografada, Docker Compose, lista de políticas e verificações de permissão.
Ignore o proxy descontinuado e configure a Sincronização Deslizante integrada do Synapse. Verifique a descoberta de clientes e, em seguida, meça o carregamento da lista de salas e o comportamento de reconexão em um telefone compatível.
Implante o Element Web como um site estático, aponte-o para o seu servidor Matrix, adicione HTTPS e configure o Nginx para servir atualizações sem arquivos obsoletos.
Configure o Conduit em um Raspberry Pi 4 de 64 bits com dados persistentes, federação HTTPS, registro protegido e verificações para um servidor doméstico em funcionamento.
Atribua um endereço fácil de compartilhar a uma sala do Matrix em seu domínio usando o Element ou a API do Matrix, com verificações de permissões, nomenclatura Synapse e federação.
Configure o coturn e o Synapse com credenciais TURN correspondentes, abra as portas de retransmissão necessárias e verifique se os clientes Matrix conseguem obter candidatos de retransmissão.
Configure um servidor doméstico Synapse persistente com Docker Compose, PostgreSQL, uma configuração privada e verificações antes de expô-lo via HTTPS.
Defina um nome de marca, cores personalizadas e recursos de login para sua implementação do Element Web, entendendo quais partes permanecerão com a marca Element.
Diagnostique se o Synapse atingiu seu limite de arquivos abertos por processo, configure um comando systemd para o serviço ou worker correto e verifique o limite em tempo real.