Skip to main content

​
支援的作業系統

作業系統最低版本架構備註
macOS12 (Monterey)+x64、ARM64 (Apple Silicon)完整支援，包括 Guard 和 Trap
Ubuntu20.04 LTS+x64、ARM64建議的 Linux 發行版
Debian11 (Bullseye)+x64、ARM64完整支援
CentOS / RHEL8+x64相容 SELinux
Windows10 (build 1903)+x64Guard 需要系統管理員權限

​
系統需求

需要 Node.js >= 20。Panguard 使用現代 JavaScript 功能（top-level await、native fetch），需要 Node.js 20 或更高版本。檢查您的版本：
node --version
透過 nvm 安裝或更新：
nvm install 20
nvm use 20
或透過套件管理器：
# macOS
brew install node@20

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Windows (winget)
winget install OpenJS.NodeJS.LTS
不同的 Panguard 模組有不同的權限需求：
模組需要 Root/Admin原因
panguard scan否以使用者權限讀取檔案
panguard guard是監控系統日誌、管理防火牆規則
panguard trap是綁定到特權埠（< 1024）
panguard chat否透過 HTTPS 發送通知
panguard report否從現有資料產生報告
panguard manager否作為一般 HTTP 伺服器運行
使用 sudo 執行特權模組：
sudo panguard guard start
sudo panguard trap start
元件大約大小
Panguard CLI + 核心約 50 MB
Sigma 規則（3,000+）約 15 MB
YARA 規則（900+）約 8 MB
Threat Cloud 資料庫（自架）100 MB — 10 GB（視資料量而定）
Guard 日誌 + 資料隨時間增長，建議至少 1 GB
Panguard 需要對外的 HTTPS 存取：
目的地用途
auth.panguard.ai身份驗證和訂閱管理
tc.panguard.aiThreat Cloud 情報摘要
registry.npmjs.org套件安裝和更新
api.anthropic.comAI 分析（如果使用 Anthropic）
api.openai.comAI 分析（如果使用 OpenAI）
localhost:11434Ollama 本機 AI（如果已設定）
所有連線可選擇性地透過 HTTPS_PROXY 環境變數經由 HTTP 代理。

​
如何更新

將 Panguard 更新至最新版本： 
npm update -g panguard
更新後，重新啟動任何運行中的服務： 
# 重新啟動 Guard
sudo panguard guard stop
sudo panguard guard start

# 重新啟動 Chat
panguard chat stop
panguard chat start
Panguard 會自動檢查更新，並在有新版本時在 CLI 中顯示通知。偵測規則（Sigma + YARA）獨立於 CLI 工具進行更新。

​
如何解除安裝

若要從您的系統完全移除 Panguard： 
# 1. 停止所有運行中的服務
sudo panguard guard stop
panguard chat stop

# 2. 移除系統服務（如果已安裝）
sudo panguard guard uninstall-service

# 3. 解除安裝 npm 套件
npm uninstall -g panguard

# 4. 移除資料目錄
rm -rf ~/.panguard
rm -rf ~/.panguard-guard
rm -rf ~/.panguard-chat

# 5. 移除憑證
rm -f ~/.panguard/credentials.json

# 6. 移除 Guard 新增的防火牆規則
# macOS:
sudo pfctl -F all
# Linux:
sudo iptables -F PANGUARD 2>/dev/null
sudo iptables -X PANGUARD 2>/dev/null
解除安裝會移除所有本機資料，包括掃描歷史、威脅日誌和設定。如果您需要歷史記錄，請先使用 panguard report generate 匯出您的資料。

​
常見錯誤訊息

您的 Node.js 版本太舊。更新至 Node.js 20+：
nvm install 20 && nvm use 20
您在沒有 root 存取權限的情況下執行特權模組：
sudo panguard guard start
對於非 root 設定，請參閱系統服務指南。
Panguard 未全域安裝，或您的 PATH 未包含 npm 全域 bin 目錄：
npm install -g panguard
# 或檢查您的 PATH：
npm config get prefix
目標服務未運行或無法連線。請檢查：
  • 服務是否已啟動？（panguard status）
  • 埠是否正確？（檢查環境變數）
  • 防火牆是否阻擋了連線？