使用 Docker 將 Mjölnir 運行為 Matrix Room 管理機器人
使用專用 Matrix 帳戶、加密管理室、Docker Compose、政策清單和權限檢查來設定 Mjölnir。
是的,樹莓派 4 可以運行 Conduit,而且該專案也發布了 ARM64 版本。對於小型個人或家庭伺服器而言,最重要的設定選項包括 64 位元作業系統、永久的 Matrix 伺服器名稱、持久性儲存以及可用的 HTTPS 路由。 Conduit 目前仍處於 beta 測試階段,因此請保持更新,並且不要假定樹莓派 4 具有特定的支援使用者容量;該專案並未發布樹莓派 4 的容量基準測試資料。
Conduit 是一個輕量級的 Matrix 家庭伺服器,建議使用 RocksDB 作為資料庫後端。其官方部署文件列出了aarch64二進位檔案和 OCI 鏡像,與 64 位元 Raspberry Pi 作業系統安裝相容。專案更新日誌顯示,截至 2026 年 10 月 10 日,版本號為 v0.10.15,發布日期為 2026 年 9 月 30 日。先前的 v0.10.14 版本修復了一個帳戶存取漏洞,並建議盡快升級。有鑑於此,更新監控已成為部署過程的一部分,而非可選的後續任務。
Conduit 的網站仍然將該專案標記為 beta 版,並指出部分功能尚未實現。在選擇它之前,請務必確認其當前功能是否滿足您的需求,尤其是在您依賴網橋、高階管理或廣泛的用戶端相容性時。樹莓派可以作為小型部署的實用主機,但流量、媒體使用和聯盟活動都會影響效能。建議從適中的使用者群體開始,並密切注意記憶體、溫度和儲存使用情況,而不是依賴官方宣稱的使用者數量。
matrix.example.org`。此網域會出現在使用者的 Matrix ID 中,例如 `<username> @alex:matrix.example.org`。請選擇一個您擁有控制權且計劃保留的網域名稱;以後更改網域名稱並非簡單的修改主機名稱。uname -m。它應該會報告正確的架構aarch64。 Docker 目前的 Raspberry Pi 指南指出,未來的 Docker Engine 主要版本將不再提供適用於 32 位元 Raspberry Pi 作業系統的軟體包;對於 64 位元 ARM 架構,指南建議使用者參考 Debian 的arm64安裝說明。按照適用於您的 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 安裝說明。
使用專用 Matrix 帳戶、加密管理室、Docker Compose、政策清單和權限檢查來設定 Mjölnir。
跳過已停用的代理,配置 Synapse 內建的滑動同步功能。檢查客戶端發現情況,然後在相容的手機上測量房間清單載入和重新連接行為。
將 Element Web 部署為靜態站點,將其指向您的 Matrix 主伺服器,新增 HTTPS,並配置 Nginx 以提供更新而不會出現過時的檔案。
在 64 位元 Raspberry Pi 4 上設定 Conduit,使其具有持久性資料、HTTPS 聯合身份驗證、受保護的註冊以及對正常工作的家庭伺服器的檢查。
使用 Element 或 Matrix API,在您的網域上為 Matrix 房間分配一個易於共享的地址,並檢查權限、Synapse 命名和聯合。
使用匹配的 TURN 憑證配置 coturn 和 Synapse,打開所需的中繼端口,並驗證 Matrix 用戶端是否可以取得中繼候選位址。
使用 Docker Compose、PostgreSQL、私人配置和檢查來設定持久的 Synapse 主伺服器,然後再透過 HTTPS 公開它。
為您的 Element Web 部署設定品牌名稱、自訂色彩和登入資源,同時了解哪些部分仍保留 Element 品牌。
診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。
確定錯誤是否僅限於一個瀏覽器或一個事件,然後使用 Element 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。