Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Aby nadać pokojowi w systemie Matrix adres taki jak #support:example.com, utwórz lokalny alias pokoju na serwerze domowym, którego skonfigurowana nazwa serwera to example.com, a następnie wybierz ten alias jako główny adres pokoju w programie Element. Nie potrzebujesz osobnego rekordu DNS dla każdego aliasu pokoju, ale nie możesz zmienić domeny aliasu istniejącego serwera domowego, po prostu wskazując go za pomocą DNS.

Zrozum, co kontroluje domena niestandardowa

Alias ​​pokoju to czytelny adres, który odpowiada stałemu identyfikatorowi pokoju w systemie Matrix , zazwyczaj rozpoczynającemu się od !. Jeden pokój może mieć wiele aliasów, na przykład #support:example.com□ i □ #help:example.com, oba wskazujące na ten sam pokój. Tekst po dwukropku identyfikuje serwer domowy odpowiedzialny za rozwiązanie tego aliasu, niekoniecznie serwer obsługujący wszystkich uczestników.

Matrix definiuje aliasy w formacie #localpart:server-name. W przypadku Synapse to server_nameustawienie określa domenę używaną dla lokalnie tworzonych adresów pokoi, a Synapse dokumentuje, że tego ustawienia nie można zmienić po początkowej konfiguracji. Jeśli Twój istniejący serwer nazywa się matrix.example.com, Element nie zmieni jego lokalnych aliasów na , #support:example.componieważ jesteś właścicielem example.com. Zapoznaj się ze specyfikacją identyfikatora Matrix i instrukcją konfiguracji Synapse .

Sprawdź wymagania wstępne

  • Działający serwer domowy Matrix: W tym przykładzie założono, że Synapse obsługuje już żądania API klienta, https://matrix.example.compodczas gdy jego konfiguracja server_nameto example.com. Adres URL klienta i nazwa serwera mogą się różnić.
  • Istniejący pokój: W razie potrzeby najpierw utwórz pokój. Wybierz krótki, rozpoznawalny alias localpart, taki jak support. Alias ​​musi być unikatowy na serwerze, który go tworzy.
  • Uprawnienia do zarządzania adresami: Zaloguj się na konto z uprawnieniami do tworzenia aliasów lokalnych i zmiany głównego adresu pokoju. Zasady tworzenia aliasów na serwerze i poziomy mocy pokoju mogą ograniczać te działania.
  • Sposób przeprowadzenia testu: Utrzymuj drugie konto Matrix, najlepiej na innym serwerze domowym, dzięki czemu będziesz mógł sprawdzić wykrywanie niezależnie od sesji administratora.

Utwórz alias w Element Web

Poniższa ścieżka jest zgodna z terminologią ustawień pomieszczeń w dokumentacji ustawień pomieszczeń Element sprawdzonej w październiku 2026 r. Pozycje menu mogą się różnić w zależności od wersji Element i innych klientów Matrix.

1. Otwórz Ustawienia pokoju

W Element Web lub Element Desktop otwórz pokój docelowy. Wybierz „Ustawienia pokoju” w panelu informacji o pokoju lub skorzystaj z menu z trzema kropkami przy pokoju i wybierz „Ustawienia” . Jeśli będziesz potrzebować wewnętrznego identyfikatora pokoju do późniejszego rozwiązania problemu, sprawdź sekcję „Zaawansowane” i skopiuj go bez zmiany znaków.

2. Dodaj adres lokalny

Na stronie Ustawienia ogólne znajdź Adresy pomieszczeń , a następnie Adresy lokalnesupport . W polu Adres pomieszczenia wpisz alias localpart, taki jak , i wybierz Dodaj lub równoważny element sterujący. Sprawdź, czy wynikowy pełny adres to #support:example.com. Jeśli zamiast tego kończy się na :matrix.example.com, zatrzymaj: to problem z nazwą serwera domowego, a nie literówka, którą można poprawić w ustawieniach pomieszczenia.

3. Wybierz adres główny

W sekcji „Adresy pokoi” znajdź „Opublikowane adresy” i ustaw „Adres główny” na #support:example.com„. Dokumentacja Elementu podaje, że pierwszy utworzony adres lokalny jest zazwyczaj automatycznie wybierany jako adres główny. Wybranie go jawnie jest przydatne, gdy pokój ma już kilka aliasów.

Adres główny to kanoniczny alias pokoju : preferowany adres reklamowany w stanie pokoju. Tworzenie aliasu i wybór aliasu kanonicznego to powiązane, ale odrębne czynności. Matrix obsługuje również alternatywne aliasy reklamowane. Alias ​​kanoniczny powinien być już przypisany do danego pokoju przed jego reklamowaniem.

4. Zdecyduj, czy pokój należy do katalogu

Włącz opcję „Publikuj ten pokój w katalogu pokoi publicznych” tylko wtedy, gdy faktycznie chcesz, aby był on dostępny do wyszukiwania w katalogu. Ustawienie adresu samo w sobie nie czyni pokoju publicznym, a opublikowanie pokoju jest niezależne od zasad dołączania do niego. Pokój prywatny lub dostępny tylko na zaproszenie może mieć łatwy do zapamiętania alias bez udzielania wszystkim uprawnień do dołączania. W przypadku publicznych pokoi społecznościowych sprawdź zarówno ustawienia katalogu, jak i zasady dołączania do pokoju przed szerokim udostępnieniem adresu.

Użyj interfejsu API Matrix, jeśli klient nie może dodać adresu

Administratorzy i narzędzia automatyzacji mogą korzystać ze standardowego interfejsu API Matrix Client-Server . Poniższy przykład tworzy ten sam alias; nie uruchamiaj go, jeśli element jest już utworzony #support:example.com. Zastąp rzeczywiste ID pokoju i prawidłowy token dostępu użytkownikiem dozwolonym przez politykę aliasów serwera domowego. Traktuj token jak hasło.

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'

Pomyślne żądanie zwraca HTTP 200z pustym obiektem JSON. Części %23i %3Ato kodowanie URL dla #i :. Żądanie PUT tworzy mapowanie aliasu na pokój; nie zmienia ono koniecznie kanonicznego aliasu pokoju. Po utworzeniu tylko dla API, wróć do kontrolki adresu głównego elementu , jeśli chcesz, aby ten alias był reklamowany jako główny. Nie wklejaj prawdziwego tokena nośnika do współdzielonego polecenia powłoki, zrzutu ekranu ani zgłoszenia do pomocy technicznej.

Sprawdź, czy mapowanie zostało rozwiązane

Wyszukiwanie w katalogu nie wymaga logowania. Zastąp hosta URL własnym, dostępnym punktem końcowym API klienta:

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

Odpowiedź powinna zawierać room_idpasujący pokój docelowy i serverstablicę. To testuje rozpoznawanie aliasów, a nie to, czy każdy serwer zdalny może się z nim sfederować.

Rozwiąż typowe awarie

Alias ​​ma niewłaściwą domenę

Sprawdź konfigurację Synapse server_name. Nie zmieniaj tej wartości na istniejącym serwerze, próbując zmienić jego aliasy: jego tożsamość i istniejące identyfikatory Matrix zależą od niej. W przypadku nowego wdrożenia zaplanuj pożądaną nazwę serwera przed utworzeniem użytkowników i pokoi. Jeśli działasz już pod inną nazwą, użycie jej faktycznej domeny aliasu może być bezpieczniejszym wyborem, chyba że możesz zorganizować odpowiednio nazwany serwer domowy, który będzie właścicielem nowych aliasów.

Tworzenie kończy się niepowodzeniem z powodu błędu 403 lub 409

HTTP 403zazwyczaj oznacza odmowę dostępu lub obowiązującą politykę serwera. Sprawdź uprawnienia użytkownika i reguły Synapse alias_creation_rules; reguły są sprawdzane po kolei, a jawnie pusta lista uniemożliwia tworzenie aliasów. HTTP 409oznacza, że ​​alias już istnieje. Wybierz inną część lokalną lub sprawdź istniejące mapowanie, zamiast nadpisywać je bezmyślnie. Podręcznik konfiguracji Synapse opisuje opcje polityki aliasów.

Osoby na innych serwerach nie mogą znaleźć pokoju

Najpierw sprawdź, czy alias jest lokalnie rozpoznawany. Jeśli wyszukiwanie lokalne się powiedzie, ale wyszukiwanie zewnętrzne się nie powiedzie, sprawdź federację pod kątem domeny aliasu , w tym certyfikatów HTTPS, odpowiedniej /.well-known/matrix/serverdelegacji oraz ujawnionego odbiornika federacji. Nazwa hosta używana dla ruchu klienta nie ustanawia automatycznie federacji dla innej nazwy serwera Matrix. Interfejs API Matrix Server-Server opisuje wyszukiwanie i delegowanie serwerów. Sprawdź również, czy użytkownicy zdalni mogą dołączać; pokój dostępny tylko na zaproszenie może zostać pomyślnie rozpoznany, ale odrzuca dołączenie.

Zweryfikuj adres pokoju niestandardowego

  1. Zaznacz, aby #support:example.comwyświetlić adres w sekcji Adresy lokalne i wskazać adres główny w sekcji Element.
  2. Uruchom powyższe żądanie GET dotyczące nieuwierzytelnionego katalogu i porównaj je room_idz identyfikatorem wyświetlonym w zaawansowanych ustawieniach pokoju Element.
  3. Z innego konta spróbuj otworzyć https://matrix.to/#/%23support%3Aexample.com. Link powinien prowadzić do oczekiwanego pokoju; to, czy konto będzie mogło dołączyć, zależy nadal od zasad dostępu do pokoju.

Alias ​​pokoju i referencja formatu matrix.to w Matrix definiują zakodowany format linku do udostępniania. Jeśli wszystkie trzy sprawdzenia zakończą się sukcesem, nowy adres będzie gotowy do udostępniania, a pierwotny identyfikator pokoju pozostanie niezmieniony.

Zostaw komentarz

Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Nadaj pokojowi Matrix łatwy do udostępniania adres w swojej domenie, korzystając z Element lub interfejsu API Matrix, ze sprawdzaniem uprawnień, nazewnictwem Synapse i federacją.

Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

Skonfiguruj coturn i Synapse przy użyciu zgodnych poświadczeń TURN, otwórz wymagane porty przekaźnikowe i sprawdź, czy klienci Matrix mogą uzyskać kandydatów na przekaźniki.

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Skonfiguruj trwały serwer domowy Synapse z Docker Compose, PostgreSQL, prywatną konfiguracją i sprawdź, czy jest on udostępniany przez HTTPS.

Dostosuj motyw i branding Element Web

Ustaw nazwę marki, niestandardowe kolory i zasoby logowania dla wdrożenia Element Web, pamiętając jednocześnie, które części pozostaną markowe dla Element.

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.

Oczyść stare wiadomości i media Synapse bez utraty danych

Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.

Odzyskaj miejsce na dysku Synapse Media bez naruszania współdzielonych plików

Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.