如何使用 Mjolnir Bot 設定 Matrix Room 管理

Mjolnir 是一款 Matrix 管理機器人，它可以應用共享的封禁策略、編輯訊息、監控受保護的房間，並幫助版主在不使用個人帳號的情況下執行操作。安全的設定取決於三個決策：機器人的運作位置、誰可以向其發出命令，以及它在每個受保護的房間中被授予的權限。請確保控制室的私密性，僅保護您預期的房間，並在發生事件時依賴機器人之前驗證其權限。

本指南遵循上游 Mjolnir 的設定和版主文件以及 Matrix 社群版主指南（於 2026 年 10 月 6 日核實）。項目發布頁面顯示，截至審閱時，最新版本為 v1.12.1。安裝時請再次查看上游發布頁面和設定範例，因為容器標籤和支援的選項可能會變更。

Mjolnir適合你的《駭客任務》社群嗎？

當版主需要在多個房間共享管理規則、訂閱通用策略清單或一致地執行重複操作時，可以使用 Mjolnir。 Matrix 房間權限仍決定機器人可以執行的操作；Mjolnir 不會因為加入房間就獲得權限。對於普通的小型房間管理，內建的房間工具可能就足夠了。 Mjolnir 最適用於同一社區運作多個房間或需要受控的共享工作流程的情況。

房間管理和主伺服器管理是兩個不同的權限範圍。 Mjolnir 可以使用對應的房間權限來管理房間層級的封鎖和內容編輯。更具破壞性的伺服器級命令（例如停用使用者、行動別名或關閉房間）需要 Mjolnir 擁有 Synapse 伺服器管理員權限。除非版主確實需要執行這些操作，否則請勿授予主伺服器管理員權限。

安裝前需要準備什麼？

專用於該機器人的 Matrix 主伺服器帳戶，例如@mjolnir:example.org。
一個私密的管理房間，授權的管理員可以在這裡發布命令和接收狀態訊息。
用於儲存 Mjolnir 配置和狀態的持久性目錄或磁碟區。
加密房間方案。目前 Mjolnir 配置支援原生加密；配置文件中也提到 Pantalaimon 是一個單獨的、已棄用的選項。請勿同時啟用這兩種方案。
測試房間，您可以在其中確認邀請、權限和清單行為，然後再保護繁忙的生產房間。

如何安裝雷神之鎚？

上游專案文件詳細介紹了 Docker 和自建置安裝。對於大多數已經運行容器的管理員來說，Docker Compose 非常方便，因為它無需打開互動終端即可重新啟動機器人並顯示日誌。請按照專案的Docker 設定說明進行操作，並在生產環境中使用經過審核的版本，而不是無限期地依賴浮動latest標籤。官方鏡像為matrixdotorg/mjolnir。

啟動容器前請先準備設定。上游 Docker 指南要求將配置放在一個持久性資料目錄中config/production.yaml。請確保只有管理員和需要該目錄的服務人員才能讀取它。該文件可能包含存取權杖或其他登入憑證；請勿將其提交至公用程式碼庫、貼上到支援聊天室或包含在日誌中。

請使用專案目前的預設配置，並參考註解作為選項名稱的權威來源。至少需要設定主伺服器 URL 和管理房間，然後為所選部署配置身份驗證和加密。如果您使用基於令牌的設置，請像對待密碼一樣對待令牌。上游設定指南介紹如何透過在 Element 中使用單獨的瀏覽器設定檔以機器人身分登錄，然後開啟“設定”、“說明和關於”，最後找到“存取權杖”部分來取得代幣。指南警告不要在之後註銷，因為這可能會導致令牌失效；請關閉該瀏覽器設定檔。對於加密的管理房間，請先啟用並測試 Mjolnir 的加密支持，然後再依賴其中的命令。

# Illustrative values only; use the exact keys and authentication method
# from the current upstream configuration sample. Never share real secrets.
homeserverUrl: https://matrix.example.org
managementRoom: '!privateRoomId:example.org'
accessToken: '[STORE A SECRET HERE, NOT IN PUBLIC]'

這段簡短的摘錄並非完整的配置。特別是，加密和登入設定取決於您使用的是原生加密還是可選的 Pantalaimon 路徑。請參考目前範例，而不是複製舊的部落格或 compose 檔案。 Mjolnir 設定指南還建議將機器人網路位置靠近主伺服器，以降低迴應延遲。

如何確保管理室的安全？

為受信任的管理員建立一個房間，邀請機器人帳號加入，並將房間設定為僅限管理員團隊訪問。房間 ID 或別名填寫在內managementRoom。目前配置將此房間描述為命令來源，並警告任何能夠向該房間發送命令的人都可以控制 Mjolnir；它沒有提供更細粒度的單命令存取控制層。因此，成員審核至關重要。請及時移除已離職的管理員，並且不要將機器人的控制室用作普通的社區聊天室。

建議對管理房間進行加密。如果啟用加密，請驗證 Mjolnir 是否能夠使用其配置的加密方式讀取和回覆訊息。如果機器人已加入加密房間但無法解密其事件，則可能顯示線上狀態，但實際上卻無視命令。請先使用上游加密配置和日誌來診斷此問題，而不是先關閉房間加密。

雷神之鎚應該擁有哪些權限？

邀請機器人加入它需要保護的每個房間，並賦予它足夠的房間權限來執行您期望的管理操作。 Matrix 使用房間權限等級來執行諸如封鎖、踢出、編輯其他使用者的事件以及更改房間狀態等操作。所需的權限值由房間的權限等級事件定義；Matrix 預設的封鎖、踢出和編輯權限值通常為 50（如果未指定），但各個房間可以自行變更這些值。

Matrix 的社群指南將 100 級權限描述為常見的 Mjolnir 設置，以便其能夠執行管理決策。然而，該等級權限過高：任何能夠控制 Mjolnir 帳號的人實際上都擁有受保護房間的相應權限，機器人甚至可以成為房間的實際所有者。請檢查每個房間的權限級別，並選擇一個既能允許機器人執行必要操作又能限制不必要權限的級別。不要將其授予普通房間管理的伺服器管理員權限。

在 Element 中，您可以從房間成員面板邀請機器人，或輸入邀請指令，例如 `<invoke-route> /invite @mjolnir:example.org`。機器人加入後，請調整其在房間成員清單中的角色。對每個需要保護的房間重複此操作。 Mjolnir 無法保護它未加入的房間，這是基於 Matrix 去中心化的、逐個房間的權限模型。

如何建立黑名單並添加受保護的房間？

機器人啟動並在管理室發布狀態後，在該管理室建立策略清單。 Mjolnir 的上游快速入門指南使用了以下範例：

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
!mjolnir rooms add #community:example.org
!mjolnir verify
!mjolnir status

第一條指令使用短代碼建立一個封禁清單房間COC；創作者會被邀請加入，以便管理其可見性。第二條指令將該清單設定為後續管理指令的預設清單。第三條指令將房間加入 Mjolnir 的受保護房間集合。驗證命令檢查機器人是否擁有所有受保護房間所需的權限，而狀態命令則用於確認機器人是否如預期運作。使用命令!mjolnir help可以查看已安裝版本中可用的命令語法。

如果策略清單包含內部備註或僅供團隊內部使用，請將其設為私人。只有當您希望其他社群發現並訂閱這些規則時，才可公開。 Mjolnir 的規則會在多個清單中疊加，因此在使用任何受關注的清單之前，請務必先進行檢查；即使您從另一個清單中刪除了重複規則，一個清單仍然可能會匹配到某個使用者或伺服器。