Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

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.

O que mudou e do que você precisa?

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.

Prepare uma atualização segura do Synapse

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:

Terminal mostrando o comando Docker Compose para baixar a imagem do Synapse.
Faça o download da imagem do Synapse após atualizar sua tag para a versão selecionada para sua implantação.
docker compose pull synapse
Terminal mostrando o comando Docker Compose para recriar o serviço Synapse.
Recrie o serviço Synapse para que o Compose execute a imagem selecionada.
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.

Confirme se a Sincronização Deslizante nativa está ativada.

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:

Editor YAML mostrando experimental_features com msc3575_enabled definido como verdadeiro.
Se a sua configuração do Synapse desabilitar explicitamente a funcionalidade, habilite-a no bloco experimental_features 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.

Remova o caminho proxy desativado e teste a descoberta.

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.

Terminal com comandos curl e jq que lê a funcionalidade simplificada do MSC3575 do endpoint público das versões do Matrix.
Verifique a resposta do servidor doméstico público para a capacidade nativa simplified_msc3575.
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.

Avalie o resultado em um telefone compatível.

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.

  • Meça o tempo decorrido desde a abertura do aplicativo até que a lista de salas esteja utilizável, e não apenas até que a tela inicial desapareça.
  • Verifique se os nomes das salas recentes, o status de mensagens não lidas e as novas mensagens aparecem imediatamente após a reconexão.
  • Monitore os logs do Synapse em busca de erros nos endpoints, tentativas repetidas ou sobrecarga no banco de dados/processador durante o mesmo teste.

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.

Deixar um comentário

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.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

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.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

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.

Hospedagem de elementos web no Nginx com um servidor doméstico personalizado

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.

Execute um servidor doméstico Matrix leve no Raspberry Pi 4

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.

Configure um alias personalizado para a sala Matrix em seu próprio domínio.

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 para chamadas de voz e vídeo confiáveis ​​no Remake Matrix.

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.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Configure um servidor doméstico Synapse persistente com Docker Compose, PostgreSQL, uma configuração privada e verificações antes de expô-lo via HTTPS.

Personalize o tema e a identidade visual do Element Web.

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.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

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.