Включите встроенную синхронизацию 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приведенный ниже код, если у вашей службы другое имя:

В терминале отображается команда Docker Compose для загрузки образа Synapse.
Загрузите образ Synapse после обновления его тега до версии, выбранной для вашего развертывания.
docker compose pull synapse
В терминале отображается команда Docker Compose для повторного создания службы 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. Если вы его найдете, измените его в существующем блоке функций:

Редактор YAML отображает experimental_features с параметром msc3575_enabled, установленным в значение true.
Если в конфигурации 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:

Терминал с командами curl и jq, считывающими упрощенные возможности MSC3575 из общедоступной конечной точки версий Matrix.
Проверьте ответ от публичного домашнего сервера на наличие встроенной возможности simplified_msc3575.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'

Для версии Synapse с включенной поддержкой нативных функций и правильно маршрутизированной конечной точкой должно быть выведено значение true. Если jqзначение недоступно, выполните curlзапрос без конвейера и проверьте поле JSON. Отсутствие значения или значение false является полезным сигналом ошибки: убедитесь, что DNS и HTTPS достигают ожидаемого сервера, что обратный прокси-сервер передает путь API клиента в Synapse, что запущенный образ соответствует выбранной вами версии и что никакая явная конфигурация не отключает эту функцию. Не раскрывайте токены доступа при обмене диагностическими данными; этот публичный запрос версий не требует их.

Оцените результат на совместимом телефоне.

Войдите в систему или переподключитесь с помощью клиентской версии, поддерживающей собственный протокол, используя ту же учетную запись и телефон, которые вы будете использовать для сравнения. По возможности запишите базовый результат перед сменой сервера. Сравнивайте запуск приложения без подключения к сети после очистки или восстановления локальных данных приложения только в том случае, если вы понимаете, что это удаляет кэшированное содержимое; затем сравнивайте обычные запуски с подключением после отключения телефона от сети. Сохраняйте согласованность сети, учетной записи, настроек комнаты и метода тестирования.

  • Измеряйте время от момента открытия приложения до того, как список комнат станет доступным, а не просто до исчезновения заставки.
  • Проверьте, отображаются ли названия последних комнат, непрочитанные сообщения и новые сообщения сразу после переподключения.
  • Просмотрите журналы Synapse на предмет ошибок конечных точек, повторных попыток или перегрузки рабочих процессов/базы данных во время одного и того же теста.

Более быстрое получение первого списка комнат и корректное восстановление после переподключения являются практическими признаками того, что клиент использует ожидаемый путь. Универсального повышения скорости нет: на результат влияют реализация клиента и локальный кэш, задержка сети, производительность базы данных, количество комнат в учетной записи и нагрузка на сервер. Sliding Sync также не ускоряет загрузку медиафайлов и не восстанавливает перегруженную базу данных. Если проверка совместимости пройдена, но приложение по-прежнему работает медленно, сравните его с другим поддерживаемым клиентом и изучите эти узкие места, прежде чем изменять настройки прокси или кэша. Если вы все еще используете старые клиенты, которые зависят от устаревшего прокси MSC3575, проверьте их совместимость отдельно, прежде чем удалять старый путь обнаружения; не следует предполагать, что одна конечная точка обслуживает все поколения клиентов.

Оставить комментарий

Безопасное восстановление Matrix Synapse с помощью дампа PostgreSQL

Создайте резервную копию Synapse с помощью pg_dump, защитите ключ подписи и носители, а затем восстановите данные в чистую базу данных PostgreSQL, не используя повторно устаревшие одноразовые ключи.

Запустите Mjölnir в качестве бота для модерации комнат Matrix с помощью Docker.

Запустите Mjölnir в качестве бота для модерации комнат Matrix с помощью Docker.

Настройте Mjölnir, используя выделенный аккаунт Matrix, зашифрованную комнату управления, Docker Compose, список политик и проверки разрешений.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Откажитесь от устаревшего прокси и настройте встроенную в Synapse функцию Sliding Sync. Проверьте обнаружение клиентов, затем измерьте скорость загрузки списка комнат и поведение при переподключении на совместимом телефоне.

Разместите Element Web на Nginx с пользовательским Homeserver.

Разверните Element Web как статический сайт, укажите в качестве сервера ваш домашний сервер Matrix, добавьте HTTPS и настройте Nginx для обслуживания обновлений без устаревших файлов.

Запустите облегченный домашний сервер Matrix на Raspberry Pi 4.

Настройте Conduit на 64-битном Raspberry Pi 4 с сохранением данных, федерацией HTTPS, защищенной регистрацией и проверкой работоспособности домашнего сервера.

Настройте собственный псевдоним для комнаты Matrix в своем домене.

Присвойте комнате Matrix легкодоступный адрес в вашем домене, используя Element или API Matrix, с проверкой прав доступа, именованием Synapse и федерацией.

Настройте Coturn для надежных голосовых и видеозвонков Matrix.

Настройте coturn и Synapse с использованием совпадающих учетных данных TURN, откройте необходимые порты ретрансляции и убедитесь, что клиенты Matrix могут получать кандидатов на ретрансляцию.

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Развертывание Matrix Synapse с помощью Docker Compose и PostgreSQL

Перед тем как сделать его доступным по HTTPS, настройте постоянный домашний сервер Synapse с помощью Docker Compose, PostgreSQL, частной конфигурации и проверок.

Настройте тему и фирменный стиль Element Web.

Задайте фирменное название, пользовательские цвета и элементы авторизации для вашей веб-версии Element, при этом понимая, какие части останутся фирменными.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Проверьте, не превысил ли Synapse лимит на количество открытых файлов в одном процессе, установите параметр systemd для нужной службы или рабочего процесса и проверьте текущий лимит.