Om een Matrix-kamer een adres te geven zoals #support:example.com, maak je een lokale kameralias aan op de homeserver waarvan de geconfigureerde servernaam is example.com, en selecteer je vervolgens die alias als het hoofdadres van de kamer in Element. Je hebt geen apart DNS-record nodig voor elke kameralias, maar je kunt het domein van een bestaande homeserveralias niet wijzigen door er simpelweg een DNS-record naar te laten verwijzen.
Begrijp welke controle het aangepaste domein uitoefent.
Een kameralias is een leesbaar adres dat verwijst naar de permanente kamer-ID van een Matrix-kamer , een identificatiecode die meestal begint met !. Eén kamer kan meerdere aliassen hebben, bijvoorbeeld #support:example.comen #help:example.com, die beide naar dezelfde kamer verwijzen. De tekst na de dubbele punt identificeert de homeserver die verantwoordelijk is voor het oplossen van die alias, niet noodzakelijkerwijs de server waarop alle deelnemers draaien.
Matrix definieert aliassen in de vorm <domeinnaam> #localpart:server-name. Voor Synapse server_namebepaalt deze instelling het domein dat wordt gebruikt voor lokaal aangemaakte ruimteadressen. Synapse documenteert dat deze instelling na de eerste installatie niet meer kan worden gewijzigd. Als uw bestaande server de naam <domeinnaam> heeft matrix.example.com, zal Element de lokale aliassen niet wijzigen in <domeinnaam> #support:example.comalleen omdat u <domeinnaam> bezit example.com. Zie de Matrix-identificatiespecificatie en de Synapse-configuratiehandleiding .
Controleer de vereisten
- Een werkende Matrix-homeserver: Dit voorbeeld gaat ervan uit dat Synapse al client-API-verzoeken afhandelt op ,
https://matrix.example.comterwijl de configuratie server_nameis example.com. De client-URL en de servernaam kunnen verschillen.
- Een bestaande ruimte: Maak de ruimte eerst aan indien nodig. Kies een korte, herkenbare alias voor het lokale gedeelte, bijvoorbeeld
support. Een alias moet uniek zijn op de server die deze aanmaakt.
- Toestemming om adressen te beheren: Meld u aan met een account dat gemachtigd is om de lokale alias aan te maken en het hoofdadres van de ruimte te wijzigen. Het alias-aanmaakbeleid van een server en de bevoegdheden van de ruimte kunnen deze acties beperken.
- Een manier om dit te testen: houd een tweede Matrix-account beschikbaar, bij voorkeur op een andere thuisserver, zodat u de detectie onafhankelijk van uw beheerderssessie kunt controleren.
Maak een alias aan in Element Web.
Het volgende pad komt overeen met de terminologie voor ruimte-instellingen in de Element-documentatie voor ruimte-instellingen, gecontroleerd in oktober 2026. Menuposities kunnen verschillen tussen Element-versies en andere Matrix-clients.
1. Open de kamerinstellingen.
Open de gewenste ruimte in Element Web of Element Desktop. Selecteer Ruimte-instellingen in het paneel Ruimte-informatie, of gebruik het menu met de drie puntjes van de ruimte en kies Instellingen . Als u de interne ruimte-ID later nodig hebt voor het oplossen van problemen, kijk dan in het gedeelte Geavanceerd en kopieer deze zonder tekens te wijzigen.
2. Voeg een lokaal adres toe
Ga naar de pagina Algemene instellingen, zoek Kameradressen en vervolgens Lokale adressen . Voer de alias localpart, bijvoorbeeld support, in het veld Kameradres in en selecteer Toevoegen of de overeenkomstige knop Opslaan. Controleer of het resulterende volledige adres . is #support:example.com. Als het in plaats daarvan eindigt op :matrix.example.com, stop dan: dat is een probleem met de homeservernaam, geen typefout die de kamerinstellingen kunnen corrigeren.
3. Kies het hoofdadres
Ga naar 'Kameradressen' , zoek 'Gepubliceerde adressen' en stel 'Hoofdadres' in op #support:example.com. Volgens de documentatie van Element wordt het eerst aangemaakte lokale adres normaal gesproken automatisch als hoofdadres geselecteerd. Het expliciet selecteren ervan is handig wanneer de kamer al meerdere aliassen heeft.
Het hoofdadres is de canonieke alias van de kamer : het voorkeursadres dat in de kamerstatus wordt geadverteerd. Het aanmaken van een alias en het kiezen van de canonieke alias zijn verwante, maar afzonderlijke acties. Matrix ondersteunt ook alternatieve geadverteerde aliassen. Een canonieke alias moet al naar die kamer verwijzen voordat deze wordt geadverteerd.
4. Bepaal of de kamer in een adresboek thuishoort.
Schakel ' Deze kamer publiceren in de openbare kamerdirectory' alleen in als u daadwerkelijk wilt dat de kamer in de directory wordt gevonden. Het instellen van een adres maakt een kamer op zich niet openbaar, en het publiceren van een kamer staat los van de toelatingsregels. Een privé- of uitnodigingskamer kan een makkelijk te onthouden alias hebben zonder dat iedereen toegang krijgt. Controleer voor openbare communitykamers zowel de directory-instelling als de toelatingsregels van de kamer voordat u het adres breed deelt.
Gebruik de Matrix API als de client het adres niet kan toevoegen.
Beheerders en automatiseringstools kunnen de standaard Matrix Client-Server API gebruiken . Het onderstaande voorbeeld maakt dezelfde alias aan; voer dit niet#support:example.com uit als Element al is aangemaakt . Vervang de echte kamer-ID en een geldig toegangstoken door een gebruiker die is toegestaan volgens het aliasbeleid van de homeserver. Beschouw het token als een wachtwoord.
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'
Een succesvol verzoek retourneert HTTP 200met een leeg JSON-object. De %23en %3Adelen zijn URL-codering voor #en :. Het PUT-verzoek creëert een koppeling tussen alias en kamer; het wijzigt niet noodzakelijkerwijs de canonieke alias van de kamer. Na een API-only aanmaak, ga terug naar de 'Main Address'- besturing van Element als u wilt dat die alias als primaire alias wordt geadverteerd. Plak geen echt bearer-token in een gedeelde shell-opdracht, screenshot of supportticket.
Controleer of de mapping correct is opgelost.
Voor het opzoeken in de directory is geen login vereist. Vervang de URL-host door uw eigen toegankelijke client-API-eindpunt:
curl --fail-with-body --silent --show-error \
'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'
Het antwoord moet een room_idovereenkomende bestemmingsruimte en een serversarray bevatten. Dit test de aliasresolutie, niet of elke externe server met de jouwe kan federeren.
Los de veelvoorkomende fouten op.
De alias heeft het verkeerde domein.
Controleer de geconfigureerde Synapse-instellingen server_name. Wijzig deze waarde niet op een bestaande server in een poging om de aliassen te hernoemen: de identiteit en bestaande Matrix-identificaties zijn ervan afhankelijk. Plan voor een nieuwe implementatie de gewenste servernaam voordat u gebruikers en kamers aanmaakt. Als u al onder een andere naam werkt, is het gebruik van het daadwerkelijke aliasdomein wellicht de veiligere keuze, tenzij u een homeserver met een geschikte naam kunt regelen die de nieuwe aliassen beheert.
Aanmaak mislukt met foutcode 403 of 409.
HTTP 403geeft doorgaans aan dat de toegang is geweigerd of dat er een serverbeleid van toepassing is. Controleer de kamerrechten van de gebruiker en de regels van Synapse alias_creation_rules; deze worden in volgorde geëvalueerd en een expliciet lege lijst voorkomt het aanmaken van aliassen. HTTP 409betekent dat de alias al bestaat. Kies een andere localpart of onderzoek de bestaande toewijzing in plaats van deze blindelings te overschrijven. De configuratiehandleiding van Synapse beschrijft de opties voor het aliasbeleid.
Mensen op andere servers kunnen de kamer niet vinden.
Controleer eerst of de alias lokaal correct wordt opgelost. Als de lokale opzoeking lukt, maar de externe detectie mislukt, inspecteer dan de federatie voor het aliasdomein , inclusief HTTPS-certificaten, de relevante /.well-known/matrix/serverdelegatie en de blootgestelde federatielistener. Een hostnaam die wordt gebruikt voor clientverkeer, zorgt niet automatisch voor federatie met een andere Matrix-servernaam. De Matrix Server-Server API beschrijft serverdetectie en delegatie. Controleer ook of externe gebruikers toegang hebben; een ruimte die alleen toegankelijk is op uitnodiging kan succesvol worden opgelost, terwijl deelname wordt geweigerd.
Controleer het aangepaste kameradres.
- Controleer of dit
#support:example.comonder Lokale adressen en als het beoogde hoofdadres in Element wordt weergegeven.
- Voer de bovenstaande GET-aanvraag voor de directory zonder authenticatie uit en vergelijk de uitkomst
room_idmet de ID die wordt weergegeven in de geavanceerde kamerinstellingen van Element.
- Probeer vanuit een ander account de pagina te openen
https://matrix.to/#/%23support%3Aexample.com. De link zou naar de gewenste chatroom moeten leiden; of het account daadwerkelijk kan deelnemen, hangt echter nog af van de toegangsregels van de chatroom.
De referentie voor de kameralias en matrix.to-indeling van Matrix definieert het gecodeerde formaat van de deelbare link. Als alle drie de controles slagen, is het nieuwe adres klaar om te delen, terwijl de oorspronkelijke kamer-ID ongewijzigd blijft.