Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

W przypadku obecnego klienta mobilnego Matrix nie dodawaj starego, samodzielnego serwera proxy Sliding Sync do Docker Compose. Serwer proxy został zarchiwizowany w listopadzie 2025 roku; Synapse sam obsługuje natywną funkcję Simplified Sliding Sync, domyślnie włączoną od wersji Synapse 1.114. Zaktualizuj Synapse do obsługiwanej wersji, sprawdź, czy natywna funkcja dociera do klientów za pośrednictwem publicznego adresu URL i zmierz obciążenie na kliencie, który ją obsługuje.

Co się zmieniło i czego potrzebujesz

Termin „Sliding Sync” pierwotnie odnosił się do implementacji proxy MSC3575, która znajdowała się przed Synapse i wymagała osobnego ustawienia usługi i wykrywania. Specyfikacja Matrix ewoluowała: MSC4186, Simplified Sliding Sync, zastąpił ten projekt. Oficjalne repozytorium proxy zostało zarchiwizowane i informuje, że nowi klienci nie powinni już z nim współpracować. Synapse dodał natywne wsparcie dla MSC3575 i MSC4186 i domyślnie je włączył od wersji 1.114.0, co zostało odnotowane w dzienniku zmian Synapse .

W tym przewodniku założono, że Synapse działa już z Docker Compose za pośrednictwem publicznego adresu URL HTTPS, takiego jak https://matrix.example.org. Potrzebny jest dostęp do powłoki do projektu Compose, możliwość edycji tagu obrazu i konfiguracji serwera domowego oraz aplikacja mobilna, której aktualna wersja obsługuje natywną funkcję Sliding Sync. Jeśli zależy Ci jedynie na szybszym początkowym ładowaniu w kliencie, który jej nie obsługuje, dodanie serwera proxy nie spowoduje, że klient skorzysta z tej funkcji.

Przygotuj bezpieczną aktualizację Synapse

Użyj aktualnie obsługiwanej wersji Synapse, zamiast przypinać nowe wdrożenie do historycznego minimum funkcji. Przejrzyj oficjalne wersje Synapse i notatki dotyczące aktualizacji dla wersji, z której się migrujesz. Przed aktualizacją wykonaj kopię zapasową bazy danych i woluminów danych/konfiguracji Synapse i sprawdź, czy w uwagach nie ma mowy o pośrednich krokach aktualizacji. Jest to szczególnie ważne w przypadku starszych instalacji: komunikat bezpieczeństwa Synapse dotyczący ujawniania stanu pokoju Sliding Sync wymienia wszystkie wersje dotknięte problemem do wersji 1.120.0 i naprawia problem w wersji 1.120.1. Wybierz aktualnie obsługiwaną wersję z późniejszymi poprawkami, a nie tylko pierwszą wersję z poprawkami.

W pliku Compose zidentyfikuj klucz usługi dla Synapse i używany przez niego tag obrazu. Jeśli tag jest przypięty do starej wersji, zmień go na wybraną, obsługiwaną wersję. Następnie pobierz i utwórz ponownie tylko tę usługę; zastąp ją synapseponiżej, jeśli Twoja usługa ma inną nazwę:

Terminal pokazujący polecenie Docker Compose umożliwiające pobranie obrazu Synapse.
Pobierz obraz Synapse po zaktualizowaniu jego znacznika do wersji wybranej dla wdrożenia.
docker compose pull synapse
Terminal pokazujący polecenie Docker Compose umożliwiające ponowne utworzenie usługi Synapse.
Utwórz ponownie usługę Synapse, aby Compose uruchomił wybrany obraz.
docker compose up -d synapse
docker compose logs --tail=100 synapse

Przed kontynuowaniem sprawdź dzienniki pod kątem błędów uruchamiania i ukończonej aktualizacji bazy danych. Nie przeprowadzaj ślepej zmiany wersji, jeśli uruchomienie się nie powiedzie; zapoznaj się z instrukcjami aktualizacji dla danej wersji i przywróć kopię zapasową wyłącznie za pomocą procesu odzyskiwania odpowiedniego dla Twojej bazy danych.

Potwierdź, że natywna synchronizacja slajdów jest włączona

Synapse zazwyczaj domyślnie włącza natywną synchronizację Sliding Sync, więc nowa instalacja często nie wymaga dodatkowego pliku YAML. Ustawienie zachowuje starszą nazwę MSC, co może być mylące: kontroluje ona natywną implementację Synapse i nie jest żądaniem uruchomienia wycofanego serwera proxy. Sprawdź istniejącą wartość homeserver.yamlpod kątem jawnej wartości false. Jeśli ją znajdziesz, zmień ją w istniejącym bloku funkcji:

Edytor YAML pokazujący experimental_features z parametrem msc3575_enabled ustawionym na true.
Jeśli konfiguracja Synapse jawnie wyłącza tę możliwość, włącz ją w istniejącym bloku experimental_features.
experimental_features:
  msc3575_enabled: true

Jeśli experimental_featuresblok już istnieje, edytuj go zamiast dodawać duplikat klucza YAML. Jeśli ustawienie jest niedostępne lub ma już wartość true, pozostaw je bez zmian. Po zmianie konfiguracji utwórz ponownie usługę Synapse i sprawdź jej logi. Błąd wcięcia w pliku YAML może uniemożliwić uruchomienie usługi Synapse.

Usuń wycofaną ścieżkę proxy i przetestuj wykrywanie

Sprawdź plik JSON obsługiwany przez https://matrix.example.org/.well-known/matrix/client. Jeśli zawiera starą org.matrix.msc3575.proxywłaściwość, usuń ją, zachowując niezwiązane wpisy wykrywania klienta. Usuń również wszelkie reguły odwrotnego proxy, które wysyłają żądania klienta Matrix do nieaktywnego proxy; standardowa /_matrix/client/ścieżka API musi prowadzić do Synapse. Nie dodawaj nowego portu proxy ani nie ogłaszaj adresu URL proxy dla natywnego MSC4186. Zachowaj wszystkie inne znane wartości, w tym adres URL serwera domowego, zgodnie z wymaganiami konfiguracji.

Z komputera, który ma dostęp do publicznego serwera domowego, należy wysłać zapytanie do punktu końcowego wersji klient-serwer. W ten sposób sprawdzana jest usługa faktycznie wykryta przez klientów, a nie tylko kontener w prywatnej sieci Docker:

Terminal z poleceniem curl i jq, który odczytuje uproszczoną funkcjonalność MSC3575 z punktu końcowego publicznej wersji Matrix.
Sprawdź odpowiedź publicznego serwera domowego dotyczącą natywnej funkcji simplify_msc3575.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'

W przypadku wersji Synapse z włączoną obsługą natywną i poprawnie przekierowanym punktem końcowym, powinno to spowodować wyświetlenie true. Jeśli jqjest niedostępny, uruchom curlżądanie bez potoku i sprawdź pole JSON. Brak wartości lub wartość fałszywa to przydatny sygnał błędu: sprawdź, czy DNS i HTTPS docierają do oczekiwanego serwera, czy odwrotny serwer proxy przekazuje ścieżkę API klienta do Synapse, czy uruchomiony obraz jest w wybranej wersji i czy żadna jawna konfiguracja nie wyłącza tej funkcji. Nie ujawniaj tokenów dostępu podczas udostępniania wyników diagnostycznych; to publiczne żądanie wersji ich nie wymaga.

Oceń wynik na kompatybilnym telefonie

Zaloguj się lub połącz ponownie za pomocą wersji klienta obsługującej protokół natywny, używając tego samego konta i telefonu, którego będziesz używać do porównania. Jeśli to możliwe, przed zmianą serwera zapisz punkt odniesienia. Porównaj zimny start aplikacji po wyczyszczeniu lub odbudowaniu lokalnych danych aplikacji tylko wtedy, gdy rozumiesz, że usuwa to zawartość z pamięci podręcznej; następnie porównaj zwykłe ciepłe starty i ponowne połączenie po tym, jak telefon był offline. Zachowaj spójność sieci, konta, ustawień pokoju i metody testowania.

  • Mierz czas od momentu otwarcia aplikacji do momentu, w którym lista pokoi stanie się dostępna, a nie tylko do momentu zniknięcia ekranu powitalnego.
  • Sprawdź, czy nazwy ostatnich pokoi, nieprzeczytane statusy i nowe wiadomości są wyświetlane natychmiast po ponownym połączeniu.
  • Monitoruj logi Synapse pod kątem błędów punktów końcowych, powtarzających się prób lub obciążenia serwera roboczego/bazy danych podczas tego samego testu.

Szybsza lista pierwszego pokoju i sprawne nadrabianie zaległości po ponownym połączeniu to praktyczne oznaki, że klient korzysta z oczekiwanej ścieżki. Nie ma uniwersalnego wzrostu szybkości: implementacja klienta i lokalna pamięć podręczna, opóźnienia sieciowe, wydajność bazy danych, liczba pokoi kont i obciążenie serwera – wszystkie te czynniki wpływają na wynik. Synchronizacja przesuwna nie przyspiesza również pobierania multimediów ani nie naprawia przeciążonej bazy danych. Jeśli sprawdzenie możliwości przebiegnie pomyślnie, ale aplikacja nadal działa wolno, porównaj innego obsługiwanego klienta i zbadaj te wąskie gardła przed zmianą ustawień proxy lub pamięci podręcznej. Jeśli nadal korzystasz ze starszych klientów, które zależą od wycofanego proxy MSC3575, przetestuj ich zgodność osobno przed usunięciem starej ścieżki wykrywania; nie zakładaj, że jeden punkt końcowy obsługuje każdą generację klientów.

Zostaw komentarz

Bezpieczne przywracanie Matrix Synapse za pomocą zrzutu PostgreSQL

Utwórz kopię zapasową Synapse za pomocą pg_dump, chroń jej klucz podpisu i nośnik, a następnie przywróć do czystej bazy danych PostgreSQL bez ponownego używania nieaktualnych kluczy jednorazowych.

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Skonfiguruj Mjölnir przy użyciu dedykowanego konta Matrix, szyfrowanego pokoju zarządzania, Docker Compose, listy zasad i kontroli uprawnień.

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Pomiń wycofany serwer proxy i skonfiguruj wbudowaną funkcję Sliding Sync w Synapse. Sprawdź wykrywanie klientów, a następnie zmierz ładowanie listy pokoi i zachowanie ponownego łączenia na kompatybilnym telefonie.

Host Element Web na Nginx z niestandardowym serwerem domowym

Wdróż Element Web jako witrynę statyczną, skieruj ją do serwera domowego Matrix, dodaj HTTPS i skonfiguruj Nginx, aby obsługiwał aktualizacje bez przestarzałych plików.

Uruchom lekki serwer domowy Matrix na Raspberry Pi 4

Skonfiguruj Conduit na 64-bitowym Raspberry Pi 4 ze stałymi danymi, federacją HTTPS, chronioną rejestracją i sprawdź, czy serwer domowy działa.

Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Nadaj pokojowi Matrix łatwy do udostępniania adres w swojej domenie, korzystając z Element lub interfejsu API Matrix, ze sprawdzaniem uprawnień, nazewnictwem Synapse i federacją.

Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

Skonfiguruj coturn i Synapse przy użyciu zgodnych poświadczeń TURN, otwórz wymagane porty przekaźnikowe i sprawdź, czy klienci Matrix mogą uzyskać kandydatów na przekaźniki.

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Skonfiguruj trwały serwer domowy Synapse z Docker Compose, PostgreSQL, prywatną konfiguracją i sprawdź, czy jest on udostępniany przez HTTPS.

Dostosuj motyw i branding Element Web

Ustaw nazwę marki, niestandardowe kolory i zasoby logowania dla wdrożenia Element Web, pamiętając jednocześnie, które części pozostaną markowe dla Element.

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.