無需猜測即可提高 Synapse 的 Systemd 檔案限制
診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。
如果 Synapse 的媒體庫磁碟空間已滿,請先確認是哪個目錄或磁碟區正在成長,然後使用 Synapse 支援的保留設定或管理 API 刪除媒體檔案。請勿直接從 Synapse 刪除檔案media_store:Synapse 會將媒體元資料保存在其資料庫中,在 Synapse 後台刪除檔案可能會導致引用失效或難以進行清理審計。最安全的策略取決於該空間是用於本地上傳、來自其他家庭伺服器的快取媒體、縮圖,還是用於共享相同磁碟的其他服務。
Synapse 的媒體庫儲存本地上傳的頭像、附件和縮圖。它還會快取從遠端 Matrix 伺服器取得的媒體以及用於 URL 預覽的資源。這些都獨立於 Synapse 資料庫、容器日誌和任何外部媒體庫。完整的根檔案系統本身並不能證明這media_store就是問題所在。
在掛載資料的主機或容器內,將檔案系統使用情況與 Synapse 資料目錄進行比較。將範例路徑替換為您部署中的實際路徑:
df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store
Synapse 的media_store_path預設設定media_store通常位於資料目錄下,但安裝程式可以覆蓋此設定。容器可以寫入掛載的捲,而該磁碟區的實際儲存位於主機上。homeserver.yaml在確定主機路徑可以安全地變更之前,請檢查容器磁碟區對應或編排器的持久性磁碟區配置。如果媒體目錄並非最大的資源消耗者,請調查顯示該路徑的元件du。
已驗證的行為: Synapse 的media_retention設定會在一段時間未存取後使本機媒體和快取的遠端媒體過期。訪問包括在房間中加載媒體或下載媒體。如果某個專案從未被造訪過,Synapse 會使用其建立時間作為過期時間。原始媒體及其縮圖都會被刪除。清理操作在媒體庫工作進程上運行,該進程可能是 Synapse 的主進程。
具體情況取決於您的使用場景:遠端快取檔案通常可以在刪除後根據請求從其原始伺服器重新取得。本地上傳的文件託管在您的伺服器上,因此清除它們可能會導致舊附件或頭像不可用。僅當您的用戶接受此後果時才選擇本地保留;對於將舊附件視為存檔的社區而言,更長的本地保留期或不進行自動本地清理可能更合適。
保留操作的含義:隔離媒體會阻止訪問,但不會刪除文件或其縮圖。它也不會釋放所需的磁碟空間。如果您需要在刪除其他資料的同時保留隔離的項目,請務必明確區分:隔離是一種控制措施,而保留和刪除是儲存控制措施。
編輯目前配置前請先備份。新增頂級media_retention部分或更新現有部分。例如,此策略會在本地媒體 180 天未存取後失效,並在遠端快取條目 30 天後失效:
media_retention:
local_media_lifetime: 180d
remote_media_lifetime: 30d
這些數值僅供參考,並非普遍建議。請根據您對舊會議室內容的保留義務和預期來設定本地保留期限。如果您只想控制遠端媒體的緩存,只需配置即可remote_media_lifetime;未設定或為空的生命週期表示該類型不會自動清除。 Synapse 文件也指出,隔離的媒體和受隔離保護的本機媒體不包含在保留清理範圍內。
使用部署的正常重新啟動或重新載入流程套用配置,並驗證媒體庫工作進程是否正在執行enable_media_repo: true。如果 Synapse 使用單獨的媒體庫工作進程,請設定啟用媒體庫服務的政策。有效的 YAML 編輯不會立即回收所有空間:工作進程必須執行清理程序,並且只有早於所選存取截止時間的媒體才能符合資格。
如果磁碟已處於關鍵狀態,Synapse 提供了用於清理的管理端點。這些操作會永久刪除媒體。使用前,請備份資料庫和媒體數據,確認 URL 指向您自己的伺服器,並使用 HTTPS 協定透過伺服器管理員存取權杖進行存取。請勿將令牌保存在 shell 歷史記錄和共用日誌中。
若要清除舊的快取遠端媒體,請呼叫文件中記錄的端點,並指定自 Unix 紀元以來的毫秒數截止時間戳記:
POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>
例如,shell 可以使用 GNU 計算 30 天前的截止時間date:
cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"
此回應報告了已刪除的快取項目數量。如果使用者再次要求這些遠端文件,Synapse 將從原始伺服器重新取得它們;這可以恢復常用媒體的磁碟使用率。
本機媒體刪除 API 可以根據最後存取時間以及(可選的)最小檔案大小刪除本機媒體。其目前端點為 `<except>` POST /_synapse/admin/v1/media/delete?before_ts=…;包含 `<except>` 的舊端點<server_name>自 Synapse 1.78.0 起已棄用。截止時間是最後造訪時間,而非上傳日期,且 `<except>`keep_profiles選項預設為 true。由於此刪除操作可能會刪除使用者想要保留的文件,因此除非您已確定適當的截止時間並接受此影響,否則建議使用配置的保留策略。有關參數和您安裝的 Synapse 版本,請參閱官方 API 參考文件。
清理工作流程運作完畢後,df -h再次檢查媒體目錄的大小。對於 API 清除操作,請確認回應中已刪除的檔案數量,並比較相關目錄在清除前後的大小。檢查 Synapse 日誌,尋找設定或工作進程錯誤。如果目錄仍然很大,請檢查您的部署是否將媒體寫入已配置的提供者或單獨的磁碟區;Synapse 本機媒體刪除 API 不會影響儲存在外部媒體儲存庫中的媒體。如果檔案位於其他位置,請勿假設 API 回應成功會減少主機檔案系統的大小。
診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。
確定錯誤是否僅限於一個瀏覽器或一個事件,然後使用 Element 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。
使用 Synapse 的歷史記錄和媒體清除 API 或保留設定安全地刪除過期數據,然後驗證完成情況和磁碟空間恢復情況。
安裝目前庫,連接專用 Matrix 帳戶,並運行一個小型 !echo 機器人,該機器人具有更安全的憑證處理和清晰的測試。
設定三個 Mautrix 橋接器,分別進行註冊、登入和測試-避免 Docker 網路、帳號原則和同步方面的意外情況。
尋找 Synapse 儲存空間佔用情況,設定安全媒體保留策略,並在不直接從磁碟刪除檔案的情況下清除遠端快取。
查看裝置活動,透過管理 API 停用已確認的非活動 Synapse 帳戶,並了解可選的擦除標誌實際刪除了哪些內容。
找出 PostgreSQL 記憶體消耗是來自查詢工作、共享緩衝區、連接還是維護,然後進行有針對性的、Synapse 安全的變更。
在變更 Synapse 設定之前,請追蹤 Matrix 房間加入速度慢的原因,例如遠端 homeserver、聯盟退避、本機資料庫載入或出站傳送佇列。
停止在自架 Synapse 伺服器上建立公開帳戶,或保持註冊僅限邀請,並限制註冊令牌的使用次數。