跳轉至

審計日誌

local-shell-mcp 會寫入結構化審計記錄,幫助還原已連接客戶端做過什麼。

默認路徑:

/workspace/.local-shell-mcp/audit.jsonl

記錄內容

審計記錄覆蓋這些事件:

  • 工具調用開始和結束。
  • 命令執行元數據。
  • 超時和已處理錯誤。
  • 遠程 worker 註冊和任務活動。
  • 文件鏈接創建和撤銷。
  • 適用時的認證相關事件。

服務能識別的敏感參數會被脫敏。

讀取日誌

使用 MCP 工具:

audit_tail

也可以直接查看:

tail -n 100 /workspace/.local-shell-mcp/audit.jsonl

運維用途

審計日誌主要用於:

  • 複查修改文件的命令。
  • 檢查是否使用過遠程 worker。
  • 調試意外失敗。
  • 發現文件鏈接的意外暴露。
  • 在公開部署配置錯誤後支持事件響應。

保留策略

日誌大小受 LOCAL_SHELL_MCP_MAX_AUDIT_LOG_BYTES 限制。如果需要長期保留,請輪轉或導出到外部系統。

限制

審計日誌不是沙箱。它能提升可追蹤性,但不能阻止已連接模型在配置權限範圍內執行操作。