系統需求
| 項目 | 最低要求 |
|---|
| 作業系統 | macOS 12+、Ubuntu 20.04+、Windows 10+ |
| Node.js | >= 20.0.0 |
| 硬碟空間 | 200 MB |
| 記憶體 | 512 MB（Guard 建議 1 GB） |
平台支援
並非所有功能在每個平台上的支援度相同。macOS 與 Linux 為主要目標平台。
| 功能 | macOS | Linux | Windows |
|---|
| Scan | 完整（lsof, socketfilterfw） | 完整（ss, ufw/iptables） | 部分（netstat，無防火牆） |
| Guard | 輪詢監控（5秒） | 輪詢監控（5秒） | 輪詢監控（5秒） |
| Trap | TCP 蜜罐 | TCP 蜜罐 | TCP 蜜罐 |
| Chat | Telegram / Slack / Email | Telegram / Slack / Email | Telegram / Slack / Email |
| Report | 完整（3 個框架） | 完整（3 個框架） | 完整（3 個框架） |
Windows 支援核心功能，但某些作業系統層級的偵測能力與 macOS 和 Linux 相比有所限制。
可用二進位檔 (v0.3.1)
| 平台 | 架構 | 安裝方式 |
|---|
| macOS | ARM64 (Apple Silicon) | curl 一行安裝或 npm |
| Linux | x64 | curl 一行安裝或 npm |
| Linux | ARM64 | curl 一行安裝或 npm |
| Windows | x64 | npm（建議）或 PowerShell |
安裝方式
一行指令安裝（建議）
curl -fsSL https://get.panguard.ai | bash
**Intel Mac 使用者：**curl 安裝程式預設下載 ARM64 二進位檔。您有兩個選項：
- 改用 npm 安裝：
npm install -g @panguard-ai/panguard
- 先啟用 Rosetta 2：
softwareupdate --install-rosetta
使用 npm
npm install -g @panguard-ai/panguard
使用 Homebrew（即將推出）
brew install panguard-ai/tap/panguard
一行指令安裝（建議）
curl -fsSL https://get.panguard.ai | bash
使用 npm
npm install -g @panguard-ai/panguard
系統套件（即將推出）
# Debian / Ubuntu
sudo apt install panguard
# RHEL / Fedora
sudo dnf install panguard
使用 npm（建議）
npm install -g @panguard-ai/panguard
PowerShell 一行安裝
powershell -ExecutionPolicy Bypass -Command "irm https://get.panguard.ai/windows | iex"
Windows 建議使用 npm 安裝。PowerShell 安裝程式需要系統管理員權限。
從原始碼安裝
適用於貢獻者或希望使用最新開發版本的使用者：
git clone https://github.com/panguard-ai/panguard-ai.git
cd panguard-ai
pnpm install
pnpm build
# 執行 CLI
./bin/panguard --help
從原始碼建置需要 pnpm 10+ 與 Node.js 20+。 驗證安裝
安裝完成後，確認 CLI 可正常使用：
預期輸出：
如果找不到指令，請確認安裝路徑已加入系統 PATH。對於 npm 全域安裝，可使用以下指令確認：
npm list -g @panguard-ai/panguard
解除安裝
npm uninstall -g @panguard-ai/panguard
直接刪除複製的儲存庫目錄即可。
下一步
安裝完成後，請前往帳號設定建立帳號並驗證 CLI。
