Como configurar a sincronização deslizante do Matrix para carregamento mais rápido em dispositivos móveis (sem o proxy legado)

Atualização, 6 de outubro de 2026: O proxy independente Matrix Sliding Sync não é mais o componente correto para instalação. O Matrix.org arquivou seu matrix-org/sliding-syncrepositório em novembro de 2025 porque ele implementava a API MSC3575 mais antiga, que foi substituída pela Sincronização Deslizante Simplificada (MSC4186). O Synapse oferece suporte à implementação nativa desde a versão 1.114, com suporte habilitado por padrão. Em julho de 2026, a Equipe Central de Especificação do Matrix aceitou a proposta principal do MSC4186; as propostas de extensão relacionadas permanecem em desenvolvimento separado.

Para uma implementação móvel moderna do Synapse, a configuração prática consiste em executar uma versão atual do Synapse, confirmar se ela anuncia o Sliding Sync nativo, garantir que o proxy reverso passe os caminhos da API do cliente Matrix sem alterações e usar um cliente móvel compatível. Não são necessários um contêiner de proxy separado, um banco de dados de proxy ou uma URL de descoberta de proxy antiga.

Você ainda deve instalar o proxy independente Sliding Sync?

Não, não para uma nova implementação destinada aos clientes móveis Matrix atuais. O proxy arquivado implementa o MSC3575, e não o fluxo nativo mais recente MSC4186. O próprio repositório do projeto afirma que ele não recebe mais manutenção e que não se espera mais que os clientes Matrix modernos funcionem com ele. O Matrix.org também anunciou a migração para o suporte nativo e a remoção do suporte ao proxy MSC3575 do Element X em janeiro de 2025.

O guia histórico de proxies ainda pode ser útil para identificar uma instalação antiga: ele utilizava PostgreSQL, um segredo persistente e uma SYNCV3_*configuração de ambiente. Essas instruções descrevem uma arquitetura obsoleta. Não as copie para um novo servidor nem exponha um proxy legado publicamente só porque um tutorial antigo o considera mais rápido.

O que mudou e o que isso significa para os usuários de dispositivos móveis?

O proxy anterior era um serviço separado que ficava entre um cliente e seu servidor principal. A Sincronização Deslizante Simplificada está implementada no próprio Synapse. Ela permite que clientes compatíveis solicitem uma janela relevante da lista de salas de um usuário e a atualizem incrementalmente, o que pode reduzir a quantidade de trabalho de sincronização que um aplicativo móvel precisa realizar ao abrir ou retornar a uma conta grande.

Esta é uma melhoria na sincronização, não uma garantia de que todas as telas carregarão instantaneamente. Ela não elimina problemas como um servidor de mídia lento, atrasos na entrada em salas remotas, cobertura de celular fraca ou um banco de dados sobrecarregado. O aplicativo móvel precisa ser compatível com MSC4186 e o ​​servidor doméstico precisa anunciá-lo. O anúncio da Matrix.org afirma que a implementação nativa do Synapse evita o armazenamento de dados separado do proxy antigo e a limitação inicial de sincronização completa.

O que você precisa antes de habilitá-lo?

• Um servidor doméstico Matrix executando o Synapse. Este guia não pressupõe que o Dendrite, o Conduit ou outro servidor doméstico exponha a mesma implementação nativa.
• Uma versão do Synapse com suporte contínuo. A versão 1.114 introduziu suporte nativo ao MSC4186, mas utilize uma versão atual com suporte, em vez de considerar a versão 1.114 como uma recomendação de segurança ou manutenção.
• Um cliente móvel que suporte a Sincronização Deslizante Simplificada. Um servidor doméstico competente não pode fazer com que um cliente mais antigo use uma API que ele não implementa.
• Um endpoint de cliente HTTPS funcional e uma configuração de proxy reverso para o servidor doméstico.
• É necessário fazer um backup recente do banco de dados e da configuração antes de atualizar ou alterar o roteamento do servidor.

Como posso verificar se o Synapse já anuncia o recurso nativo de Sincronização Deslizante?

Consulte o endpoint público de versões da API Cliente-Servidor a partir de um terminal. Substitua o host de exemplo pela URL base pública que seus clientes Matrix utilizam:

curl -fsS https://matrix.example.org/_matrix/client/versions   | jq -r '.unstable_features["org.matrix.simplified_msc3575"]'

Uma resposta de truesignifica que o servidor está anunciando o recurso nativo de Sincronização Deslizante Simplificada. Uma resposta de false, null, ou uma chave ausente significa que você deve verificar a versão e a configuração do Synapse antes de testar o cliente. Se jqnão estiver instalado, solicite a mesma URL em um navegador ou execute curl -fsS https://matrix.example.org/_matrix/client/versionse inspecione a resposta JSON.

Este indicador sinaliza a capacidade do servidor; ele não comprova que uma versão específica do aplicativo seja compatível ou que todas as rotas de proxy reverso estejam corretas. Use um cliente cujas notas de versão documentem o suporte nativo ao Sliding Sync e verifique o caminho da solicitação nos logs ou nos diagnósticos do navegador/rede, quando disponíveis.

Como habilitar o suporte nativo no Synapse?

O Synapse 1.114 e versões posteriores habilitaram a Sincronização Deslizante nativa por padrão. Se a resposta da versão já for verdadeira true, geralmente não há nenhum serviço separado para instalar nem um novo banco de dados de sincronização para criar. Evite adicionar configurações especulativas simplesmente porque guias mais antigos descrevem o proxy.

Se o recurso estiver explicitamente desativado na sua configuração do Synapse, revise a configuração em experimental_features. Nas versões que usam a flag documentada, o YAML relevante é:

experimental_features:
  msc3575_enabled: true

Adicione ou altere esta configuração somente após consultar a documentação de configuração da sua versão do Synapse. Faça um backup homeserver.yaml, preserve o restante do experimental_featuresbloco existente e mantenha a indentação do YAML consistente. Valide o arquivo usando o comando de validação de configuração do Synapse para a sua instalação e, em seguida, reinicie o Synapse por meio do gerenciador de serviços ou do método de orquestração de contêineres que você já utiliza. Verifique novamente /_matrix/client/versionsdepois disso.

Se você estiver executando uma versão anterior à 1.114, planeje uma atualização do Synapse seguindo as instruções oficiais de atualização. Leia as notas de versão intermediárias, faça backup do banco de dados e dos arquivos de mídia/configuração e siga o caminho de atualização compatível com sua implementação. Não combine uma atualização do servidor doméstico, reescrita do proxy reverso e remoção do proxy antigo em uma única alteração não verificada.

Seu proxy reverso precisa de uma rota Sliding Sync especial?

Geralmente não. O Native Sliding Sync usa uma rota da API Cliente-Servidor do Matrix em `<nome_da_rota>` /_matrix/client, portanto, seu proxy reverso existente deve encaminhar o namespace da API do cliente Matrix para o Synapse. O guia oficial de proxy reverso do Synapse recomenda encaminhar `<nome_da_rota>` /_matrixe /_synapse/client`<nome_da_rota>` e preservar o URI da solicitação em vez de canonicalizá-lo ou normalizá-lo.

Verifique suas regras de proxy se /_matrix/client/versionselas funcionam, mas um aplicativo compatível não consegue sincronizar. Confirme se as solicitações chegam ao /_matrix/client/unstable/org.matrix.simplified_msc3575/Synapse e não são enviadas para um proxy MSC3575 remanescente, bloqueadas por um firewall de aplicativos da web ou reescritas por uma regra de caminho. Se o Synapse estiver sendo executado atrás de um proxy, mantenha os cabeçalhos forwarded-protocol e client-IP corretos, conforme descrito na documentação do Synapse.

Não crie uma nova org.matrix.msc3575.proxyentrada /.well-known/matrix/clientpara suporte nativo. Essa chave anuncia a API de proxy descontinuada. Se você a adicionou anteriormente em um arquivo JSON estático conhecido ou no Synapse extra_well_known_client_content, remova apenas a propriedade de proxy legada após verificar se nenhum cliente antigo necessário depende dela. Mantenha intactas as informações normais de descoberta do servidor doméstico.

Como migrar uma instalação de proxy existente?

1. Registre a versão atual do Synapse, as versões dos clientes, o URL do proxy, as rotas do proxy reverso e os locais do banco de dados e dos segredos do proxy antigo.
2. Faça backup do banco de dados do servidor doméstico, da configuração e do banco de dados do proxy. Mantenha esses backups até que os logins e a sincronização do cliente nativo sejam verificados.
3. Atualize o Synapse seguindo o caminho de lançamento documentado se ele for anterior à versão 1.114 e, em seguida, confirme se o sinalizador de capacidade nativa retorna true.
4. Atualize os aplicativos móveis para versões que oferecem suporte nativo à Sincronização Deslizante Simplificada. Siga as instruções de migração ou login no aplicativo. Algumas sessões existentes podem precisar de um novo login para migrar do protocolo antigo.
5. Remova o anúncio de proxy desativado e redirecione o caminho da API do cliente Matrix para o Synapse. Recarregue o proxy reverso e verifique sua configuração antes de aplicá-la.
6. Faça o teste primeiro com uma conta e um dispositivo móvel. Confirme o login, o carregamento da lista de salas, a abertura de uma sala criptografada, o envio e recebimento de mensagens e a reconexão após a troca de redes.
7. Após o teste ser bem-sucedido para os clientes que você suporta, desative o proxy legado. Mantenha o backup do banco de dados por um período de reversão acordado; exclua os dados antigos somente após confirmar que não são mais necessários.

O banco de dados proxy armazenava o estado de sincronização do lado do proxy, em vez de substituir o histórico de salas do Synapse. Mesmo assim, evite excluí-lo como parte da migração inicial: ele fornece uma referência para solucionar problemas da configuração legada e um limite de reversão mais seguro enquanto os usuários migram para sessões nativas.

Como saber se o carregamento em dispositivos móveis melhorou?

Compare o mesmo cliente, conta, dispositivo e rede antes e depois da alteração, caso possua medições de referência confiáveis. Registre o tempo decorrido desde a abertura do aplicativo até a exibição de uma lista de salas utilizável, verifique se as mensagens recentes aparecem sem uma longa espera e se o aplicativo se atualiza após um breve período offline. Repita a comparação mais de uma vez; uma única inicialização pode ser distorcida pelo estado do cache, pelas condições da rede ou pelo download de um arquivo de mídia grande.

Se o cliente ainda realiza /syncrequisições comuns e nunca anuncia ou tenta suporte nativo, verifique a versão do cliente e suas próprias configurações de sincronização. Se ele solicitar o endpoint simplificado, mas receber um erro, inspecione os logs do Synapse e do proxy reverso para essa requisição. Verifique a integridade do banco de dados e a carga do servidor se muitos usuários relatarem lentidão no carregamento. A Sincronização Deslizante pode reduzir o trabalho de sincronização, mas não pode compensar um banco de dados sobrecarregado ou uma requisição de API mal direcionada.

Quais são as principais opções de configuração?

Fontes e notas de versão

O repositório de proxy independente está arquivado. A implementação nativa do Synapse data da versão 1.114. A Equipe Central da Especificação Matrix aceitou a proposta principal MSC4186 em julho de 2026, enquanto as extensões relacionadas permanecem separadas. O Synapse, os clientes móveis e a especificação Matrix continuam a evoluir, portanto, verifique a documentação e as notas de versão para obter informações sobre as versões exatas que você está executando.

• Repositório de proxy Sliding Sync arquivado e notas de configuração legadas
• Matrix.org: Descontinuação do proxy e migração para suporte nativo
• Matrix.org: Sincronização deslizante nativa simplificada no Synapse 1.114
• Registro de alterações do Synapse: Suporte ao MSC4186 ativado por padrão na versão 1.114.
• Documentação do Synapse: Roteamento de proxy reverso e gerenciamento de URIs
• Matrix.org: Aceitação do MSC4186 e trabalhos de extensão restantes