PentAGI 教學手冊
PentAGI 企業級教學手冊(實戰與維運) 一句話定位:PentAGI 是一套自我託管(self-hosted)的多 Agent AI 滲透測試平台。它用 LLM 規劃測試步驟,在 Docker 容器裡呼叫 nmap、sqlmap 等安全工具執行,並把過程、結果與記憶存進 PostgreSQL/pgvector。它能加速授權範圍內的安全驗證,但不會自動讓你的系統安全,也不能取代資安人員、SAST/DAST/SCA 與正式安全驗收。 適用對象:資深工程師、架構師、DevSecOps、資安測試人員、平台維運人員。SA、PM 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git 與至少一種 AI Coding 工具(Claude Code、GitHub Copilot、Codex 等)。 版本基準: 項目 內容 PentAGI 版本 v2.2.0(GitHub Release,2026-10-05 發布);本手冊所有原始碼與設定核對都以 tag v2.2.0 為準 main 追蹤 研究日 main 為 cffed94(2026-10-22),領先 v2.2.0 共 3 個 commit,全部是 README 文件修改,沒有程式或設定變更;另有多個尚未合併的安全與穩定性 PR 需追蹤(見 16.2、16.2.1) 前一版 v2.1.0(2026-05-29)、v2.0.0(2026-04-11);v2.1.0 以前受 CVE-2026-14784 影響(見 6.4) 授權 原始碼 MIT;另有 EULA(僅限合法滲透測試用途、可撤銷)與 NOTICE(VXControl Cloud SDK 授權說明);官方另販售 Enterprise Edition 授權。不能只看 GitHub 的 MIT 標籤(見 20.8) 原始碼核對範圍 README.md、.env.example、docker-compose*.yml、EULA.md、NOTICE、backend/docs/{docker,config,database}.md、examples/guides/{worker_node,installation_configuration}.md、examples/prompts/*、backend/pkg/config/config.go、backend/pkg/docker/{client,sandbox}.go、Release notes v2.0.0~v2.2.0 研究基準日期 2026-10-29(1.1 版於同日重新查核上游 Release、main、Docker Hub digest、NVD 與 open issue/PR) 實測狀態 未在實機安裝 PentAGI(需要真實 LLM API Key、Docker 主機,且平台本身會主動發起攻擊行為)。所有 PentAGI 指令都對照 v2.2.0 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 3 支企業自訂審查工具(.env 安全檢查、任務範圍檢查、弱點報告檢查)與第 18 章的稽核 SQL 已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8(僅用於撰寫與驗證審查工具,只用標準函式庫);PostgreSQL 16(Podman 暫時容器,只用於驗證第 18 章 SQL) 手冊版本 1.1(2026-10-29;補齊第 18 章、加入上游已知問題與待合併修補;版本紀錄見 21.12) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、系統與資料全部虛構(使用 example.com、corp.example、10.x、192.0.2.x 等保留或私有範圍)。 ...