無需破壞共用檔案即可回收 Synapse 媒體磁碟空間

如果 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 的主進程。

具體情況取決於您的使用場景:遠端快取檔案通常可以在刪除後根據請求從其原始伺服器重新取得。本地上傳的文件託管在您的伺服器上,因此清除它們可能會導致舊附件或頭像不可用。僅當您的用戶接受此後果時才選擇本地保留;對於將舊附件視為存檔的社區而言,更長的本地保留期或不進行自動本地清理可能更合適。

保留操作的含義:隔離媒體會阻止訪問,但不會刪除文件或其縮圖。它也不會釋放所需的磁碟空間。如果您需要在刪除其他資料的同時保留隔離的項目,請務必明確區分:隔離是一種控制措施,而保留和刪除是儲存控制措施。

在 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 編輯不會立即回收所有空間:工作進程必須執行清理程序,並且只有早於所選存取截止時間的媒體才能符合資格。

使用管理 API 更快回收空間

如果磁碟已處於關鍵狀態,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 參考文件。

避免常見的誤解

  • 「刪除房間會清除其媒體檔案。」請勿如此假設。房間歷史記錄、媒體文件和快取副本由不同的操作進行管理。請使用媒體管理 API 或保留策略來專門管理媒體檔案。
  • 「隔離可以釋放磁碟空間。」事實並非如此:被隔離的媒體檔案和縮圖仍然保留在磁碟上。如果目標是回收儲存空間,請使用刪除或保留操作。
  • 「儲存庫中的所有媒體都是我的用戶上傳的。」該儲存庫還包含遠端快取和 URL 預覽資料。在選擇清除操作之前,請先比較儲存庫子目錄和 Synapse 的儲存配置。
  • 「手動刪除檔案等同於 Synapse 清理。」但這並非官方支援的替代方案。請讓 Synapse 透過其保留流程或管理 API 更新元資料。

確認磁碟使用率正在下降

清理工作流程運作完畢後,df -h再次檢查媒體目錄的大小。對於 API 清除操作,請確認回應中已刪除的檔案數量,並比較相關目錄在清除前後的大小。檢查 Synapse 日誌,尋找設定或工作進程錯誤。如果目錄仍然很大,請檢查您的部署是否將媒體寫入已配置的提供者或單獨的磁碟區;Synapse 本機媒體刪除 API 不會影響儲存在外部媒體儲存庫中的媒體。如果檔案位於其他位置,請勿假設 API 回應成功會減少主機檔案系統的大小。

官方參考資料

留下評論

無需猜測即可提高 Synapse 的 Systemd 檔案限制

無需猜測即可提高 Synapse 的 Systemd 檔案限制

診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。

元素顯示“解密失敗”?恢復遺失的房間鑰匙

元素顯示“解密失敗”?恢復遺失的房間鑰匙

確定錯誤是否僅限於一個瀏覽器或一個事件,然後使用 Element 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。

清理舊的 Synapse 訊息和媒體檔案而不遺失數據

使用 Synapse 的歷史記錄和媒體清除 API 或保留設定安全地刪除過期數據,然後驗證完成情況和磁碟空間恢復情況。

使用 Simple-Matrix-Bot-Lib 在 Python 中建立矩陣迴聲機器人

使用 Simple-Matrix-Bot-Lib 在 Python 中建立矩陣迴聲機器人

安裝目前庫,連接專用 Matrix 帳戶,並運行一個小型 !echo 機器人,該機器人具有更安全的憑證處理和清晰的測試。

使用獨立橋接器將 Matrix 連接到 WhatsApp、Telegram 和 Discord

使用獨立橋接器將 Matrix 連接到 WhatsApp、Telegram 和 Discord

設定三個 Mautrix 橋接器,分別進行註冊、登入和測試-避免 Docker 網路、帳號原則和同步方面的意外情況。

無需破壞共用檔案即可回收 Synapse 媒體磁碟空間

尋找 Synapse 儲存空間佔用情況,設定安全媒體保留策略,並在不直接從磁碟刪除檔案的情況下清除遠端快取。

停用不活躍的矩陣用戶,而不刪除房間歷史記錄

停用不活躍的矩陣用戶,而不刪除房間歷史記錄

查看裝置活動,透過管理 API 停用已確認的非活動 Synapse 帳戶,並了解可選的擦除標誌實際刪除了哪些內容。

降低 Matrix Synapse 中的 PostgreSQL 記憶體壓力

找出 PostgreSQL 記憶體消耗是來自查詢工作、共享緩衝區、連接還是維護,然後進行有針對性的、Synapse 安全的變更。

為什麼 Matrix Synapse 會議室加入速度慢——以及需要檢查哪些方面

為什麼 Matrix Synapse 會議室加入速度慢——以及需要檢查哪些方面

在變更 Synapse 設定之前,請追蹤 Matrix 房間加入速度慢的原因,例如遠端 homeserver、聯盟退避、本機資料庫載入或出站傳送佇列。

關閉 Synapse 上的 Matrix 註冊或要求使用邀請令牌

停止在自架 Synapse 伺服器上建立公開帳戶,或保持註冊僅限邀請,並限制註冊令牌的使用次數。