Aggiornamento, 6 ottobre 2026: Il proxy Matrix Sliding Sync standalone non è più il componente corretto da installare. Matrix.org ha archiviato il suo matrix-org/sliding-syncrepository nel novembre 2025 perché implementava la vecchia API MSC3575, che è stata sostituita da Simplified Sliding Sync (MSC4186). Synapse supporta l'implementazione nativa dalla versione 1.114, con il supporto abilitato per impostazione predefinita. Nel luglio 2026, il Matrix Spec Core Team ha accettato la proposta principale MSC4186; le relative proposte di estensione rimangono un lavoro separato.
Per una moderna implementazione di Synapse su dispositivi mobili, la configurazione pratica prevede l'utilizzo di una versione corrente di Synapse, la verifica del supporto nativo per Sliding Sync, l'assicurazione che il reverse proxy trasmetta senza modifiche i percorsi API del client Matrix e l'utilizzo di un client mobile compatibile. Non sono necessari un container proxy separato, un database proxy o un URL di rilevamento proxy obsoleto.
No, non per una nuova implementazione destinata agli attuali client mobili Matrix. Il proxy archiviato implementa MSC3575, non il flusso nativo più recente MSC4186. Il repository del progetto stesso afferma che non viene più mantenuto e che i client Matrix moderni non sono più compatibili. Matrix.org ha inoltre annunciato il passaggio al supporto nativo e la rimozione del supporto proxy MSC3575 da Element X a gennaio 2025.
La vecchia guida sui proxy potrebbe essere ancora utile per identificare un'installazione obsoleta: utilizzava PostgreSQL, una chiave segreta persistente e una SYNCV3_*configurazione d'ambiente. Queste istruzioni descrivono un'architettura ormai superata. Non copiatele su un nuovo server né esponete pubblicamente un proxy legacy solo perché un vecchio tutorial lo definisce più veloce.
Il proxy precedente era un servizio separato che si interponeva tra un client e il suo server principale. La sincronizzazione a scorrimento semplificata è implementata direttamente in Synapse. Consente ai client compatibili di richiedere una finestra pertinente dell'elenco delle stanze di un utente e di aggiornarla in modo incrementale, riducendo così la quantità di lavoro di sincronizzazione che un'app mobile deve eseguire quando apre o ritorna a un account di grandi dimensioni.
Si tratta di un miglioramento della sincronizzazione, non di una garanzia che ogni schermata si carichi istantaneamente. Non fa sparire un server multimediale lento, un accesso ritardato a una stanza remota, una copertura mobile debole o un database sovraccarico. L'app mobile deve supportare MSC4186 e il server domestico deve pubblicizzarlo. L'annuncio di Matrix.org afferma che l'implementazione nativa di Synapse evita il vecchio archivio dati separato del proxy e la limitazione iniziale della sincronizzazione completa.
Interroga l'endpoint pubblico delle versioni dell'API Client-Server da un terminale. Sostituisci l'host di esempio con l'URL di base pubblico utilizzato dai tuoi client Matrix:
curl -fsS https://matrix.example.org/_matrix/client/versions | jq -r '.unstable_features["org.matrix.simplified_msc3575"]'Una risposta di truesignifica che il server pubblicizza il flag di funzionalità nativo Simplified Sliding Sync. Una risposta di false, null, o una chiave mancante significa che dovresti controllare la versione e la configurazione di Synapse prima di testare il client. Se jqnon è installato, richiedi lo stesso URL in un browser o esegui curl -fsS https://matrix.example.org/_matrix/client/versionse ispeziona la risposta JSON.
Questo flag indica la capacità del server; non dimostra che una particolare versione dell'app sia compatibile o che ogni percorso del reverse proxy sia corretto. Utilizza un client le cui note di rilascio documentino il supporto nativo per Sliding Sync e verifica il percorso della richiesta nei relativi log o tramite la diagnostica del browser/rete, se disponibile.
Synapse 1.114 e versioni successive abilitano Sliding Sync nativo per impostazione predefinita. Se la risposta relativa alle versioni è già true, di solito non è necessario installare un servizio separato né creare un nuovo database di sincronizzazione. Evitate di aggiungere configurazioni speculative solo perché le guide più vecchie descrivono il proxy.
Se la funzionalità è esplicitamente disabilitata nella configurazione di Synapse, rivedere l'impostazione in experimental_features. Nelle versioni che utilizzano il flag documentato, il YAML pertinente è:
experimental_features:
msc3575_enabled: trueAggiungere o modificare questa impostazione solo dopo aver consultato la documentazione di configurazione per la versione di Synapse installata. Eseguire un backup homeserver.yaml, conservare il resto del experimental_featuresblocco esistente e mantenere la stessa indentazione YAML. Convalidare il file utilizzando il comando di convalida della configurazione di Synapse per la propria installazione, quindi riavviare Synapse tramite il gestore dei servizi o il metodo di orchestrazione dei container già in uso. Ricontrollare /_matrix/client/versionsin seguito.
Se si utilizza una versione precedente alla 1.114, è necessario pianificare un aggiornamento di Synapse seguendo le istruzioni ufficiali. Leggere le note di rilascio intermedie, eseguire il backup del database e dei file multimediali/di configurazione e seguire il percorso di aggiornamento supportato per la propria implementazione. Non combinare l'aggiornamento dell'home server, la riscrittura del reverse proxy e la rimozione del vecchio proxy in un'unica operazione non verificata.
Di solito no. Native Sliding Sync utilizza una route API client-server di Matrix sotto /_matrix/client, quindi il tuo proxy inverso esistente dovrebbe inoltrare lo spazio dei nomi dell'API client di Matrix a Synapse. La guida ufficiale del proxy inverso di Synapse afferma di inoltrare /_matrixe /_synapse/cliente di preservare l'URI della richiesta anziché canonizzarlo o normalizzarlo.
/_matrix/client/versionsSe Synapse funziona ma un'app compatibile non riesce a sincronizzarsi, controlla le regole del proxy . Verifica che le richieste /_matrix/client/unstable/org.matrix.simplified_msc3575/raggiungano Synapse e non vengano inviate a un proxy MSC3575 residuo, bloccate da un firewall per applicazioni web o riscritte da una regola di percorso. Se Synapse è in esecuzione dietro un proxy, mantieni le intestazioni forwarded-protocol e client-IP corrette, come descritto nella documentazione di Synapse.
Non creare una nuova org.matrix.msc3575.proxyvoce /.well-known/matrix/clientper il supporto nativo. Quella chiave pubblicizza l'API proxy dismessa. Se l'hai aggiunta in precedenza in un file JSON statico noto o in Synapse extra_well_known_client_content, rimuovi solo quella proprietà proxy legacy dopo aver verificato che nessun client più vecchio necessario dipenda da essa. Mantieni intatte le normali informazioni di rilevamento dell'homeserver.
true.Il database proxy conteneva lo stato di sincronizzazione lato proxy anziché sostituire la cronologia delle stanze di Synapse. Tuttavia, è meglio evitare di eliminarlo durante la migrazione iniziale: fornisce un riferimento per la risoluzione dei problemi della configurazione precedente e un limite di rollback più sicuro mentre gli utenti passano alle sessioni native.
Se disponi di misurazioni di riferimento affidabili, confronta lo stesso client, account, dispositivo e rete prima e dopo la modifica. Registra il tempo che intercorre tra l'apertura dell'app e la visualizzazione di un elenco di stanze utilizzabile, se i messaggi recenti vengono visualizzati senza un lungo indicatore di caricamento e se l'app si aggiorna dopo un breve periodo offline. Ripeti il confronto più di una volta; un singolo avvio può essere falsato dallo stato della cache, dalle condizioni di rete o da un download di file multimediali di grandi dimensioni.
Se il client continua a eseguire /syncrichieste ordinarie e non pubblicizza né tenta di supportare le funzionalità native, verificare la versione del client e le relative impostazioni di sincronizzazione. Se richiede l'endpoint semplificato ma riceve un errore, esaminare i log di Synapse e del reverse proxy relativi a tale richiesta. Verificare l'integrità del database e il carico del server se molti utenti segnalano tempi di caricamento lenti. La sincronizzazione a scorrimento può ridurre il carico di lavoro di sincronizzazione, ma non può compensare un database sovraccarico o una richiesta API instradata in modo errato.
| Approccio | Migliore vestibilità | Costo o limitazione |
|---|---|---|
| Sincronizzazione a scorrimento nativa semplificata in Synapse | Nuove implementazioni Synapse o manutenute e client compatibili | Richiede un client compatibile; le prestazioni dipendono comunque dallo stato del server e del database. |
| Proxy MSC3575 legacy | Solo per comprendere o mantenere temporaneamente una vecchia configurazione di test | Archiviato, non aggiornato e non più utilizzabile dai clienti moderni. |
| Sincronizzazione della matrice legacy | Client o server domestici senza supporto nativo per Sliding Sync | Continua a funzionare con i client compatibili, ma non offre lo stesso comportamento nativo di scorrimento dell'elenco delle stanze. |
Il repository proxy autonomo è stato archiviato. L'implementazione nativa di Synapse risale alla versione 1.114. Il Matrix Spec Core Team ha accettato la proposta principale MSC4186 nel luglio 2026, mentre le estensioni correlate rimangono separate. Synapse, i client mobili e la specifica Matrix sono in continua evoluzione, quindi si consiglia di consultare la documentazione e le note di rilascio per le versioni esatte in uso.
Risolvi l'avviso di Nextcloud relativo alla mancanza di HSTS configurando il server web HTTPS o il proxy inverso, quindi verifica in modo sicuro l'intestazione Strict-Transport-Security.
Risolvi l'errore "CSync Unknown Error" del client ownCloud Desktop ricostruendo il database di sincronizzazione nascosto, quindi verifica la connettività, le autorizzazioni, i nomi dei file, lo spazio su disco e i log.
Il proxy Matrix Sliding Sync è stato archiviato e sostituito. Abilitare la sincronizzazione Simplified Sliding Sync nativa in Synapse, verificare il supporto del client, aggiornare il routing del proxy e testare la sincronizzazione mobile in modo sicuro.
Diagnostica i rallentamenti nella federazione Matrix Synapse e nell'adesione alle stanze verificando la connettività, lo stato dei tentativi del server remoto, le metriche, il carico del database e i limiti di frequenza di adesione.
Configura la conservazione del cestino e le attività in background di Nextcloud per rimuovere automaticamente i file eliminati, verificare l'avvenuta pulizia ed evitare comandi di eliminazione sicura per tutti gli utenti.
Diagnostica l'eco di BigBlueButton e il ritardo audio di WebRTC separando il feedback del microfono dal ritardo di rete, verificando il test dell'eco, i dispositivi del browser, la connettività UDP e il carico del server.
Configura un repository Restic crittografato e un'attività pianificata (cron job) per Nextcloud, includendo la modalità di manutenzione, un dump di MariaDB, la conservazione dei dati, i log e i controlli di ripristino.
Risolvi i problemi di caricamento su ownCloud bloccati al 99% controllando i log, lo spazio di archiviazione temporaneo, lo spazio dei chunk, i limiti PHP, le sessioni, i proxy e il blocco dei file nell'ordine corretto.
Abilita e applica correttamente l'autenticazione a due fattori (2FA) di Zimbra, registra un account amministratore, scegli la verifica tramite TOTP o e-mail e testa l'accesso alla Console di amministrazione.
Configura Mjolnir per la moderazione di Matrix: crea un account bot dedicato, configura la sua sala di controllo, proteggi le stanze, gestisci le liste di ban e verifica le autorizzazioni in modo sicuro.
