Acasă
» Cum să
»
Activați sincronizarea glisantă nativă a matricei pentru o încărcare mobilă mai rapidă
Activați sincronizarea glisantă nativă a matricei pentru o încărcare mobilă mai rapidă
Pentru un client mobil Matrix actual, nu adăugați vechiul proxy Sliding Sync independent la Docker Compose. Proxy-ul a fost arhivat în noiembrie 2025; Synapse deservește nativ Simplified Sliding Sync, activat în mod implicit de la Synapse 1.114. Actualizați Synapse la o versiune acceptată, verificați dacă funcționalitatea nativă ajunge la clienți prin URL-ul public și măsurați încărcarea pe un client care o acceptă.
Ce s-a schimbat și de ce ai nevoie
„Sliding Sync” se referea inițial la implementarea proxy a MSC3575, care se afla în fața Synapse și necesita un serviciu separat și o setare de descoperire. Specificația Matrix a evoluat: MSC4186, Simplified Sliding Sync, a înlocuit acest design. Depozitul oficial de proxy este arhivat și precizează că nu se mai așteaptă ca clienții moderni să lucreze cu acesta. Synapse a adăugat suport nativ pentru MSC3575 și MSC4186 și l-a activat în mod implicit începând cu v1.114.0, așa cum este înregistrat în jurnalul de modificări Synapse .
Acest ghid presupune că Synapse rulează deja cu Docker Compose în spatele unui URL HTTPS public, cum ar fi https://matrix.example.org. Aveți nevoie de acces la shell la proiectul Compose, o modalitate de a edita eticheta de imagine și configurația serverului principal și o aplicație mobilă a cărei versiune actuală acceptă Sliding Sync nativ. Dacă doriți doar o încărcare inițială mai rapidă într-un client care nu o acceptă, adăugarea unui proxy nu va face ca acel client să utilizeze funcția.
Pregătiți o actualizare Synapse sigură
Folosește o versiune Synapse întreținută în prezent, în loc să fixezi o nouă implementare la minimul istoric de caracteristici. Examinează versiunile oficiale Synapse și notele de actualizare pentru versiunea de la care treci. Fă o copie de rezervă a bazei de date și a volumelor de date/configurare Synapse înainte de actualizare și verifică dacă notele necesită pași intermediari de actualizare. Acest lucru este important mai ales în cazul instalărilor vechi: avertismentul de securitate Synapse pentru o dezvăluire a stării camerei Sliding Sync listează versiunile afectate până la v1.120.0 și o remediază în v1.120.1. Alege o versiune acceptată în prezent cu remedieri ulterioare, nu doar prima versiune cu patch-uri.
În fișierul Compose, identificați cheia de serviciu pentru Synapse și eticheta de imagine pe care o folosește. Dacă eticheta este fixată la o versiune veche, schimbați-o la versiunea acceptată selectată. Apoi extrageți și recreați doar acel serviciu; înlocuiți synapsemai jos dacă serviciul are un alt nume:
Extrageți imaginea Synapse după actualizarea etichetei acesteia la versiunea selectată pentru implementarea dvs.
docker compose pull synapse
Recreați serviciul Synapse astfel încât Compose să ruleze imaginea selectată.
docker compose up -d synapse
docker compose logs --tail=100 synapse
Verificați jurnalele pentru erori de pornire și o actualizare a bazei de date finalizată înainte de a continua. Nu executați o retrogradare orb dacă pornirea eșuează; consultați instrucțiunile de actualizare specifice versiunii și restaurați o copie de rezervă numai utilizând procesul de recuperare corespunzător bazei de date.
Confirmați că este activată sincronizarea glisantă nativă
În mod normal, Synapse activează implicit Sliding Sync nativ, așa că o instalare nouă nu necesită adesea YAML suplimentar. Setarea păstrează numele MSC mai vechi, care poate fi confuz: controlează implementarea nativă a Synapse și nu este o solicitare de a rula proxy-ul retras. Verificați codul existent homeserver.yamlpentru o valoare falsă explicită. Dacă găsiți una, modificați-o în blocul de funcții existent:
Dacă configurația Synapse dezactivează explicit această funcționalitate, activați-o în blocul experimental_features existent.
experimental_features:
msc3575_enabled: true
Dacă experimental_featuresexistă deja, editați blocul respectiv în loc să adăugați o cheie YAML duplicată. Dacă setarea lipsește sau este deja setată pe true, lăsați-o nemodificată. Recreați serviciul Synapse după o modificare a configurației și verificați jurnalele acestuia. O eroare de indentare YAML poate împiedica pornirea Synapse.
Eliminați calea proxy retrasă și testați descoperirea
Inspectați fișierul JSON servit la https://matrix.example.org/.well-known/matrix/client. Dacă conține org.matrix.msc3575.proxyproprietatea veche, eliminați proprietatea respectivă, păstrând în același timp intrările de descoperire a clienților fără legătură. De asemenea, eliminați orice regulă de proxy invers care trimite solicitări client Matrix către proxy-ul retras; /_matrix/client/calea API standard trebuie să ajungă la Synapse. Nu adăugați un nou port proxy și nu faceți publicitate unei adrese URL proxy pentru MSC4186 nativ. Păstrați orice alte valori cunoscute, inclusiv adresa URL a serverului de domiciliu, conform cerințelor configurației.
De pe o mașină care poate accesa serverul public de acasă, interogați endpoint-ul versiunilor Client-Server. Aceasta verifică serviciul pe care clienții îl descoperă efectiv, în loc să verifice doar un container din rețeaua privată Docker:
Verificați răspunsul serverului public de acasă pentru capacitatea nativă simplified_msc3575.
Pentru o versiune Synapse cu suport nativ activat și un endpoint rutat corect, aceasta ar trebui să se afișeze true. Dacă jqnu este disponibilă, rulați curlsolicitarea fără pipe și inspectați câmpul JSON. O valoare lipsă sau falsă este un semnal de eroare util: verificați dacă DNS și HTTPS ajung la serverul așteptat, dacă proxy-ul invers transmite calea API a clientului către Synapse, dacă imaginea care rulează este versiunea selectată și dacă nicio configurație explicită nu dezactivează funcția. Nu expuneți token-uri de acces atunci când partajați ieșirea de diagnosticare; această solicitare de versiuni publice nu necesită unul.
Evaluează rezultatul pe un telefon compatibil
Conectați-vă sau reconectați-vă cu o versiune de client care acceptă protocolul nativ, utilizând același cont și telefon pe care le veți folosi pentru comparație. Înregistrați o valoare de referință înainte de a schimba serverul, dacă este posibil. Comparați o pornire la rece a aplicației după ștergerea sau reconstruirea datelor aplicației locale numai dacă înțelegeți că acest lucru elimină conținutul din cache; apoi comparați pornirile la cald obișnuite și o reconectare după ce telefonul a fost offline. Mențineți consecvența rețelei, contului, setului de camere și metodei de testare.
Măsoară timpul de la deschiderea aplicației până când lista de camere este utilizabilă, nu doar până când dispare o fereastră de pornire.
Verificați dacă numele camerelor recente, starea necitită și mesajele noi apar imediat după reconectare.
Urmăriți jurnalele Synapse pentru erori la nivelul endpoint-urilor, încercări repetate sau presiune asupra worker-ului/bazei de date în timpul aceluiași test.
O listă mai rapidă a primei camere și o recuperare curată a decalajului după reconectare sunt semne practice că clientul folosește calea așteptată. Nu există un câștig universal de viteză: implementarea clientului și memoria cache locală, latența rețelei, performanța bazei de date, numărul de camere ale contului și încărcarea serverului afectează rezultatul. Sliding Sync nu accelerează nici descărcările media și nu repară o bază de date supraîncărcată. Dacă verificarea capacității trece, dar aplicația rămâne lentă, comparați un alt client acceptat și investigați acele blocaje înainte de a modifica setările proxy sau cache. Dacă încă operați clienți mai vechi care depind de proxy-ul MSC3575 retras, testați compatibilitatea lor separat înainte de a elimina vechea cale de descoperire; nu presupuneți că un endpoint deservește fiecare generație de clienți.