透過操作解決矩陣房間管理員權限錯誤
追蹤 M_FORBIDDEN 到房間功率等級、成員資格或 Synapse 伺服器管理員存取權限,然後僅恢復被封鎖操作所需的權限。
若要將 Synapse Matrix 伺服器置於 Cloudflare 的標準 orange-cloud 代理程式之後,請將用戶端 API 和入站聯盟流量都透過 443 連接埠上的 HTTPS 傳送。保持 Cloudflare 到來源站的 TLS 連線啟用(嚴格模式),將 Matrix 路徑不變地路由到 Synapse,發布指向 443 連接埠主機名稱的聯盟發現,並繞過 API 路徑的快取。請勿將普通的代理程式記錄指向 Matrix 的預設聯盟連接埠 8448:Cloudflare 的標準代理程式不支援該連接埠。
本範例假設 Synapse 運行在反向代理(例如 Nginx、Caddy 或 Traefik)之後。 Synapse 可以保留在其私人 Docker 網路中的 HTTP 連接埠 8008 上;前端代理程式處理公用 TLS 連線。當發現功能將遠端主伺服器指向 HTTPS 連接埠 443 時,聯合驗證可以使用該連接埠。 Synapse 支援使用 443 作為預設連接埠 8448 的替代方案,而 Cloudflare 的標準代理連接埠清單中包含 443 但不包含 8448。請參閱Synapse 連接埠指南和Cloudflare 的支援連接埠清單。
當用戶端和聯盟需要共用代理程式的 HTTPS 主機名稱時,請使用此方法。如果必須將聯盟保留在 8448 端口,請使用僅 DNS 記錄或支援該 TCP 連接埠的 Cloudflare 產品。範例中使用 ` <Matrix ID>`和 ` <Synapse ID> example.org` 作為 Matrix ID 。請替換為您自己的主機名,但保留現有的 `<Synapse ID> `;更改 `<Synapse ID>` 會更改使用者的 Matrix ID。@alice:example.orgmatrix.example.orgserver_name
在 Cloudflare DNS 中,將 A/AAAA 記錄設定為matrix.example.org反向代理程式的公有網路位址,並將其標記為「已代理」。example.org主機名稱也必須指向用於接收發現檔案的 Web 伺服器。刪除不可用的 AAAA 記錄。僅保留 MX 記錄、郵件記錄和非 HTTP 記錄。 Cloudflare 會在其邊緣終止 TLS 連接,並與您的來源伺服器建立單獨的連接。

在 Cloudflare SSL/TLS 設定中,選擇「完全(嚴格)」。來源代理必須接受 443 連接埠上的 HTTPS 請求,並提供matrix.example.org由受信任的憑證授權單位或 Cloudflare 來源 CA 所發出的未過期憑證。這樣可以加密並驗證雙向連線;靈活模式可能會導致來源連線未加密或出現重定向循環。請參閱 Cloudflare 的「完全(嚴格)」設定指南。
配置反向代理的 HTTPS 虛擬主機,使其能夠將以 `<path>`開頭的matrix.example.org路徑轉送到私有網路上的 Synapse,通常在 Compose 中進行設定。保留完整的請求路徑,轉送原始主機,並設定 `<path>` 和 `<path> ` 。這些路由包含客戶端 API 呼叫和聯合端點;避免僅將瀏覽器主頁傳送至 Synapse 或截斷路徑前綴。/_matrix/_synapse/clienthttp://synapse:8008X-Forwarded-ForX-Forwarded-Proto

在 Synapse 現有的 HTTP 監聽器中,進行設置x_forwarded: true,使其從代理伺服器讀取客戶端位址和協定。不要將容器化的監聽器綁定到該端口,這會阻止其他容器存取它。將 8008 連接埠對 Compose 私有。有關特定代理伺服器的語法,127.0.0.1請參閱 Synapse 的反向代理說明。
由於使用者example.org在 Synapse 服務存取期間會使用 Matrix ID matrix.example.org,因此請在指定位置提供聯邦發現檔https://example.org/.well-known/matrix/server。傳回狀態碼 200、JSON 內容以及以下值:
{"m.server":"matrix.example.org:443"}
明確配置:443會將遠端主伺服器傳送到支援的代理連接埠。 Matrix 聯盟規範定義了這種m.server委託方式。如果 Synapse 伺服器名稱本身就是 `<hostname>` matrix.example.org,則在該連接埠提供相符的已知檔案;或者,serve_server_wellknown當該主機名稱路由到 443 連接埠上的 Synapse 伺服器時,使用 Synapse 的 `<hostname>` 選項。
若要實現客戶端自動發現,請使用https://example.org/.well-known/matrix/client對應的配置。瀏覽器用戶端也需要Matrix 用戶端-伺服器規格{"m.homeserver":{"base_url":"https://matrix.example.org"}}要求的 CORS 標頭。將 Synapse 的配置設定為使用者應輸入的 HTTPS URL。請參閱Matrix 伺服器發現規格和Synapse 設定參考。public_baseurl

建立一條快取規則,matrix.example.org符合以/_matrix/`/` 或 `/`開頭的路徑/_synapse/client/,並選擇「繞過快取」。這可以保護登入、同步、聯合身份驗證和媒體 API 免受自訂「快取所有內容」規則的影響。同時檢查 WAF、機器人和重定向規則:Matrix 用戶端無法解決瀏覽器插頁式廣告挑戰。保持啟用保護措施,並將任何例外情況限定在協議路徑上。 Cloudflare 在其控制面板說明中對「繞過快取」進行了描述。
請從伺服器區域網路以外的機器執行這些檢查,以便請求遵循公共 DNS 和 Cloudflare:

curl -i https://example.org/.well-known/matrix/server
curl -i https://example.org/.well-known/matrix/client
curl -i https://matrix.example.org/_matrix/client/versions
curl -i https://matrix.example.org/_matrix/federation/v1/version
確認第一個請求返回的 JSON 數據已m.server設置matrix.example.org:443,客戶端文件名包含 HTTPS 基本 URL,並且最後兩個請求返回有效的 JSON 數據,而不是 Cloudflare 驗證頁面、404 或 502 錯誤。然後從客戶端登入並測試房間同步、上傳文件,以及與另一個主伺服器上的房間進行聯合。 Matrix 伺服器會快取共同發現回應,因此遠端伺服器可能會在您變更值後保留一段時間的舊值;請使用回應的快取標頭,並等待快取記錄過期。
如果檔案上傳失敗並出現 HTTP 413 錯誤,請將檔案大小與 Cloudflare 區域目前的上傳限制以及 Synapse 的限制進行比較max_upload_size;反向代理也有自己的請求體大小限制。 Synapse 的預設限制為 50 MB,而 Nginx 的預設請求體大小限制可能會更低。 Cloudflare 的限制因套餐而異,並且可以在套餐規則中進行調整,因此在提高 Synapse 的限制之前,請先查看其當前的上傳限製文件。如果 API 正常運作但聯盟失敗,請先檢查伺服器的 WWW URL 是否公開,其主機名稱憑證是否有效,以及委託連接埠是否明確設定為 443。如果您有意保留連接埠 8448,請停止透過標準的 Cloudflare DNS 代理代理記錄,並改用直接的僅 DNS 聯盟主機名稱。
追蹤 M_FORBIDDEN 到房間功率等級、成員資格或 Synapse 伺服器管理員存取權限,然後僅恢復被封鎖操作所需的權限。
設定 Synapse 發現、HTTPS 和代理路由,以便其他 Matrix 主伺服器可以找到並聯絡您的伺服器。
配置 Keycloak OIDC 用戶端和 Synapse 提供程序,以便 Element Web 使用者可以透過您的身分伺服器登錄,而無需暴露客戶端金鑰。
儲存恢復金鑰,驗證您的 Element 會話,並檢查加密訊息金鑰是否可以恢復,而不會將備份與您的帳戶密碼混淆。
診斷 Synapse 在同步過程中記憶體不足的故障,安全地調整緩存,識別請求積壓,並驗證穩定的記憶體使用量。
追蹤矩陣聯合憑證故障到正確的伺服器,修復 TLS 鍊或 CA 信任,並在不停用安全檢查的情況下驗證修復。
Route Matrix 用戶端和透過 Cloudflare 在 HTTPS 443 上進行聯合,可以保留 Synapse 探索功能,避免快取 API 流量或中斷媒體上傳。
使用 pg_dump 備份 Synapse,保護其簽章金鑰和介質,並將其還原到乾淨的 PostgreSQL 資料庫中,而無需重複使用過時的一次性金鑰。
使用專用 Matrix 帳戶、加密管理室、Docker Compose、政策清單和權限檢查來設定 Mjölnir。
跳過已停用的代理,配置 Synapse 內建的滑動同步功能。檢查客戶端發現情況,然後在相容的手機上測量房間清單載入和重新連接行為。