自訂 Element Web 的主題和品牌

對於自架的 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 版本驗證其行為,而不是假設預設值會鎖定所有使用者的外觀設定。

應用變更並檢查結果

  1. 部署前請先驗證 JSON 語法。缺少逗號或引號不符都可能導致配置無法載入。請確保 JSON 格式正確:不支援註解。
  2. 文件發布後請重新載入網頁。如果瀏覽器仍然顯示舊的品牌標識,請嘗試強制刷新或使用隱私窗口,並檢查瀏覽器是否能夠成功取得每個資源 URL。
  3. 請檢查登入介面和登入後的介面。確認應用程式名稱、所選主題、標誌位置、背景和頁腳連結是否正確,並檢查房間清單和時間軸上的文字對比。
  4. 檢查瀏覽器開發者工具和 Web 伺服器日誌,查看是否有設定或資源請求失敗的情況。如果您使用 CDN 或反向代理,請根據您的設定清除或等待其快取的配置和資源副本過期。

對於執行時期主題測試,Element 的主題說明中提到可以從/devtools「自訂主題」下載入 JSON 主題 URL。請將此視為測試或用戶端工作流程,而不是將預期配置部署到所有用戶端的替代方案。為了方便維護,請將組態和資源置於版本控制之下,並在升級 Element Web 時重複此檢查。

此處所述的行為遵循 2026 年 10 月 10 日檢查的官方 Element Web 配置和主題文件。在依賴任何設定之前,請先查看已安裝版本的參考資料:Element Web 設定參考、Element Web 主題文件和Element Web 安裝文件。

留下評論

在您自己的網域上設定自訂矩陣房間別名

使用 Element 或 Matrix API,在您的網域上為 Matrix 房間分配一個易於共享的地址,並檢查權限、Synapse 命名和聯合。

設定可靠的矩陣語音和視訊通話的 coturn

使用匹配的 TURN 憑證配置 coturn 和 Synapse,打開所需的中繼端口,並驗證 Matrix 用戶端是否可以取得中繼候選位址。

使用 Docker Compose 和 PostgreSQL 部署 Matrix Synapse

使用 Docker Compose 和 PostgreSQL 部署 Matrix Synapse

使用 Docker Compose、PostgreSQL、私人配置和檢查來設定持久的 Synapse 主伺服器,然後再透過 HTTPS 公開它。

自訂 Element Web 的主題和品牌

為您的 Element Web 部署設定品牌名稱、自訂色彩和登入資源,同時了解哪些部分仍保留 Element 品牌。

無需猜測即可提高 Synapse 的 Systemd 檔案限制

無需猜測即可提高 Synapse 的 Systemd 檔案限制

診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。

元素顯示“解密失敗”?恢復遺失的房間鑰匙

元素顯示“解密失敗”?恢復遺失的房間鑰匙

確定錯誤是否僅限於一個瀏覽器或一個事件,然後使用 Element 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。

清理舊的 Synapse 訊息和媒體檔案而不遺失數據

使用 Synapse 的歷史記錄和媒體清除 API 或保留設定安全地刪除過期數據,然後驗證完成情況和磁碟空間恢復情況。

使用 Simple-Matrix-Bot-Lib 在 Python 中建立矩陣迴聲機器人

使用 Simple-Matrix-Bot-Lib 在 Python 中建立矩陣迴聲機器人

安裝目前庫,連接專用 Matrix 帳戶,並運行一個小型 !echo 機器人,該機器人具有更安全的憑證處理和清晰的測試。

使用獨立橋接器將 Matrix 連接到 WhatsApp、Telegram 和 Discord

使用獨立橋接器將 Matrix 連接到 WhatsApp、Telegram 和 Discord

設定三個 Mautrix 橋接器,分別進行註冊、登入和測試-避免 Docker 網路、帳號原則和同步方面的意外情況。

無需破壞共用檔案即可回收 Synapse 媒體磁碟空間

尋找 Synapse 儲存空間佔用情況,設定安全媒體保留策略,並在不直接從磁碟刪除檔案的情況下清除遠端快取。