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:

Terminal care afișează comanda Docker Compose pentru extragerea imaginii Synapse.
Extrageți imaginea Synapse după actualizarea etichetei acesteia la versiunea selectată pentru implementarea dvs.
docker compose pull synapse
Terminal care afișează comanda Docker Compose pentru recrearea serviciului 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:

Editorul YAML afișează caracteristicile experimentale cu msc3575_enabled setat la true.
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:

Terminal cu comenzi curl și jq care citește capacitatea MSC3575 simplificată de la endpoint-ul versiunilor publice Matrix.
Verificați răspunsul serverului public de acasă pentru capacitatea nativă simplified_msc3575.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.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.

Lasă un comentariu

Restaurarea sinapselor matriceale în siguranță cu un dump PostgreSQL

Faceți o copie de rezervă a Synapse cu pg_dump, protejați cheia de semnare și mediul de stocare și restaurați-le într-o bază de date PostgreSQL curată, fără a reutiliza chei de unică folosință învechite.

Rulează Mjölnir ca un bot de moderare a camerei Matrix cu Docker

Rulează Mjölnir ca un bot de moderare a camerei Matrix cu Docker

Configurați Mjölnir cu un cont Matrix dedicat, o cameră de administrare criptată, Docker Compose, o listă de politici și verificări de permisiuni.

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ă

Sari peste proxy-ul retras și configurează funcția Sliding Sync încorporată în Synapse. Verifică descoperirea clienților, apoi măsoară comportamentul de încărcare și reconectare a listei de camere pe un telefon compatibil.

Găzduiți Element Web pe Nginx cu un server de acasă personalizat

Implementează Element Web ca site static, direcționează-l către serverul tău principal Matrix, adaugă HTTPS și configurează Nginx pentru a servi actualizări fără fișiere învechite.

Rulați un server de acasă cu matrice ușoară pe Raspberry Pi 4

Configurați Conduit pe un Raspberry Pi 4 pe 64 de biți cu date persistente, federație HTTPS, înregistrare protejată și verificări pentru un server de acasă funcțional.

Configurați un alias personalizat pentru camera matricei pe propriul domeniu

Oferă unei camere Matrix o adresă ușor de partajat pe domeniul tău folosind Element sau API-ul Matrix, cu verificări pentru permisiuni, denumire Synapse și federație.

Configurați Coturn pentru apeluri vocale și video Matrix fiabile

Configurați coturn și Synapse cu acreditări TURN corespunzătoare, deschideți porturile de retransmisie necesare și verificați dacă clienții Matrix pot obține candidați de retransmisie.

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Configurați un server de acasă Synapse persistent cu Docker Compose, PostgreSQL, o configurație privată și verificări înainte de expunerea acestuia prin HTTPS.

Personalizați tema și brandingul Element Web

Setați un nume de marcă, culori personalizate și resurse de conectare pentru implementarea Element Web, înțelegând în același timp care părți rămân cu marca Element.

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Diagnosticați dacă Synapse a atins limita de fișiere deschise per proces, setați un drop-in systemd pentru serviciul sau worker-ul corect și verificați limita de funcționare.