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.
Para um cliente Matrix mobile atual, não adicione o antigo proxy Sliding Sync independente ao Docker Compose. O proxy foi arquivado em novembro de 2025; o Synapse oferece o Simplified Sliding Sync nativo, habilitado por padrão desde a versão 1.114. Atualize o Synapse para uma versão compatível, verifique se a funcionalidade nativa chega aos clientes através do seu URL público e meça a carga em um cliente que a suporte.
Originalmente, o termo "Sliding Sync" referia-se à implementação de proxy do MSC3575, que ficava à frente do Synapse e exigia um serviço separado e uma configuração de descoberta. A especificação Matrix evoluiu: o MSC4186, Simplified Sliding Sync, substituiu esse design. O repositório oficial do proxy está arquivado e indica que não se espera mais que os clientes modernos funcionem com ele. O Synapse adicionou suporte nativo para MSC3575 e MSC4186 e o habilitou por padrão a partir da versão 1.114.0, conforme registrado no changelog do Synapse .
Este guia pressupõe que o Synapse já esteja em execução com o Docker Compose por trás de uma URL HTTPS pública, como `https:// https://matrix.example.orgexample.com/synapse`. Você precisa de acesso ao shell do projeto Compose, uma maneira de editar a tag da imagem e a configuração do servidor doméstico, além de um aplicativo móvel cuja versão atual suporte a Sincronização Deslizante nativa. Se você deseja apenas um carregamento inicial mais rápido em um cliente que não oferece suporte a esse recurso, adicionar um proxy não fará com que esse cliente o utilize.
Use uma versão do Synapse que esteja atualmente em manutenção, em vez de fixar uma nova instalação no mínimo de recursos históricos. Consulte os lançamentos oficiais do Synapse e as notas de atualização da versão da qual você está migrando. Faça backup do banco de dados e dos volumes de dados/configuração do Synapse antes de atualizar e verifique se as notas recomendam etapas intermediárias de atualização. Isso é especialmente importante em instalações antigas: o aviso de segurança do Synapse para uma divulgação do estado da sala do Sliding Sync lista as versões afetadas até a v1.120.0 e corrige o problema na v1.120.1. Escolha uma versão atual com suporte e com correções mais recentes, e não apenas a primeira versão corrigida.
No seu arquivo Compose, identifique a chave de serviço do Synapse e a tag de imagem que ele usa. Se a tag estiver vinculada a uma versão antiga, altere-a para a versão compatível que você selecionou. Em seguida, baixe e recrie apenas esse serviço; substitua o synapsecódigo abaixo se o seu serviço tiver outro nome:

docker compose pull synapse

docker compose up -d synapse
docker compose logs --tail=100 synapse
Antes de prosseguir, revise os registros em busca de erros de inicialização e de uma atualização de banco de dados concluída. Não execute um downgrade às cegas se a inicialização falhar; consulte as orientações de atualização específicas da versão e restaure um backup somente usando o processo de recuperação apropriado para o seu banco de dados.
O Synapse normalmente habilita a Sincronização Deslizante nativa por padrão, portanto, uma instalação nova geralmente não requer nenhum arquivo YAML adicional. A configuração mantém o nome antigo do MSC, o que pode ser confuso: ela controla a implementação nativa do Synapse e não é uma solicitação para executar o proxy desativado. Verifique homeserver.yamlse há um valor falso explícito em sua configuração. Se encontrar um, altere-o no bloco de recursos existente:

experimental_features:
msc3575_enabled: true
Se experimental_featuresjá existir, edite esse bloco em vez de adicionar uma chave YAML duplicada. Se a configuração estiver ausente ou já estiver definida como verdadeira, deixe-a como está. Recrie o serviço Synapse após uma alteração de configuração e verifique os logs. Um erro de indentação no YAML pode impedir a inicialização do Synapse.
Inspecione o JSON servido em https://matrix.example.org/.well-known/matrix/client. Se ele contiver a org.matrix.msc3575.proxypropriedade antiga, remova-a, preservando as entradas de descoberta de clientes não relacionadas. Remova também qualquer regra de proxy reverso que envie solicitações de clientes Matrix para o proxy desativado; o /_matrix/client/caminho da API padrão deve alcançar o Synapse. Não adicione uma nova porta de proxy nem anuncie um URL de proxy para MSC4186 nativo. Mantenha quaisquer outros valores conhecidos, incluindo o URL do seu servidor doméstico, conforme exigido pela sua configuração.
A partir de uma máquina que consiga acessar o servidor público, consulte o endpoint de versões Cliente-Servidor. Isso verifica os serviços que os clientes realmente descobrem, em vez de verificar apenas um contêiner na rede privada do Docker.

curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'
Para uma versão do Synapse com suporte nativo habilitado e um endpoint roteado corretamente, isso deve imprimir true. Se jqestiver indisponível, execute a curlsolicitação sem o pipe e inspecione o campo JSON. Um valor ausente ou falso é um sinal de falha útil: verifique se o DNS e o HTTPS estão alcançando o servidor esperado, se o proxy reverso está passando o caminho da API do cliente para o Synapse, se a imagem em execução é a versão selecionada e se nenhuma configuração explícita desabilita o recurso. Não exponha tokens de acesso ao compartilhar a saída de diagnóstico; esta solicitação de versões públicas não precisa de um.
Inicie sessão ou reconecte-se com uma versão do cliente que suporte o protocolo nativo, usando a mesma conta e o mesmo telefone que usará para comparação. Se possível, registre uma linha de base antes de alterar o servidor. Compare uma inicialização a frio do aplicativo após limpar ou reconstruir os dados locais do aplicativo somente se entender que isso remove o conteúdo em cache; em seguida, compare inicializações a quente normais e uma reconexão após o telefone ter ficado offline. Mantenha a rede, a conta, o conjunto de salas e o método de teste consistentes.
Uma lista de salas inicial mais rápida e uma recuperação eficiente após a reconexão são sinais práticos de que o cliente está usando o caminho esperado. Não há ganho de velocidade universal: a implementação do cliente e o cache local, a latência da rede, o desempenho do banco de dados, a quantidade de salas na conta e a carga do servidor afetam o resultado. A Sincronização Deslizante também não acelera downloads de mídia nem corrige um banco de dados sobrecarregado. Se a verificação de capacidade for bem-sucedida, mas o aplicativo continuar lento, compare com outro cliente compatível e investigue esses gargalos antes de alterar as configurações de proxy ou cache. Se você ainda utiliza clientes antigos que dependem do proxy MSC3575 descontinuado, teste a compatibilidade deles separadamente antes de remover o caminho de descoberta antigo; não presuma que um único ponto de extremidade atenda a todas as gerações de clientes.
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.