Configurați un alias personalizat pentru camera matricei pe propriul domeniu

Pentru a da unei camere Matrix o adresă precum #support:example.com, creați un alias de cameră locală pe serverul de domiciliu al cărui nume de server configurat este example.com, apoi selectați acel alias ca adresă principală a camerei în Element. Nu aveți nevoie de o înregistrare DNS separată pentru fiecare alias de cameră, dar nu puteți modifica domeniul alias al unui server de domiciliu existent doar prin direcționarea DNS către acesta.

Înțelegeți ce controlează domeniul personalizat

Un alias de cameră este o adresă lizibilă care se rezolvă la ID-ul permanent al camerei Matrix , un identificator care începe de obicei cu !. O cameră poate avea mai multe aliasuri, de exemplu #support:example.comși #help:example.com, ambele indicând aceeași cameră. Textul de după două puncte identifică serverul principal responsabil pentru rezolvarea acelui alias, nu neapărat serverul care găzduiește fiecare participant.

Matrix definește aliasurile sub forma #localpart:server-name. Pentru Synapse, server_namesetarea determină domeniul utilizat pentru adresele de camere create local, iar Synapse documentează că această setare nu poate fi modificată după configurarea inițială. Dacă serverul existent este numit matrix.example.com, Element nu va transforma aliasurile sale locale în #support:example.comdoar pentru că dețineți example.com. Consultați specificația identificatorului Matrix și manualul de configurare Synapse .

Verificați cerințele preliminare

  • Un server de acasă Matrix funcțional: Acest exemplu presupune că Synapse deservește deja cererile API ale clientului la https://matrix.example.comîn timp ce configurația sa server_nameeste example.com. Adresa URL a clientului și numele serverului pot fi diferite.
  • O cameră existentă: Creați mai întâi camera, dacă este necesar. Alegeți un alias scurt și recognoscibil, cum ar fi localpart, cum ar fi support. Un alias trebuie să fie unic pe serverul care îl creează.
  • Permisiune de gestionare a adreselor: Conectați-vă cu un cont autorizat să creeze aliasul local și să modifice adresa principală a sălii. Politica de creare a aliasurilor unui server și nivelurile de alimentare ale sălii pot restricționa aceste acțiuni.
  • O modalitate de testare: Păstrați disponibil un al doilea cont Matrix, ideal pe un alt server de acasă, astfel încât să puteți verifica descoperirea independent de sesiunea de administrator.

Creați aliasul în Element Web

Următoarea cale corespunde terminologiei setărilor camerei din documentația setărilor camerei Element verificată în octombrie 2026. Pozițiile meniului pot diferi între versiunile Element și alți clienți Matrix.

1. Deschideți Setările Camerei

În Element Web sau Element Desktop, deschideți camera de destinație. Selectați Setări cameră din panoul Informații cameră sau utilizați meniul cu trei puncte al camerei și alegeți Setări . Dacă aveți nevoie de ID-ul intern al camerei pentru depanare ulterioară, consultați secțiunea Avansat și copiați-l fără a modifica niciun caracter.

2. Adăugați o adresă locală

Pe pagina Setări generale , găsiți Adrese camere , apoi Adrese locale . Introduceți aliasul localpart, cum ar fi support, în câmpul Adresă cameră și selectați Adăugare sau controlul de salvare echivalent. Confirmați că adresa completă rezultată este #support:example.com. Dacă se termină în :matrix.example.com, stop: aceasta este o problemă de nume a serverului de domiciliu, nu o greșeală de scriere pe care setările camerei o pot corecta.

3. Alegeți adresa principală

Tot sub Adrese camere , găsiți Adrese publicate și setați Adresă principală la #support:example.com. Documentația elementului precizează că prima adresă locală creată este selectată în mod normal automat ca adresă principală. Selectarea explicită a acesteia este utilă atunci când camera are deja mai multe aliasuri.

Adresa principală este aliasul canonic al camerei : adresa preferată anunțată în starea camerei. Crearea unui alias și alegerea aliasului canonic sunt acțiuni corelate, dar distincte. Matrix acceptă, de asemenea, aliasuri anunțate alternative. Un alias canonic ar trebui să se rezolve deja în camera respectivă înainte de a fi anunțat.

4. Decideți dacă camera aparține unui director

Activează opțiunea Publică această cameră în directorul camerelor publice doar atunci când dorești cu adevărat ca directoarele să fie descoperite. Setarea unei adrese nu face ca o cameră să fie publică în sine, iar publicarea unei camere este separată de regulile sale de alăturare. O cameră privată sau doar pe care se poate participa la invitație poate avea un alias ușor de reținut fără a acorda tuturor permisiunea de a se alătura. Pentru camerele publice ale comunității, verifică atât setările directorului, cât și regulile de alăturare ale camerei înainte de a partaja adresa pe scară largă.

Utilizați API-ul Matrix dacă clientul nu poate adăuga adresa

Administratorii și instrumentele de automatizare pot utiliza API-ul standard Matrix Client-Server . Exemplul de mai jos creează același alias; nu îl rulați dacă elementul a fost deja creat #support:example.com. Înlocuiți ID-ul real al camerei și un token de acces valid pentru un utilizator permis de politica de alias a serverului de acasă. Tratați token-ul ca o parolă.

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'

O solicitare reușită returnează HTTP 200cu un obiect JSON gol. Părțile %23`and` %3Asunt codificare URL pentru #`and` :. Cererea PUT creează o mapare alias-cameră; nu modifică neapărat aliasul canonic al camerei. După o creare exclusivă prin API, reveniți la controlul Adresă principală al elementului dacă doriți ca acel alias să fie promovat ca fiind cel principal. Nu lipiți un token de purtător real într-o comandă shell partajată, o captură de ecran sau un tichet de asistență.

Verificați dacă maparea rezolvă

Căutarea în director nu necesită date de autentificare. Înlocuiți gazda URL cu propriul punct final API client accesibil:

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

Răspunsul ar trebui să conțină o room_idcameră de destinație corespunzătoare și o serversmatrice. Aceasta testează rezoluția aliasului, nu dacă fiecare server la distanță se poate federa cu al tău.

Rezolvați defecțiunile comune

Aliasul are domeniul greșit

Verificați configurația Synapse server_name. Nu modificați acea valoare pe un server existent în încercarea de a-i redenumi aliasurile: identitatea sa și identificatorii Matrix existenți depind de aceasta. Pentru o implementare nouă, planificați numele dorit al serverului înainte de a crea utilizatori și camere. Dacă operați deja sub un alt nume, utilizarea domeniului alias real poate fi alegerea mai sigură, cu excepția cazului în care puteți aranja un server de acasă denumit corespunzător pentru a deține noile aliasuri.

Crearea eșuează cu 403 sau 409

HTTP 403indică de obicei permisiunea refuzată sau o politică de server aplicabilă. Verificați privilegiile camerei utilizatorului și alias_creation_rulesregulile Synapse; sunt evaluate în ordine, iar o listă explicit goală împiedică crearea oricărui alias. HTTP 409înseamnă că aliasul există deja. Alegeți o altă localpart sau investigați maparea existentă, în loc să o suprascrieți orbește. Manualul de configurare Synapse documentează opțiunile politicii de alias.

Persoanele de pe alte servere nu pot găsi camera

Verificați mai întâi dacă aliasul se rezolvă local. Dacă căutarea locală reușește, dar descoperirea externă eșuează, inspectați federația pentru domeniul alias , inclusiv certificatele HTTPS, /.well-known/matrix/serverdelegarea relevantă și listener-ul de federație expus. Un nume de gazdă utilizat pentru traficul clientului nu stabilește automat federația pentru un alt nume de server Matrix. API-ul Matrix Server-Server descrie descoperirea și delegarea serverului. De asemenea, confirmați că utilizatorii la distanță au permisiunea de a se alătura; o cameră doar pe bază de invitație se poate rezolva cu succes în timp ce refuză o alăturare.

Verificați adresa camerei personalizate

  1. Verificați dacă #support:example.comapare sub Adrese locale și ca adresă principală intenționată în Element.
  2. Rulați solicitarea GET pentru directorul neautentificat de mai sus și comparați-o cu ID-ul afișat în setările avansateroom_id ale camerei Element .
  3. Dintr-un alt cont, încearcă să deschizi https://matrix.to/#/%23support%3Aexample.com. Linkul ar trebui să ducă la camera așteptată; posibilitatea de a se alătura contului depinde în continuare de regulile de acces ale camerei.

Referința de format room-alias și matrix.to din Matrix definește formatul linkului de partajare codificat. Dacă toate cele trei verificări sunt reușite, noua adresă este gata de partajare, în timp ce ID-ul original al camerei rămâne neschimbat.

Lasă un comentariu

Configurați un alias personalizat pentru camera matricei pe propriul domeniu

Oferă unei camere Matrix o adresă ușor de partajat pe domeniul tău folosind Element sau API-ul Matrix, cu verificări pentru permisiuni, denumire Synapse și federație.

Configurați Coturn pentru apeluri vocale și video Matrix fiabile

Configurați coturn și Synapse cu acreditări TURN corespunzătoare, deschideți porturile de retransmisie necesare și verificați dacă clienții Matrix pot obține candidați de retransmisie.

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Configurați un server de acasă Synapse persistent cu Docker Compose, PostgreSQL, o configurație privată și verificări înainte de expunerea acestuia prin HTTPS.

Personalizați tema și brandingul Element Web

Setați un nume de marcă, culori personalizate și resurse de conectare pentru implementarea Element Web, înțelegând în același timp care părți rămân cu marca Element.

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Diagnosticați dacă Synapse a atins limita de fișiere deschise per proces, setați un drop-in systemd pentru serviciul sau worker-ul corect și verificați limita de funcționare.

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Află dacă eroarea este limitată la un singur browser sau la un singur eveniment, apoi folosește cheia de recuperare Element sau un dispozitiv de încredere fără a risca istoricul criptat rămas.

Curățați mesajele și fișierele media vechi din sinapse fără a pierde date

Folosește API-urile sau setările de retenție pentru istoric și epurare media ale Synapse pentru a elimina în siguranță datele învechite, apoi verifică finalizarea și recuperarea spațiului pe disc.

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Instalați biblioteca curentă, conectați un cont Matrix dedicat și rulați un mic bot !echo cu o gestionare mai sigură a acreditărilor și un test clar.

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Configurați trei punți Mautrix cu înregistrări, conectări și teste separate - și evitați surprizele legate de rețelele Docker, politicile de cont și sincronizare.

Recuperați spațiul de pe disc Synapse Media fără a deteriora fișierele partajate

Găsiți ce umple spațiul de stocare Synapse, setați retenția sigură a suporturilor media și goliți memoria cache la distanță fără a șterge fișierele direct de pe disc.