Безопасная установка сервера Synapse Matrix за Cloudflare.

Чтобы разместить сервер Synapse Matrix за стандартным прокси-сервером Cloudflare orange-cloud, отправляйте как клиентский API, так и входящий трафик федерации через HTTPS на порт 443. Оставьте TLS включенным от Cloudflare к вашему источнику с параметром Full (strict), маршрутизируйте пути Matrix в Synapse без изменений, публикуйте обнаружение федерации, указывающее на ваше имя хоста на порту 443, и обходите кэширование для путей API. Не указывайте обычную проксированную запись на порт федерации Matrix по умолчанию 8448: стандартный прокси-сервер Cloudflare не указывает этот порт как поддерживаемый.

Убедитесь, что конфигурация порта 443 подходит для вашего сервера.

В этом примере предполагается, что Synapse работает за обратным прокси-сервером, таким как Nginx, Caddy или Traefik. Synapse может оставаться в своей частной сети Docker на HTTP-порту 8008; фронтальный прокси обрабатывает публичный TLS. Федерация может использовать HTTPS 443, когда обнаружение направляет удаленные домашние серверы туда. Synapse поддерживает 443 в качестве альтернативы порту по умолчанию 8448, в то время как Cloudflare указывает 443, но не 8448 среди своих стандартных портов прокси. См. руководство по портам Synapse и список поддерживаемых портов Cloudflare .

Используйте этот подход, когда клиенты и федерация должны использовать одно и то же имя хоста HTTPS через проксируемый HTTPS-сервер. Если вам необходимо, чтобы федерация работала на порту 8448, используйте запись только DNS или продукт Cloudflare, поддерживающий этот TCP-порт. В примере используются example.orgидентификаторы Matrix, такие как @alice:example.orgи matrix.example.orgдля Synapse. Замените имена хостов, но сохраните существующее имя Synapse server_name; его изменение изменяет идентификаторы Matrix для пользователей.

Настройте DNS, TLS и обратный прокси-сервер.

1. Используйте прокси только для имен хостов HTTP(S).

В настройках DNS Cloudflare установите запись A/AAAA на matrix.example.orgпубличный адрес вашего обратного прокси-сервера и пометьте её как «Проксированный». example.orgИмя хоста также должно быть доступно веб-серверу для файлов обнаружения. Удалите неиспользуемую запись AAAA. Оставьте записи MX, только для почты и не-HTTP только для DNS. Cloudflare завершает TLS на границе сети и открывает отдельное соединение с вашим источником.

Схематическая таблица DNS-записей отображает проксированные A-записи для example.org и matrix.example.org, с оранжевыми значками состояния в виде облака.
Настройте прокси-сервер для веб-хоста Matrix и имени хоста, используемого для обнаружения; храните почтовые записи только в DNS.

В настройках Cloudflare SSL/TLS выберите «Полный (строгий)». Исходный прокси-сервер должен принимать HTTPS на порту 443 и предоставлять действующий сертификат , выданный доверенным центром сертификации или центром сертификации Cloudflare Origin CA. Это шифрует и проверяет оба соединения; гибкий режим может оставить исходное соединение незашифрованным или вызвать циклы перенаправления. См. руководствоmatrix.example.org Cloudflare по настройке «Полный (строгий)» .

2. Передавайте запросы Matrix в Synapse без их перезаписи.

Настройте виртуальный хост HTTPS обратного прокси-сервера таким образом, чтобы matrix.example.orgон передавал пути, начинающиеся с /_matrixи , /_synapse/clientв Synapse в частной сети, обычно http://synapse:8008это делается в Compose. Сохраните полный путь запроса, перенаправьте исходный хост и установите X-Forwarded-Forи X-Forwarded-Proto. Эти маршруты включают вызовы API клиента и конечные точки федерации; избегайте отправки в Synapse только домашней страницы браузера или обрезки префикса пути.

Универсальный редактор конфигурации обратного прокси-сервера отображает пути API Matrix, перенаправляемые в Synapse через порт 8008, а также заголовок X-Forwarded-Proto.
Перенаправьте оба семейства путей Matrix API в Synapse, сохранив при этом путь запроса и заголовки пересылки.

В существующем HTTP-слушателе Synapse настройте его x_forwarded: trueтак, чтобы он считывал адрес клиента и схему из прокси. Не привязывайте контейнеризированный слушатель к , так как это блокирует доступ к нему для других контейнеров. Держите порт 8008 закрытым для Compose. Инструкции по обратному прокси127.0.0.1 Synapse содержат информацию о синтаксисе вашего конкретного прокси.

Публикуйте результаты поиска и предотвращайте кэширование API.

3. Укажите другим домашним серверам использовать порт 443.

Поскольку идентификаторы Matrix пользователей используются, example.orgкогда Synapse доступен по адресу matrix.example.org, предоставьте файл обнаружения федерации по адресу https://example.org/.well-known/matrix/server. Верните статус 200, содержимое JSON и следующее значение:

{"m.server":"matrix.example.org:443"}

Явная :443отправка удаленных домашних серверов на поддерживаемый проксируемый порт. Спецификация федерации Matrix определяет это m.serverделегирование. Если само имя сервера Synapse — matrix.example.org, то соответствующий общеизвестный файл следует отправлять туда или использовать serve_server_wellknownопцию Synapse, когда это имя хоста перенаправляет запрос в Synapse на порту 443.

Для автоматического обнаружения клиентов используйте https://example.org/.well-known/matrix/clientкоманду `sourcing` {"m.homeserver":{"base_url":"https://matrix.example.org"}}. Браузерным клиентам также необходимы заголовки CORS, требуемые спецификацией клиент-серверной архитектуры Matrix . Установите в Synapse public_baseurlзначение HTTPS-адреса, который должны вводить пользователи. См. спецификацию обнаружения сервера Matrix и справочник по настройке Synapse .

Редактор JSON отображает делегирование федерации m.server на matrix.example.org на порту 443 и базовый URL домашнего сервера клиента.
Обеспечьте делегирование федерации в домене Matrix ID и перенаправьте клиентов на URL-адрес домашнего сервера HTTPS.

4. Обходите кэш и избегайте проблем с браузером на путях протокола.

Создайте правило кэширования для matrix.example.orgсопоставления путей, начинающихся с /_matrix/или /_synapse/client/, и выберите «Обход кэширования» . Это защитит API входа в систему, синхронизации, федерации и мультимедиа от пользовательских правил кэширования всего. Проверьте также правила WAF, ботов и перенаправлений: клиенты Matrix не могут решить проблемы межстраничных сообщений браузера. Оставьте защиту включенной и ограничьте любое исключение путями протокола. Cloudflare описывает обход кэширования в инструкциях к своей панели управления .

Проверка извне вашей сети.

Выполните эти проверки с компьютера, находящегося за пределами локальной сети сервера, чтобы запрос следовал общедоступным DNS-серверам и Cloudflare:

В терминале отображаются результаты проверки curl для известного файла федерации Matrix и конечной точки версий клиента Synapse.
Проверьте обнаружение общедоступной федерации и клиентский API через имя хоста Cloudflare.
curl -i https://example.org/.well-known/matrix/server
curl -i https://example.org/.well-known/matrix/client
curl -i https://matrix.example.org/_matrix/client/versions
curl -i https://matrix.example.org/_matrix/federation/v1/version

Убедитесь, что первый запрос возвращает JSON с m.serverпараметром matrix.example.org:443, в клиентском файле указан базовый URL-адрес HTTPS, а два последних возвращают корректный JSON, а не страницу запроса Cloudflare, ошибку 404 или 502. Затем войдите в систему с клиентского компьютера и протестируйте синхронизацию комнаты, загрузите файл и выполните федерацию с комнатой на другом домашнем сервере. Серверы Matrix кэшируют ответы обнаружения федерации, поэтому удаленные серверы могут сохранять более раннее значение некоторое время после его изменения; используйте заголовки кэша ответа и дайте время для истечения срока действия кэшированных записей.

Если загрузка файлов завершается ошибкой HTTP 413, сравните размер файла с текущим лимитом загрузки зоны Cloudflare и лимитом Synapse max_upload_size; у обратного прокси также есть свой лимит тела запроса. В документации Synapse по умолчанию указано 50 МБ, а лимит тела запроса Nginx может быть ниже. Лимиты Cloudflare различаются в зависимости от тарифного плана и могут быть скорректированы в правилах плана, поэтому перед повышением лимита Synapse ознакомьтесь с документацией по текущим лимитам загрузки . Если API работает, но федерация не удается, сначала убедитесь, что общеизвестный URL-адрес сервера является публичным, его сертификат имени хоста действителен, а делегированный порт явно равен 443. Если вы намеренно сохраняете порт 8448, прекратите проксирование этой записи через стандартный DNS-прокси Cloudflare и используйте вместо этого прямое имя хоста федерации только через DNS.

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

Подключите Element Web к Keycloak через Synapse OIDC.

Настройте клиент Keycloak OIDC и провайдер Synapse, чтобы пользователи Element Web могли входить в систему через ваш сервер идентификации, не раскрывая секретные данные клиентов.

Настройте безопасное резервное копирование ключей элементов и перекрестную подпись.

Настройте безопасное резервное копирование ключей элементов и перекрестную подпись.

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

Остановите сбои памяти Matrix Synapse во время синхронизации клиента.

Диагностика сбоев, связанных с нехваткой памяти в Synapse во время синхронизации, безопасная настройка кэширования, выявление задержек запросов и проверка стабильного использования памяти.

Устранение ошибок TLS-сертификата Synapse Federation

Выявите причину сбоев сертификатов федерации Matrix и определите правильный сервер, восстановите цепочку TLS или доверие к центру сертификации, а также проверьте правильность решения без отключения проверок безопасности.

Безопасная установка сервера Synapse Matrix за Cloudflare.

Безопасная установка сервера Synapse Matrix за Cloudflare.

Маршрутизация клиентов Matrix и федерация через Cloudflare по протоколу HTTPS 443, сохранение обнаружения Synapse и предотвращение кэширования API-трафика или нарушения загрузки медиафайлов.

Безопасное восстановление 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, защищенной регистрацией и проверкой работоспособности домашнего сервера.