在 DeepSeek Harness (DSH) 的開發中,告警通道往往是整個系統裏管控相對較弱的一條出口。開發者常將完整的錯誤堆棧、請求體甚至用戶數據直接塞進告警 payload。一旦這些內容通過 webhook 發送到外部,就等於把敏感信息複製到了一個權限控制更弱的地方。本文介紹的工具用於靜態檢查告警鏈路的配置與代碼,確保告警只發送必要的摘要信息。
插件簡介¶
@deepwhale-cn/dsh-alert-relay 是一個用於檢查告警鏈路配置的工具。它由 feely0208 維護,旨在發現告警是否存在、發送目標是否正確,以及是否包含敏感信息。
核心功能¶
該插件主要執行以下檢查:
- 檢查告警鏈路是否存在及發送目標。
- 檢測告警內容中是否包含敏感信息。
- 檢測 webhook 是否使用明文 HTTP。
- 檢查日誌中是否包含密鑰 URL。
- 建議僅發送摘要和 trace id。
安裝與啓用¶
通過 DSH 插件管理工具安裝:
dsh plugin --profile web add @deepwhale-cn/dsh-alert-relay
也可以直接使用 npx 運行:
npx @deepwhale-cn/dsh-alert-relay
典型用法¶
- 運行演示模式查看檢查效果:
dsh-alert-relay --demo
- 列出當前生效的檢查規則:
dsh-alert-relay --list-rules
- 生成 HTML 格式的檢查報告:
dsh-alert-relay --html r.html
適用場景與注意¶
該插件適合需要規範告警發送策略的開發者和運維人員。
該插件以當前 DSH 進程的權限運行,安裝前請檢查源碼與許可證(MIT)。插件不驗證告警真能發出去,只看配置與代碼;如果找不到任何告警配置,這是弱信號,可能由部署層統一處理。它與 dsh-cn-log-retention 插件分工協作:前者查告警發去哪,後者查日誌留多久。
使用者必須遵守所在地區法律法規,對使用本項目造成的任何後果自行承擔責任。
生態背景¶
DSH 理念是「一切皆插件」。該插件屬於深鯨網安守護系列,旨在通過配套插件解決鏈式安全問題。更多插件詳情與生態背景請訪問插件目錄或查看 GitHub 倉庫。