在您自己的網域上設定自訂矩陣房間別名
使用 Element 或 Matrix API,在您的網域上為 Matrix 房間分配一個易於共享的地址,並檢查權限、Synapse 命名和聯合。
對於自架的 Element Web 部署,請在其設定檔中設定應用程式名稱和預設主題config.json,然後使用文件中提供的branding選項設定登入標誌、背景、標誌連結和頁腳連結。若要自訂顏色,請在設定檔中定義主題setting_defaults.custom_themes並指向default_theme其custom-名稱。這些設定可以個性化 Element,但不會將其變成一個完整的白標產品。
Element 的設定功能將產品識別、色彩主題和頁面資源分開。選擇能夠實現目標的最小改動:
| 目標 | 配置 | 它改變了什麼 |
|---|---|---|
| 顯示您的服務名稱 | brand | 應用程式名稱出現在各種字串和位置 |
| 設定淺色、深色或自訂起始主題 | default_theme | 部署的預設顏色主題 |
| 更改登入和歡迎介面 | branding | 身份驗證頁面徽標、背景、徽標鏈接和頁腳鏈接 |
| 設定自訂顏色和字體 | setting_defaults.custom_themes | 主題選項,例如顏色標記和字體系列 |
已驗證: Element 的文檔表明它支援一些自訂功能,但不支援完全重新品牌化或貼牌。實際意義:變更brand不會取代所有標誌、圖示、圖像或產品參考資訊。如果您需要更改所有視覺元素和文本,則需要維護自訂版本,並在升級後重新檢查。在選擇僅配置方法之前,請先列出使用者需要看到的特定 UI 元素。
Element Web 會config.json在啟動時讀取設定檔。請備份目前檔案並直接編輯,以保留必要的設置,例如預設的 homeserver。對於發布版 tar 包,該檔案位於已部署的 Web 目錄中;Debian 軟體包使用/etc/element-web/config.json。使用 Docker 時,請將設定檔掛載到/app/config.json。正確的掛載位置取決於 Element 的安裝方式,因此請在編輯之前確認您的部署方法。
將以下鍵新增至現有的 JSON 物件中,並將它們與現有的設定合併。請勿將其貼上為整個配置的替換內容:
{
"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" }
]
}
}
請將範例名稱、主機名稱和資源替換為您自己的名稱、主機名稱和資源。此操作brand會變更應用程式名稱在多處的位置;permalink_prefix並將共用永久連結指向您的 Element 部署,而不是matrix.to指向其他位置。標誌和背景條目是瀏覽器載入的 URL。請從使用者可以存取的位置透過 HTTPS 提供這些內容,並確認存取控制、內容安全性原則和快取不會阻止它們。文件沒有指定身份驗證徽標的通用圖像尺寸,因此請預覽您的實際資源,而不是假設其尺寸固定。
取決於部署方式:設定檔會影響執行該設定檔的 Element Web 實例。它不會更改官方app.element.io服務,也不會自動更改 Element 的獨立行動或桌面應用程式。請在執行您自己的實例的主機或容器上進行編輯。
對於簡單的顏色和字體主題,Element 文件中定義了自訂主題setting_defaults.custom_themes。主題的內部名稱以 `_` 為前綴custom-;在 `_` 中使用完整的名稱default_theme。此範例展示了一個簡潔的自訂主題。它只是一個起點,並非完整的調色盤:
{
"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"
}
}
]
}
}
將這些鍵合併到現有的 JSON 中,而不是建立第二個setting_defaults物件。保持文字、背景和控制在正常和高亮狀態下的對比度清晰易讀。元素的參考主題包含其他可選顏色、使用者名稱和頭像顏色陣列、自訂字體以及複合設計標記。僅添加您在當前參考主題中已審核過的值;不完整的調色板可能會導致介面某些部分使用預設值。
常見誤解:此設定default_theme選擇部署的預設值;文件並未將其描述為鎖定所有使用者外觀設定的策略。如果您需要強制執行特定主題,請針對您執行的 Element Web 版本驗證其行為,而不是假設預設值會鎖定所有使用者的外觀設定。
對於執行時期主題測試,Element 的主題說明中提到可以從/devtools「自訂主題」下載入 JSON 主題 URL。請將此視為測試或用戶端工作流程,而不是將預期配置部署到所有用戶端的替代方案。為了方便維護,請將組態和資源置於版本控制之下,並在升級 Element Web 時重複此檢查。
此處所述的行為遵循 2026 年 10 月 10 日檢查的官方 Element Web 配置和主題文件。在依賴任何設定之前,請先查看已安裝版本的參考資料:Element Web 設定參考、Element Web 主題文件和Element Web 安裝文件。
使用 Element 或 Matrix API,在您的網域上為 Matrix 房間分配一個易於共享的地址,並檢查權限、Synapse 命名和聯合。
使用匹配的 TURN 憑證配置 coturn 和 Synapse,打開所需的中繼端口,並驗證 Matrix 用戶端是否可以取得中繼候選位址。
使用 Docker Compose、PostgreSQL、私人配置和檢查來設定持久的 Synapse 主伺服器,然後再透過 HTTPS 公開它。
為您的 Element Web 部署設定品牌名稱、自訂色彩和登入資源,同時了解哪些部分仍保留 Element 品牌。
診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。
確定錯誤是否僅限於一個瀏覽器或一個事件,然後使用 Element 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。
使用 Synapse 的歷史記錄和媒體清除 API 或保留設定安全地刪除過期數據,然後驗證完成情況和磁碟空間恢復情況。
安裝目前庫,連接專用 Matrix 帳戶,並運行一個小型 !echo 機器人,該機器人具有更安全的憑證處理和清晰的測試。
設定三個 Mautrix 橋接器,分別進行註冊、登入和測試-避免 Docker 網路、帳號原則和同步方面的意外情況。
尋找 Synapse 儲存空間佔用情況,設定安全媒體保留策略,並在不直接從磁碟刪除檔案的情況下清除遠端快取。