Настройте собственный псевдоним для комнаты Matrix в своем домене.
Присвойте комнате Matrix легкодоступный адрес в вашем домене, используя Element или API Matrix, с проверкой прав доступа, именованием Synapse и федерацией.
Чтобы присвоить комнате 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 .
https://matrix.example.comа его настроенный server_nameадрес — example.com. URL-адрес клиента и имя сервера могут отличаться.support.`. Псевдоним должен быть уникальным на сервере, который его создает.Указанный ниже путь соответствует терминологии настроек помещения в документации по настройкам помещений Element , проверенной в октябре 2026 года. Расположение пунктов меню может отличаться в разных версиях Element и других клиентах Matrix.
В Element Web или Element Desktop откройте целевую комнату. Выберите «Настройки комнаты» на панели информации о комнате или воспользуйтесь меню с тремя точками и выберите «Настройки» . Если вам понадобится внутренний идентификатор комнаты для дальнейшего устранения неполадок, найдите его в разделе «Дополнительно» и скопируйте, не изменяя никаких символов.
На странице общих настроек найдите «Адреса комнат» , затем «Локальные адреса» . Введите псевдоним localpart, например support, в поле «Адрес комнаты» , и выберите «Добавить» или аналогичную кнопку сохранения. Убедитесь, что полученный полный адрес — #support:example.com. Если он заканчивается на :matrix.example.com, остановитесь: это проблема с именем домашнего сервера, а не опечатка, которую можно исправить в настройках комнаты.
В разделе «Адреса помещений» найдите «Опубликованные адреса» и установите «Основной адрес» в значение #support:example.com. В документации Element указано, что первый созданный локальный адрес обычно автоматически выбирается в качестве основного. Явный выбор этого адреса полезен, если у помещения уже есть несколько псевдонимов.
Основной адрес — это канонический псевдоним комнаты : предпочтительный адрес, отображаемый в состоянии комнаты. Создание псевдонима и выбор канонического псевдонима — это связанные, но разные действия. 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. Для нового развертывания спланируйте желаемое имя сервера до создания пользователей и комнат. Если вы уже работаете под другим именем, использование его фактического домена-псевдонима может быть более безопасным вариантом, если только вы не можете организовать соответствующий домашний сервер, который будет владеть новыми псевдонимами.
HTTP 403обычно указывает на отказ в доступе или на применимую политику сервера. Проверьте права доступа пользователя к комнате и правила Synapse alias_creation_rules; правила оцениваются по порядку, а явно пустой список предотвращает создание псевдонимов. HTTP 409означает, что псевдоним уже существует. Выберите другой локальный раздел или изучите существующее сопоставление, вместо того чтобы перезаписывать его вслепую. В руководстве по настройке Synapse описаны параметры политики псевдонимов.
Сначала убедитесь, что псевдоним разрешается локально. Если локальный поиск проходит успешно, но внешнее обнаружение не удается, проверьте федерацию для домена псевдонима , включая сертификаты HTTPS, соответствующее /.well-known/matrix/serverделегирование и открытый слушатель федерации. Имя хоста, используемое для клиентского трафика, не устанавливает автоматически федерацию для другого имени сервера Matrix. API Matrix Server-Server описывает обнаружение и делегирование серверов. Также убедитесь, что удаленным пользователям разрешено присоединяться; комната, доступная только по приглашению, может успешно разрешиться, но при этом отказать в присоединении.
#support:example.comотображается в разделе «Локальные адреса» и в качестве предполагаемого основного адреса в элементе.room_idс идентификатором, отображаемым в расширенных настройках комнаты Element.https://matrix.to/#/%23support%3Aexample.com. Она должна вести в нужную комнату; возможность присоединения к комнате по-прежнему зависит от правил доступа к ней.В справочнике Matrix по псевдонимам комнат и формату matrix.to определяется формат закодированной ссылки для общего доступа. Если все три проверки пройдены успешно, новый адрес готов к использованию, а исходный идентификатор комнаты остается неизменным.
Присвойте комнате Matrix легкодоступный адрес в вашем домене, используя Element или API Matrix, с проверкой прав доступа, именованием Synapse и федерацией.
Настройте coturn и Synapse с использованием совпадающих учетных данных TURN, откройте необходимые порты ретрансляции и убедитесь, что клиенты Matrix могут получать кандидатов на ретрансляцию.
Перед тем как сделать его доступным по HTTPS, настройте постоянный домашний сервер Synapse с помощью Docker Compose, PostgreSQL, частной конфигурации и проверок.
Задайте фирменное название, пользовательские цвета и элементы авторизации для вашей веб-версии Element, при этом понимая, какие части останутся фирменными.
Проверьте, не превысил ли Synapse лимит на количество открытых файлов в одном процессе, установите параметр systemd для нужной службы или рабочего процесса и проверьте текущий лимит.
Выясните, ограничивается ли ошибка одним браузером или одним событием, затем используйте ключ восстановления Element или доверенное устройство, не рискуя при этом оставшейся зашифрованной историей.
Используйте API Synapse для очистки истории и мультимедиа или настройки хранения данных, чтобы безопасно удалить устаревшие данные, а затем проверьте завершение процесса и восстановление дискового пространства.
Установите текущую библиотеку, подключите выделенную учетную запись Matrix и запустите небольшой бот !echo с более безопасной обработкой учетных данных и понятным тестом.
Настройте три моста Mautrix с отдельными регистрациями, входами в систему и тестами — и избегайте неожиданностей, связанных с сетевыми настройками Docker, политиками учетных записей и синхронизацией.
Узнайте, что заполняет хранилище Synapse, установите безопасное время хранения медиафайлов и очистите удаленный кэш, не удаляя файлы непосредственно с диска.