審計日誌¶
local-shell-mcp 會寫入結構化審計記錄,幫助還原已連接客戶端做過什麼。
默認路徑:
記錄內容¶
審計記錄覆蓋這些事件:
- 工具調用開始和結束。
- 命令執行元數據。
- 超時和已處理錯誤。
- 遠程 worker 註冊和任務活動。
- 文件鏈接創建和撤銷。
- 適用時的認證相關事件。
服務能識別的敏感參數會被脫敏。
讀取日誌¶
使用 MCP 工具:
也可以直接查看:
運維用途¶
審計日誌主要用於:
- 複查修改文件的命令。
- 檢查是否使用過遠程 worker。
- 調試意外失敗。
- 發現文件鏈接的意外暴露。
- 在公開部署配置錯誤後支持事件響應。
保留策略¶
日誌大小受 LOCAL_SHELL_MCP_MAX_AUDIT_LOG_BYTES 限制。如果需要長期保留,請輪轉或導出到外部系統。
限制¶
審計日誌不是沙箱。它能提升可追蹤性,但不能阻止已連接模型在配置權限範圍內執行操作。