在樹莓派 4 上執行輕量級矩陣家庭伺服器

是的,樹莓派 4 可以運行 Conduit,而且該專案也發布了 ARM64 版本。對於小型個人或家庭伺服器而言,最重要的設定選項包括 64 位元作業系統、永久的 Matrix 伺服器名稱、持久性儲存以及可用的 HTTPS 路由。 Conduit 目前仍處於 beta 測試階段,因此請保持更新,並且不要假定樹莓派 4 具有特定的支援使用者容量;該專案並未發布樹莓派 4 的容量基準測試資料。

Conduit 適合這款樹莓派嗎?

Conduit 是一個輕量級的 Matrix 家庭伺服器,建議使用 RocksDB 作為資料庫後端。其官方部署文件列出了aarch64二進位檔案和 OCI 鏡像,與 64 位元 Raspberry Pi 作業系統安裝相容。專案更新日誌顯示,截至 2026 年 10 月 10 日,版本號為 v0.10.15,發布日期為 2026 年 9 月 30 日。先前的 v0.10.14 版本修復了一個帳戶存取漏洞,並建議盡快升級。有鑑於此,更新監控已成為部署過程的一部分,而非可選的後續任務。

Conduit 的網站仍然將該專案標記為 beta 版,並指出部分功能尚未實現。在選擇它之前,請務必確認其當前功能是否滿足您的需求,尤其是在您依賴網橋、高階管理或廣泛的用戶端相容性時。樹莓派可以作為小型部署的實用主機,但流量、媒體使用和聯盟活動都會影響效能。建議從適中的使用者群體開始,並密切注意記憶體、溫度和儲存使用情況,而不是依賴官方宣稱的使用者數量。

安裝前您應該決定什麼?

  • 選擇 Matrix 伺服器名稱。在本例中,它是 `<domain> matrix.example.org`。此網域會出現在使用者的 Matrix ID 中,例如 `<username> @alex:matrix.example.org`。請選擇一個您擁有控制權且計劃保留的網域名稱;以後更改網域名稱並非簡單的修改主機名稱。
  • 規劃公共訪問。為網域名稱新增一筆指向您公網 IP 位址的 DNS 記錄。設定路由器轉送和反向代理,並啟用有效的 HTTPS 憑證。 Conduit 的部署指南要求使用 HTTPS,並指出聯盟流量必須可透過 443 和/或 8448 連接埠訪問,具體取決於您的發現和代理配置。
  • 請使用 64 位元 Raspberry Pi 作業系統。使用 ` docker config` 指令檢查架構uname -m。它應該會報告正確的架構aarch64。 Docker 目前的 Raspberry Pi 指南指出,未來的 Docker Engine 主要版本將不再提供適用於 32 位元 Raspberry Pi 作業系統的軟體包;對於 64 位元 ARM 架構,指南建議使用者參考 Debian 的arm64安裝說明。
  • 保持資料庫持久化。將 Conduit 的資料儲存在持久目錄或 Docker 磁碟區上,並將其納入經過測試的備份計畫。請勿將唯一副本儲存在容器的可寫層或可能需要重新格式化的可移動記憶卡上。

如何使用 Docker 啟動 Conduit?

按照適用於您的 Raspberry Pi 作業系統版本的最新說明安裝 Docker Engine 和 Compose 外掛程式。然後確認 Docker 正在運行。 Conduit 文件列出了穩定的 Docker Hub 映像registry.gitlab.com/famedly/conduit/matrix-conduit:latest和 ARM64 OCI 映像。拉取穩定映像並檢查 Docker 是否選擇了 ARM64 映像:

docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
  --format '{{.Architecture}}'

僅當報告的架構與您的 64 位元作業系統相符時才繼續。建立工作目錄和 Compose 檔案:

mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml

請以此配置作為起點。它假設反向代理程式運行在樹莓派主機上,並將 Matrix 請求轉送到 6167 連接埠。請替換範例伺服器名稱。此處的空值CONDUIT_CONFIG指示容器使用環境變量,因為目前的 Conduit Docker 說明要求此設定必須使用環境變數。

services:
  conduit:
    image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
    container_name: conduit
    restart: unless-stopped
    ports:
      - "127.0.0.1:6167:6167"
    volumes:
      - ./data:/var/lib/matrix-conduit
    environment:
      CONDUIT_CONFIG: ""
      CONDUIT_SERVER_NAME: "matrix.example.org"
      CONDUIT_ADDRESS: "0.0.0.0"
      CONDUIT_PORT: "6167"
      CONDUIT_DATABASE_BACKEND: "rocksdb"
      CONDUIT_ALLOW_REGISTRATION: "true"
      CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
      CONDUIT_ALLOW_FEDERATION: "true"
      CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'

建立私有註冊令牌檔案並啟動服務:

umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit

此令牌用於註冊您的第一個帳戶;Conduit 會將第一個建立的使用者設定為伺服器管理員。請將此.env文件設為私有,不要提交到公用程式碼庫。此範例將 Conduit 綁定到樹莓派的回環接口,因此只能透過運行在同一主機上的反向代理來存取。如果您的代理程式運行在另一個容器或另一台機器上,請使用私有 Docker 網路或受保護的私有接口,而不是公開連接埠 6167。

如何確保伺服器可存取且安全?

設定反向代理,使其透過 HTTPS 提供網域服務,並將 Matrix 用戶端和聯盟請求(包括 `<command>`/_matrix/和/.well-known/matrix/`<command>`)轉送到 Conduit。最簡單的公共配置取決於您的代理,以及聯盟是使用 8448 連接埠還是透過 443 連接埠進行委託發現。請參考 Conduit Docker 部署文件中的對應範例;切勿直接複製代理程式碼片段,而應根據實際情況調整其主機名稱、憑證處理和網路路徑。

如果 Conduit 和 homeserver URL 使用相同的域名server_name,請確保用戶端可以存取已發布的 HTTPS 端點。如果 Conduit 託管在與 Matrix ID 網域不同的子網域上,請依照委派指南中的說明設定兩者/.well-known/matrix/client。/.well-known/matrix/server單獨開啟連接埠不會配置服務發現或 TLS。

請立即使用支援註冊令牌的 Matrix 用戶端註冊您的管理員帳號。然後,除非您有意允許他人建立帳戶,否則請關閉開放註冊功能。在 Compose 中,將設定變更CONDUIT_ALLOW_REGISTRATION為"false"`<your-admin-register-token>`,從服務環境中移除註冊令牌,然後使用 `<your-admin-register-token>` 重新建立容器docker compose up -d。您的綁定掛載資料目錄將保留。請檢查哪些使用者可以存取樹莓派的 Docker 套接字和設定文件,因為他們可能會洩漏或更改伺服器金鑰。

如何確認設定是否有效?

透過公共 HTTPS 主機名稱檢查本機 Matrix 用戶端 API:

curl -fsS https://matrix.example.org/_matrix/client/versions

JSON 回應確認客戶端 API 可訪問,但並不能證明聯盟功能正常。請執行官方的 Matrix Federation Tester 測試您的伺服器名稱,並修正.well-known其報告的任何 DNS、TLS、連接埠轉送或其他錯誤。最後,使用您的新帳戶登錄,確認其擁有管理員權限,並在一個房間中與另一台主伺服器上的使用者發送訊息進行測試(如果聯盟功能是您的目標之一)。

以上技術細節已於 2026 年 10 月 10 日與 Conduit 的官方 Docker、配置、委託和變更日誌頁面進行核對。有關不同版本之間的差異,請參閱Conduit Docker 部署指南、ARM64 二進位和通用部署指南、設定參考、委託指南、Conduit 變更日誌以及Docker 的 Raspberry Pi OS 安裝說明。

留下評論

使用 Docker 將 Mjölnir 運行為 Matrix Room 管理機器人

使用 Docker 將 Mjölnir 運行為 Matrix Room 管理機器人

使用專用 Matrix 帳戶、加密管理室、Docker Compose、政策清單和權限檢查來設定 Mjölnir。

啟用原生矩陣滑動同步,加快行動端載入速度

啟用原生矩陣滑動同步,加快行動端載入速度

跳過已停用的代理,配置 Synapse 內建的滑動同步功能。檢查客戶端發現情況,然後在相容的手機上測量房間清單載入和重新連接行為。

Host Element Web 運行在 Nginx 上,並附有自訂 Homeserver。

將 Element Web 部署為靜態站點,將其指向您的 Matrix 主伺服器,新增 HTTPS,並配置 Nginx 以提供更新而不會出現過時的檔案。

在樹莓派 4 上執行輕量級矩陣家庭伺服器

在 64 位元 Raspberry Pi 4 上設定 Conduit,使其具有持久性資料、HTTPS 聯合身份驗證、受保護的註冊以及對正常工作的家庭伺服器的檢查。

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

使用 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 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。