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.
Pentru o implementare Element Web auto-găzduită, setați numele aplicației și tema implicită în fișierul său config.json, apoi utilizați brandingopțiunile documentate pentru sigla de conectare, fundal, linkul siglei și linkurile din subsol. Pentru culori personalizate, definiți o temă sub numele acesteia setting_defaults.custom_themesși indicați spre aceasta. Aceste setări personalizează Element, dar nu îl transformă într-un produs complet white-label.default_themecustom-
Configurația elementului separă identitatea produsului, temele de culoare și elementele paginii. Alegeți cea mai mică modificare care vă atinge obiectivul:
| Scop | Configurare | Ce modifică |
|---|---|---|
| Afișați numele serviciului dvs. | brand | Numele aplicației în diverse șiruri și locații |
| Setați o temă de pornire luminoasă, întunecată sau personalizată | default_theme | Temă de culori implicită pentru implementare |
| Schimbați datele de conectare și aspectul de bun venit | branding | Sigla, fundalul, linkul siglei și linkurile din subsolul paginii de autentificare |
| Setați culori și fonturi personalizate | setting_defaults.custom_themes | Opțiuni tematice, cum ar fi token-uri de culoare și familii de fonturi |
Verificat: Documentația Element menționează că acceptă anumite personalizări, dar nu și rebranding complet sau etichetare privată. Implicație practică: modificarea brandnu va înlocui fiecare logo, pictogramă, imagine sau referință de produs. Dacă aveți nevoie să modificați fiecare element vizual și șir de caractere, așteptați-vă să mențineți o versiune personalizată și să o verificați din nou după actualizări. Începeți prin a enumera elementele exacte ale interfeței utilizator pe care utilizatorii dvs. trebuie să le vadă înainte de a alege o abordare bazată exclusiv pe configurare.
Element Web citește config.jsonla pornire. Faceți o copie de rezervă a fișierului curent și editați-l la locul lui, astfel încât să păstrați setările necesare, cum ar fi serverul de domiciliu implicit. Pentru o arhivă tar de lansare, fișierul se află în directorul web implementat; pachetul Debian folosește /etc/element-web/config.json. Cu Docker, montați configurația la /app/config.json. Locația corectă depinde de modul în care ați instalat Element, așa că verificați metoda de implementare înainte de a edita.
Adăugați următoarele chei la obiectul JSON existent, combinându-le cu orice setări deja prezente. Nu lipiți acest cod ca înlocuitor pentru întreaga configurație:
{
"brand": "Northstar Chat",
"default_theme": "dark",
"permalink_prefix": "https://chat.example.org",
"branding": {
"logo_link_url": "https://example.org",
"auth_header_logo_url": "https://chat.example.org/assets/logo.svg",
"welcome_background_url": "https://chat.example.org/assets/welcome.jpg",
"auth_footer_links": [
{ "text": "Help", "url": "https://example.org/help" },
{ "text": "Privacy", "url": "https://example.org/privacy" }
]
}
}
Înlocuiți numele exemplului, numele de gazdă și resursele cu ale dvs. brandmodifică numele aplicației în diverse locuri; permalink_prefixface ca permalinkurile partajate să indice către implementarea Element în loc de matrix.to. Intrările pentru siglă și fundal sunt adrese URL încărcate de browser. Serviți-le prin HTTPS dintr-o locație pe care utilizatorii o pot accesa și confirmați că controalele de acces, politica de securitate a conținutului și memorarea în cache nu le blochează. Documentația nu specifică o dimensiune universală a imaginii pentru sigla de autentificare, așadar previzualizați resursa reală în loc să presupuneți o dimensiune fixă.
Depinde de implementare: un fișier de configurare afectează instanța Element Web care îl deservește. Nu modifică app.element.ioserviciul oficial și nici nu modifică automat aplicațiile mobile sau desktop separate ale Element. Faceți modificarea pe gazda sau containerul care deservește propria instanță.
Pentru o temă simplă de culoare și font, Element documentează definițiile temelor personalizate în interior setting_defaults.custom_themes. Numele intern al temei are prefixul custom-; folosiți acest nume complet în default_theme. Acest exemplu prezintă o temă personalizată compactă. Este un punct de plecare, nu o paletă completă:
{
"default_theme": "custom-Northstar",
"setting_defaults": {
"custom_themes": [
{
"name": "Northstar",
"is_dark": false,
"fonts": {
"general": "Inter, sans-serif",
"monospace": "'Courier New'"
},
"colors": {
"accent-color": "#3157A4",
"primary-color": "#3157A4",
"warning-color": "#B5473C",
"sidebar-color": "#202A3B",
"roomlist-background-color": "#F3F5F8",
"roomlist-text-color": "#202938",
"timeline-background-color": "#FFFFFF",
"timeline-text-color": "#202938"
}
}
]
}
}
Îmbinați aceste chei în JSON-ul existent, în loc să creați un al doilea setting_defaultsobiect. Păstrați contrastul dintre text, fundaluri și controale lizibil atât în starea normală, cât și în cea evidențiată. Referința temei Element include culori opționale suplimentare, matrici de culori pentru numele de utilizator și avatar, fonturi personalizate și token-uri de design compuse. Adăugați doar valorile pe care le-ați revizuit în referința curentă; o paletă incompletă poate lăsa unele părți ale interfeței folosind valori implicite.
Neînțelegere frecventă: setarea default_themealege valoarea implicită a implementării; documentația nu o descrie ca o politică ce blochează setarea de aspect a fiecărui utilizator. Dacă aveți nevoie de o temă impusă strict, verificați comportamentul respectiv în raport cu versiunea exactă de Element Web pe care o executați, în loc să presupuneți că valoarea implicită este o blocare.
Pentru un test de temă în timpul rulării, notele de tematizare ale Element descriu încărcarea unei adrese URL de temă JSON din /devtoolssecțiunea „Teme personalizate”. Tratați acest lucru ca pe un flux de lucru de testare sau din partea utilizatorului, nu ca pe un substitut pentru implementarea configurației dorite pentru toți clienții. Pentru o implementare ușor de întreținut, păstrați configurația și resursele sub controlul versiunilor și repetați această verificare la actualizarea Element Web.
Comportamentul descris aici respectă documentația oficială de configurare și teme Element Web, verificată la 10 octombrie 2026. Consultați referințele pentru versiunea instalată înainte de a vă baza pe o setare: Referință de configurare Element Web , Documentație de teme Element Web și Documentație de instalare Element Web .
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 ș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.
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.
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.
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.
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.
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.
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.
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.
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.