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

若要從服務中移除不活躍的本機 Matrix 帳戶,請POST /_synapse/admin/v1/deactivate/<user_id>在檢查帳戶及其裝置後使用 Synapse 的端點。 Synapse 將此操作稱為停用:它會撤銷憑證並將使用者從聊天室中移除,但不會徹底刪除帳戶記錄或使用者的消息。目前的 Synapse v1.157 文件也將停用與可選erase標誌區分開來,後者的影響範圍比許多管理員預期的要窄。請參閱Synapse 使用者管理 API 文件。這些步驟遵循 Synapse v1.157 API 參考文件(2026 年 10 月 10 日更新);請根據您部署版本的文件確認特定行為。

「刪除」是指永久刪除帳戶嗎?

不。管理員 API 支援的操作是停用。它會移除所有活動的存取權杖、裝置、端對端加密金鑰、推播器、密碼雜湊、第三方 ID 以及使用者的房間成員身分。待處理的邀請將被拒絕,帳戶資料也將​​被刪除。即使設定為erasefalse,這也會造成影響。

此設定"erase": true也會移除使用者的顯示名稱、頭像 URL 和自訂個人資料字段,並將帳戶標記為已刪除。它不會刪除已傳送或已接收的訊息、已上傳的媒體、SSO ID 對應或任何其他可能包含個人資料的記錄。現有聊天室成員仍然可以看到用戶的消息;文件指出,這些訊息對之後加入聊天室的用戶是隱藏的。請勿將此 API 標誌視為完整的合法刪除流程。使用前,請遵循貴組織的保留和隱私保護流程。請仔細閱讀具體的停用和刪除效果說明。

如果您需要在調查帳戶期間實施可逆限制,請考慮使用 Synapse 的暫停功能。暫停功能會阻止發送訊息、加入聊天室和發送邀請等操作,同時保留恢復帳戶的途徑。對於已違反您的離職或不活躍策略的帳戶,停用功能則較為適當。

如何確認一個帳戶確實已不活躍?

沒有通用的非活躍帳戶閾值。請根據貴組織的策略設定一個閾值,然後檢查實際的設備活動,而不是將舊的註冊日期作為判斷依據。休眠帳戶可能屬於某個服務、很少使用的客戶端或休假人員。除非所有者已批准移除,否則請勿清理服務身分和主伺服器管理員。

  1. 使用來自可信任主機的伺服器管理員令牌。僅憑房間管理員身分是不夠的。 Synapse 建議避免/_synapse/admin/使用公共反向代理訪問,並在條件允許的情況下從 Synapse 主機發出 Admin API 請求。請在 Authorization 標頭中傳送令牌;切勿將其貼上到共享腳本或發佈到日誌中。請參閱Synapse Admin API 驗證和存取指南。
  2. 列出本機帳戶並審核候選帳戶。 v2清單端點使用分頁功能對結果進行分頁next_token;將其傳回值用作下一個請求的from值。選用guests=false篩選器可排除訪客帳戶,但 Synapse 文件指出,啟用 Matrix 驗證服務整合時不支援此參數。在這種情況下,請將其移除。
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

檢查傳回的 `<username> name`、admin` user_type<username>`、`<username>` 和 `<username>`deactivated欄位。預設情況下,清單不包含已停用的帳戶。以下範例僅顯示一個候選帳戶;實際伺服器可能會傳回多個頁面。

Synapse Admin API 使用者清單回應範例顯示 @inactive:example.org 是一個未被停用的非管理員帳戶。
使用者清單輸出範例:在繼續操作之前,請先驗證確切的 Matrix ID、管理員狀態和目前停用狀態。
  1. 檢查候選人的設備。請求GET /_synapse/admin/v2/users/<user_id>/devices。將每台裝置的時間戳last_seen_ts與您的策略截止時間進行比較;截止時間是 Unix 時間戳,以毫秒為單位,可能存在幾分鐘的延遲。請將其視為需要審查的證據,而不是自動刪除的決定依據。
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

將範例 Matrix ID 替換為您審核過的本機使用者 ID。如果設備最近使用過,請停止操作並與設備所有者確認。如果時間戳較舊,但帳戶是管理員、機器人、支援身分或 SSO 關聯用戶,請在繼續操作前驗證所有權和依賴關係。設備 API 文件last_seen_ts及其單位。

範例裝置清單回應,針對 @inactive:example.org,包含 Web 裝置及其 last_seen_ts 時間戳記。
裝置輸出範例:檢查帳戶所有裝置上最近的 last_seen_ts 是否與您核准的非活動期限相同。

如何停用已核准的帳號?

請使用完整的本機 Matrix ID,而非顯示名稱。停用端點接受一個可選的 JSON 對象erase,其預設值為 false。保留預設值將保留設定檔字段,同時移除會話、裝置、房間成員關係以及上述其他停用資料。

curl -sS -X POST \
  -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"erase": false}' \
  "$SYNAPSE_URL/_synapse/admin/v1/deactivate/%40inactive%3Aexample.org"

每次只針對一個已審核用戶執行此操作。成功回應並不能取代檢查您是否定位到了目標帳戶。在每個帳戶都通過審核和保留檢查之前,請勿將舊時間戳記清單轉換為批量 POST 循環。

範例:向 Synapse 停用端點傳送 curl POST 請求,並將 erase 設為 false。
範例請求正文使用 erase=false,避免執行額外的設定檔刪除和擦除標記操作。

如何驗證結果並選擇擦除?

再次查詢該帳號GET /_synapse/admin/v2/users/<user_id>。確認回應中包含預期的 Matrix ID 和報表"deactivated": true。該帳戶應不再擁有任何有效的存取權杖、設備或房間成員資格。請將請求時間和帳戶 ID 保存在您的管理記錄中,但切勿將持有者令牌儲存在該記錄中。

curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org"

僅"erase": true當您的保留策略或隱私權設定明確要求 Synapse 刪除已擦除標記和設定檔欄位時才應設定此功能。此設定不會刪除訊息歷史記錄或已上傳的媒體檔案。如果您需要處理這些內容,請使用單獨的、已記錄的事件編輯和媒體管理流程,並分別驗證其效果。此外,停用前請仔細規劃:重新啟用可能需要為本機密碼帳戶設定新密碼,且已刪除的裝置加密金鑰無法透過簡單地重新啟用帳戶來恢復。

範例 Synapse 使用者查詢回應,其中 @inactive:example.org 的 deactivated 設定為 true。
範例驗證回應:在 POST 要求後確認 deactivated 為真,且對應的使用者 ID 也為真。

針對您指定的目標帳戶,確認後續查詢結果"deactivated": true。如果結果不同或要求出錯,請停止操作並調查回應,然後再重複 POST 請求。

留下評論

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

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

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

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

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

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

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

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

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

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

元素會話身份警告:請安全驗證您的登入訊息

Clear Element 會使用受信任的裝置或復原金鑰發出未驗證會話警告,並進行檢查以保護您的加密聊天記錄。

使用正確的後端解決 ownCloud 檔案鎖定逾時問題

區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。

在正確的運行時清除 ownCloud PHP 記憶體警告

設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。

排查 ownCloud 10 MySQL 連線故障

找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。

為 ownCloud 公共連結設定嚴格的過期時間

為 ownCloud 公共連結設定嚴格的過期時間

在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。