Skip to main content
Panguard Guard 透過位於 ~/.panguard-guard/config.json 的 JSON 檔案進行設定。此檔案會在 panguard guard start 期間以合理的預設值自動建立，或者您可以手動建立。

​
設定檔位置

~/.panguard-guard/config.json

​
完整設定範例

{
  "mode": "protect",
  "learningDays": 7,
  "monitoring": {
    "networkConnections": true,
    "fileIntegrity": true,
    "processActivity": true,
    "authLogs": true,
    "systemLogs": true,
    "kernelModules": true,
    "cronJobs": true,
    "dockerEvents": false
  },
  "rules": {
    "sigmaDir": "~/.panguard-guard/rules",
    "yaraDir": "~/.panguard-guard/yara-rules",
    "customRulesEnabled": true,
    "autoUpdate": true,
    "updateInterval": "24h"
  },
  "response": {
    "enabled": true,
    "autoBlock": true,
    "blockDuration": "24h",
    "minConfidence": 0.85,
    "actions": ["block_ip", "kill_process", "quarantine_file"],
    "requireApproval": false,
    "whitelistedIps": [],
    "whitelistedProcesses": []
  },
  "threatIntel": {
    "enabled": true,
    "endpoint": "https://tc.panguard.ai",
    "uploadEnabled": true,
    "downloadInterval": "6h",
    "abuseIpDbEnabled": false
  },
  "dashboard": {
    "enabled": true,
    "port": 9090,
    "bindAddress": "127.0.0.1"
  },
  "notification": {
    "enabled": true,
    "channels": ["telegram"],
    "minSeverity": "medium",
    "cooldownMinutes": 15
  },
  "auth": {
    "managerEndpoint": "https://localhost:8443",
    "heartbeatInterval": 60,
    "token": null
  }
}

​
設定區段

​
mode

​
mode
string
default:"protect"
Guard 的運作模式。
值說明
learning僅觀察模式。建立行為基線而不觸發警報或回應。
detect監控並對異常發出警報，但不執行自動回應動作。
protect完整防護模式。監控、警報並執行自動回應。
新安裝會在設定的 learningDays 期間以 learning 模式啟動，然後自動轉換為 protect 模式。

​
learningDays

​
learningDays
number
default:"7"
在轉換為設定的 mode 之前保持學習模式的天數。範圍：1—30。

​
monitoring

控制 Guard 監控哪些系統活動。
欄位類型預設值說明
networkConnectionsbooleantrue監控進出的網路連線
fileIntegritybooleantrue監視關鍵系統檔案的未授權變更
processActivitybooleantrue追蹤程序建立、終止和異常
authLogsbooleantrue監控身份驗證嘗試（SSH、sudo 等）
systemLogsbooleantrue分析系統日誌（syslog、journald、Windows Event Log）
kernelModulesbooleantrue偵測核心模組載入/卸載
cronJobsbooleantrue監視 cron/排程任務的修改
dockerEventsbooleanfalse監控 Docker 容器事件（需要 Docker）

​
rules

偵測規則設定。
欄位類型預設值說明
sigmaDirstring~/.panguard-guard/rules包含 Sigma 規則的目錄
yaraDirstring~/.panguard-guard/yara-rules包含 YARA 規則的目錄
customRulesEnabledbooleantrue從子目錄載入自訂規則
autoUpdatebooleantrue從 Threat Cloud 自動更新規則
updateIntervalstring24h檢查規則更新的頻率

​
response

自動回應設定。
欄位類型預設值說明
enabledbooleantrue啟用自動回應動作
autoBlockbooleantrue自動封鎖惡意 IP
blockDurationstring24hIP 封鎖持續時間（1h、24h、7d、permanent）
minConfidencenumber0.85觸發自動回應的最低 AI 信心分數（0.0—1.0）
actionsstring[]["block_ip", "kill_process", "quarantine_file"]允許的回應動作
requireApprovalbooleanfalse在執行回應前需要使用者核准
whitelistedIpsstring[][]永遠不應被封鎖的 IP
whitelistedProcessesstring[][]永遠不應被終止的程序
將 minConfidence 設定在 0.7 以下可能導致誤報回應。預設值 0.85 在防護和準確性之間提供良好的平衡。

​
threatIntel

Threat Cloud 整合設定。
欄位類型預設值說明
enabledbooleantrue啟用 Threat Cloud 整合
endpointstringhttps://tc.panguard.aiThreat Cloud API 端點
uploadEnabledbooleantrue將偵測到的威脅上傳至 Threat Cloud
downloadIntervalstring6h下載更新 IoC 摘要的頻率
abuseIpDbEnabledbooleanfalse啟用 AbuseIPDB 查詢（需要 ABUSEIPDB_KEY）

​
dashboard

本機網頁儀表板設定。
欄位類型預設值說明
enabledbooleantrue啟用本機網頁儀表板
portnumber9090儀表板 HTTP 埠
bindAddressstring127.0.0.1綁定位址（使用 0.0.0.0 進行遠端存取）

​
notification

警報通知設定。
欄位類型預設值說明
enabledbooleantrue啟用通知
channelsstring[][]啟用的頻道：telegram、slack、email、webhook
minSeveritystringmedium觸發通知的最低嚴重程度：low、medium、high、critical
cooldownMinutesnumber15重複通知之間的最少分鐘數

​
auth

Manager API 連線設定。
欄位類型預設值說明
managerEndpointstringhttps://localhost:8443Manager API URL
heartbeatIntervalnumber60心跳間隔（秒）
tokenstringnullManager API token（透過 CLI 自動設定）
大多數使用者不需要直接編輯此檔案。使用 CLI 的 panguard config set 安全地修改個別設定。CLI 會驗證值並處理敏感欄位的加密。