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

Чтобы присвоить комнате Matrix адрес, например , такой #support:example.com: , создайте локальный псевдоним комнаты на домашнем сервере, имя сервера которого настроено как example.com, а затем выберите этот псевдоним в качестве основного адреса комнаты в Element. Вам не нужна отдельная запись DNS для каждого псевдонима комнаты, но вы не можете изменить домен псевдонима существующего домашнего сервера, просто указав на него DNS-запись.

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

Псевдоним комнаты — это читаемый адрес, который соответствует постоянному идентификатору комнаты Matrix , обычно начинающемуся с !. Одна комната может иметь несколько псевдонимов, например , #support:example.comи #help:example.com, оба указывающие на одну и ту же комнату. Текст после двоеточия идентифицирует домашний сервер, ответственный за разрешение этого псевдонима, а не обязательно сервер, на котором размещены все участники.

Matrix определяет псевдонимы в формате #localpart:server-name. Для Synapse этот server_nameпараметр определяет домен, используемый для локально создаваемых адресов комнат, и в документации Synapse указано, что этот параметр нельзя изменить после первоначальной настройки. Если ваш существующий сервер называется matrix.example.com, Element не будет преобразовывать свои локальные псевдонимы в #support:example.comтолько потому, что вы являетесь владельцем example.com. См. спецификацию идентификаторов Matrix и руководство по настройке Synapse .

Проверьте предварительные условия

  • Рабочий домашний сервер Matrix: В этом примере предполагается, что Synapse уже обрабатывает запросы API клиентов по адресу , https://matrix.example.comа его настроенный server_nameадрес — example.com. URL-адрес клиента и имя сервера могут отличаться.
  • Существующая комната: при необходимости сначала создайте комнату. Выберите короткий, легко узнаваемый локальный псевдоним, например, ` support.`. Псевдоним должен быть уникальным на сервере, который его создает.
  • Разрешение на управление адресами: Войдите в систему с учетной записью, имеющей право создавать локальный псевдоним и изменять основной адрес комнаты. Политика создания псевдонимов сервера и уровни мощности комнаты могут ограничивать эти действия.
  • Способ проверки: Держите под рукой вторую учетную запись Matrix, желательно на другом домашнем сервере, чтобы вы могли проверять обнаружение независимо от вашей административной сессии.

Создайте псевдоним в элементе Web.

Указанный ниже путь соответствует терминологии настроек помещения в документации по настройкам помещений Element , проверенной в октябре 2026 года. Расположение пунктов меню может отличаться в разных версиях Element и других клиентах Matrix.

1. Откройте настройки комнаты.

В Element Web или Element Desktop откройте целевую комнату. Выберите «Настройки комнаты» на панели информации о комнате или воспользуйтесь меню с тремя точками и выберите «Настройки» . Если вам понадобится внутренний идентификатор комнаты для дальнейшего устранения неполадок, найдите его в разделе «Дополнительно» и скопируйте, не изменяя никаких символов.

2. Добавьте локальный адрес.

На странице общих настроек найдите «Адреса комнат» , затем «Локальные адреса» . Введите псевдоним localpart, например support, в поле «Адрес комнаты» , и выберите «Добавить» или аналогичную кнопку сохранения. Убедитесь, что полученный полный адрес — #support:example.com. Если он заканчивается на :matrix.example.com, остановитесь: это проблема с именем домашнего сервера, а не опечатка, которую можно исправить в настройках комнаты.

3. Выберите основной адрес.

В разделе «Адреса помещений» найдите «Опубликованные адреса» и установите «Основной адрес» в значение #support:example.com. В документации Element указано, что первый созданный локальный адрес обычно автоматически выбирается в качестве основного. Явный выбор этого адреса полезен, если у помещения уже есть несколько псевдонимов.

Основной адрес — это канонический псевдоним комнаты : предпочтительный адрес, отображаемый в состоянии комнаты. Создание псевдонима и выбор канонического псевдонима — это связанные, но разные действия. Matrix также поддерживает альтернативные отображаемые псевдонимы. Канонический псевдоним должен уже соответствовать данной комнате до того, как он будет отображен.

4. Решите, следует ли включить комнату в справочник.

Включайте опцию «Опубликовать эту комнату в общедоступном каталоге комнат» только в том случае, если вам действительно нужен доступ к каталогу. Указание адреса само по себе не делает комнату общедоступной, и публикация комнаты не зависит от правил присоединения к ней. В частной комнате или комнате, доступной только по приглашению, может быть запоминающийся псевдоним, но при этом не предоставлять всем желающим разрешение на присоединение. Для общедоступных комнат сообщества проверьте как настройки каталога, так и правила присоединения к комнате, прежде чем широко распространять адрес.

Используйте API Matrix, если клиент не может добавить адрес.

Администраторы и инструменты автоматизации могут использовать стандартный API Matrix Client-Server . Приведенный ниже пример создает тот же псевдоним; не запускайте его, если Element уже создан #support:example.com. Замените реальный идентификатор комнаты и действительный токен доступа на пользователя, разрешенного политикой псевдонимов домашнего сервера. Рассматривайте токен как пароль.

curl --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{"room_id":"!yourRoomId:example.com"}' \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

Успешный запрос возвращает HTTP-запрос 200с пустым JSON-объектом. Части %23и %3Aпредставляют собой URL-кодирование для #и :. Запрос PUT создает сопоставление псевдонима с комнатой; он не обязательно изменяет канонический псевдоним комнаты. После создания только через API вернитесь к элементу управления «Основной адрес» в Element , если хотите, чтобы этот псевдоним был объявлен как основной. Не вставляйте реальный токен bearer в общую команду оболочки, скриншот или заявку в службу поддержки.

Убедитесь, что сопоставление корректно.

Для поиска в каталоге не требуется авторизация. Замените URL-адрес хоста на собственную доступную конечную точку API клиента:

curl --fail-with-body --silent --show-error \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

В ответе должны содержаться данные, room_idсоответствующие целевой комнате, и serversмассив. Это проверяет разрешение псевдонимов, а не возможность федеративного взаимодействия каждого удаленного сервера с вашим.

Устраните распространённые ошибки.

Псевдоним имеет неправильный домен.

Проверьте настроенный в Synapse параметр server_name. Не изменяйте это значение на уже работающем сервере, пытаясь изменить его псевдонимы: от него зависит его идентичность и существующие идентификаторы Matrix. Для нового развертывания спланируйте желаемое имя сервера до создания пользователей и комнат. Если вы уже работаете под другим именем, использование его фактического домена-псевдонима может быть более безопасным вариантом, если только вы не можете организовать соответствующий домашний сервер, который будет владеть новыми псевдонимами.

Создание приложения завершается ошибкой 403 или 409.

HTTP 403обычно указывает на отказ в доступе или на применимую политику сервера. Проверьте права доступа пользователя к комнате и правила Synapse alias_creation_rules; правила оцениваются по порядку, а явно пустой список предотвращает создание псевдонимов. HTTP 409означает, что псевдоним уже существует. Выберите другой локальный раздел или изучите существующее сопоставление, вместо того чтобы перезаписывать его вслепую. В руководстве по настройке Synapse описаны параметры политики псевдонимов.

Игроки на других серверах не могут найти комнату.

Сначала убедитесь, что псевдоним разрешается локально. Если локальный поиск проходит успешно, но внешнее обнаружение не удается, проверьте федерацию для домена псевдонима , включая сертификаты HTTPS, соответствующее /.well-known/matrix/serverделегирование и открытый слушатель федерации. Имя хоста, используемое для клиентского трафика, не устанавливает автоматически федерацию для другого имени сервера Matrix. API Matrix Server-Server описывает обнаружение и делегирование серверов. Также убедитесь, что удаленным пользователям разрешено присоединяться; комната, доступная только по приглашению, может успешно разрешиться, но при этом отказать в присоединении.

Проверьте адрес пользовательской комнаты.

  1. Убедитесь, что этот параметр #support:example.comотображается в разделе «Локальные адреса» и в качестве предполагаемого основного адреса в элементе.
  2. Выполните указанный выше GET-запрос к каталогу без аутентификации и сравните его room_idс идентификатором, отображаемым в расширенных настройках комнаты Element.
  3. Попробуйте открыть ссылку с другого аккаунта https://matrix.to/#/%23support%3Aexample.com. Она должна вести в нужную комнату; возможность присоединения к комнате по-прежнему зависит от правил доступа к ней.

В справочнике Matrix по псевдонимам комнат и формату matrix.to определяется формат закодированной ссылки для общего доступа. Если все три проверки пройдены успешно, новый адрес готов к использованию, а исходный идентификатор комнаты остается неизменным.

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

Настройте собственный псевдоним для комнаты 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 для нужной службы или рабочего процесса и проверьте текущий лимит.

На экране отображается сообщение «Не удалось расшифровать»? Восстановите отсутствующий ключ от комнаты.

На экране отображается сообщение «Не удалось расшифровать»? Восстановите отсутствующий ключ от комнаты.

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

Удалите старые сообщения и медиафайлы Synapse без потери данных.

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

Создайте эхо-бота на основе матрицы на Python с помощью библиотеки Simple-Matrix-Bot-Lib.

Создайте эхо-бота на основе матрицы на Python с помощью библиотеки Simple-Matrix-Bot-Lib.

Установите текущую библиотеку, подключите выделенную учетную запись Matrix и запустите небольшой бот !echo с более безопасной обработкой учетных данных и понятным тестом.

Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Настройте три моста Mautrix с отдельными регистрациями, входами в систему и тестами — и избегайте неожиданностей, связанных с сетевыми настройками Docker, политиками учетных записей и синхронизацией.

Освободите место на диске Synapse Media, не нарушая работу общих файлов.

Узнайте, что заполняет хранилище Synapse, установите безопасное время хранения медиафайлов и очистите удаленный кэш, не удаляя файлы непосредственно с диска.