Главная
» Как сделать
»
Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.
Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.
Для текущей версии мобильного клиента Matrix не добавляйте старый автономный прокси-сервер Sliding Sync в Docker Compose. Прокси-сервер был удален в ноябре 2025 года; Synapse сам предоставляет встроенную функцию Simplified Sliding Sync, которая включена по умолчанию начиная с версии Synapse 1.114. Обновите Synapse до поддерживаемой версии, убедитесь, что встроенная функция доступна клиентам через ваш публичный URL-адрес, и измерьте загрузку на клиенте, который ее поддерживает.
Что изменилось и что вам нужно
Первоначально термин «Sliding Sync» относился к реализации прокси-сервера MSC3575, который работал перед Synapse и требовал отдельной настройки службы и обнаружения. Спецификация Matrix развивалась: MSC4186, упрощенная скользящая синхронизация, заменила эту конструкцию. Официальный репозиторий прокси-серверов заархивирован, и в нем говорится, что от современных клиентов больше не ожидается работы с ним. Synapse добавил встроенную поддержку MSC3575 и MSC4186 и включил ее по умолчанию, начиная с версии 1.114.0, как указано в журнале изменений Synapse .
В этом руководстве предполагается, что Synapse уже работает с Docker Compose за общедоступным HTTPS-адресом, например https://matrix.example.org, . Вам потребуется доступ к командной оболочке проекта Compose, возможность редактировать его тег образа и конфигурацию домашнего сервера, а также мобильное приложение, текущая версия которого поддерживает встроенную синхронизацию Sliding Sync. Если вам нужна только более быстрая начальная загрузка в клиенте, который не поддерживает эту функцию, добавление прокси-сервера не заставит этот клиент использовать данную функцию.
Подготовьте безопасное обновление Synapse.
Используйте актуальную поддерживаемую версию Synapse, а не привязывайте новое развертывание к историческому минимальному набору функций. Ознакомьтесь с официальными версиями Synapse и примечаниями к обновлению для версии, с которой вы переходите. Перед обновлением создайте резервную копию базы данных и томов данных/конфигурации Synapse и проверьте, содержатся ли в примечаниях промежуточные шаги обновления. Это особенно важно для старых установок: в уведомлении Synapse о безопасности, касающемся раскрытия состояния комнаты с помощью Sliding Sync, перечислены затронутые версии до v1.120.0 включительно, а в версии v1.120.1 исправлена ошибка. Выбирайте текущую поддерживаемую версию с более поздними исправлениями, а не просто первую исправленную версию.
В файле Compose найдите ключ службы для Synapse и используемый им тег образа. Если тег привязан к старой версии, измените его на поддерживаемую вами версию. Затем загрузите и создайте заново только эту службу; замените synapseприведенный ниже код, если у вашей службы другое имя:
Загрузите образ Synapse после обновления его тега до версии, выбранной для вашего развертывания.
docker compose pull synapse
Пересоздайте службу Synapse, чтобы Compose запускал выбранный образ.
docker compose up -d synapse
docker compose logs --tail=100 synapse
Перед продолжением проверьте журналы на наличие ошибок запуска и подтверждение завершения обновления базы данных. Не выполняйте понижение версии вслепую, если запуск не удался; обратитесь к руководству по обновлению для конкретной версии и восстановите резервную копию, используя только тот процесс восстановления, который подходит для вашей базы данных.
Убедитесь, что функция Sliding Sync включена.
В Synapse обычно по умолчанию включена встроенная функция Sliding Sync, поэтому при чистой установке часто не требуется дополнительный YAML-код. Параметр сохраняет старое имя MSC, что может вызывать путаницу: он управляет собственной реализацией Synapse и не является запросом на запуск устаревшего прокси. Проверьте существующий параметр homeserver.yamlна наличие явного значения false. Если вы его найдете, измените его в существующем блоке функций:
Если в конфигурации Synapse эта возможность явно отключена, включите её в существующем блоке experimental_features.
experimental_features:
msc3575_enabled: true
Если experimental_featuresэтот блок уже существует, отредактируйте его вместо добавления дублирующего ключа YAML. Если параметр отсутствует или уже имеет значение, оставьте его без изменений. После изменения конфигурации пересоздайте службу Synapse и проверьте ее журналы. Ошибка отступа в YAML может помешать запуску Synapse.
Удалите устаревший путь прокси и проверьте обнаружение.
Проверьте JSON-данные, предоставляемые по адресу https://matrix.example.org/.well-known/matrix/client. Если они содержат старое org.matrix.msc3575.proxyсвойство, удалите его, сохранив при этом не связанные с ним записи обнаружения клиентов. Также удалите любое правило обратного прокси, которое отправляет запросы клиентов Matrix на устаревший прокси; стандартный /_matrix/client/путь API должен вести к Synapse. Не добавляйте новый порт прокси и не указывайте URL-адрес прокси для нативного MSC4186. Сохраните все остальные общеизвестные значения, включая URL-адрес вашего домашнего сервера, в соответствии с требованиями вашей конфигурации.
С компьютера, имеющего доступ к общедоступному домашнему серверу, выполните запрос к конечной точке версий клиент-сервер. Это проверит, какие именно сервисы обнаруживают клиенты, а не только контейнер в частной сети Docker:
Проверьте ответ от публичного домашнего сервера на наличие встроенной возможности simplified_msc3575.
Для версии Synapse с включенной поддержкой нативных функций и правильно маршрутизированной конечной точкой должно быть выведено значение true. Если jqзначение недоступно, выполните curlзапрос без конвейера и проверьте поле JSON. Отсутствие значения или значение false является полезным сигналом ошибки: убедитесь, что DNS и HTTPS достигают ожидаемого сервера, что обратный прокси-сервер передает путь API клиента в Synapse, что запущенный образ соответствует выбранной вами версии и что никакая явная конфигурация не отключает эту функцию. Не раскрывайте токены доступа при обмене диагностическими данными; этот публичный запрос версий не требует их.
Оцените результат на совместимом телефоне.
Войдите в систему или переподключитесь с помощью клиентской версии, поддерживающей собственный протокол, используя ту же учетную запись и телефон, которые вы будете использовать для сравнения. По возможности запишите базовый результат перед сменой сервера. Сравнивайте запуск приложения без подключения к сети после очистки или восстановления локальных данных приложения только в том случае, если вы понимаете, что это удаляет кэшированное содержимое; затем сравнивайте обычные запуски с подключением после отключения телефона от сети. Сохраняйте согласованность сети, учетной записи, настроек комнаты и метода тестирования.
Измеряйте время от момента открытия приложения до того, как список комнат станет доступным, а не просто до исчезновения заставки.
Проверьте, отображаются ли названия последних комнат, непрочитанные сообщения и новые сообщения сразу после переподключения.
Просмотрите журналы Synapse на предмет ошибок конечных точек, повторных попыток или перегрузки рабочих процессов/базы данных во время одного и того же теста.
Более быстрое получение первого списка комнат и корректное восстановление после переподключения являются практическими признаками того, что клиент использует ожидаемый путь. Универсального повышения скорости нет: на результат влияют реализация клиента и локальный кэш, задержка сети, производительность базы данных, количество комнат в учетной записи и нагрузка на сервер. Sliding Sync также не ускоряет загрузку медиафайлов и не восстанавливает перегруженную базу данных. Если проверка совместимости пройдена, но приложение по-прежнему работает медленно, сравните его с другим поддерживаемым клиентом и изучите эти узкие места, прежде чем изменять настройки прокси или кэша. Если вы все еще используете старые клиенты, которые зависят от устаревшего прокси MSC3575, проверьте их совместимость отдельно, прежде чем удалять старый путь обнаружения; не следует предполагать, что одна конечная точка обслуживает все поколения клиентов.