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 等保留或私有範圍)。 ...

October 29, 2026 · 114 min · 24088 words · Eric Cheng

NemoClaw 教學手冊

NemoClaw 企業級 AI Agent 沙盒參考堆疊教學手冊(實戰與維運) 一句話定位:NVIDIA NemoClaw 是一套「把受支援的 AI Agent 裝進 NVIDIA OpenShell 沙盒」的開源參考技術堆疊。它提供引導式安裝(onboarding)、版本化 Blueprint、託管推理路由、網路政策 preset、狀態保存與生命週期指令;真正執行隔離、攔截網路、保管憑證的是底下的 OpenShell。NemoClaw 讓你「少做整合工作」,不會讓 Agent「自動變安全」。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理者。PM、SA、SD 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git,以及至少一種 AI Coding 工具。 版本基準: 項目 內容 NemoClaw 版本 v0.0.139(tag commit a08ae7a,2026-10-26);官方文件站 latest 已對應此版 安裝程式預設版本 官方安裝程式預設追蹤 lkg(last known good)標籤,研究當日指向 v0.0.137(f00fb1d,2026-10-21);要用 v0.0.139 必須明確指定 NEMOCLAW_INSTALL_TAG=v0.0.139(第 4 章) 搭配的 OpenShell 0.0.116(Blueprint 的 min_openshell_version 與 max_openshell_version 都是 0.0.116;@nvidia/openshell-sdk 也釘 0.0.116) 支援的 Agent OpenClaw(預設)、Hermes、LangChain Deep Agents Code(dcode 0.1.71);三者在官方平台矩陣皆為 Tested,但 Hermes 官方註明「尚未宣稱與 OpenClaw 的正式環境同等」 專案階段 alpha/Early preview(官方平台矩陣:自 2026-03-16 起),維護者以 best effort 回應、無 SLA 原始碼核對 NVIDIA/NemoClaw tag v0.0.139:docs/(官方文件原始檔)、install.sh、scripts/install-openshell.sh、nemoclaw-blueprint/(Blueprint 與政策)、agents/*/(各 Agent 的 manifest 與政策)、src/lib/(CLI 實作) 研究基準日期 2026-10-27;main 追蹤至 bafe6cc(2026-10-26,領先 v0.0.139 共 18 個 commit);另有 Rust 重寫的 v1 分支(見 1.7)。1.1 版於同日再核對:沒有新 tag,lkg 仍指向 v0.0.137,main 仍為 bafe6cc(18.11) 實測狀態 未在實機安裝 NemoClaw 或 OpenShell。所有 NemoClaw/OpenShell 指令都對照 v0.0.139 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 5 支企業自訂審查工具(政策 lint、交付報告比對、架構依賴檢查、逆向工程引用檢查、測試弱化檢查)、安全公告版本下限腳本與 ArchUnit 範例,已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8、PyYAML 6.0.3、OpenJDK 21.0.4、Maven 3.9.9、Node.js 24.16.0(僅用於撰寫與驗證審查工具) 手冊版本 1.1(2026-10-27;1.0 於同日初版;版本紀錄見 18.13) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、corp.example、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 117 min · 24890 words · Eric Cheng

OpenShell 教學手冊

OpenShell 企業級 AI Agent 安全執行環境教學手冊(實戰與維運) 一句話定位:NVIDIA OpenShell 是讓 AI Agent「在受控邊界內做事」的安全執行與治理 Runtime。它不是模型、不是 Agent Framework,也不只是容器管理工具;它把檔案、程序、網路、憑證四件事從 Agent 手中收回,交給 Agent 碰不到的 Gateway 與 Supervisor 來決定。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理人員。PM、SA、SD 可依 1.6 的學習路徑選讀。內容偏實戰與維運,假設讀者熟悉 Linux、容器、Git 與至少一種 AI Coding 工具。 版本基準: 項目 內容 OpenShell 版本 v0.1.5(Stable,2026-10-20 發布,tag commit bdb956f) 官方文件版本 docs.nvidia.com/openshell/latest(頁首標示「Latest (v0.1.5)」) 原始碼核對 NVIDIA/OpenShell tag v0.1.5:crates/openshell-cli/src/main.rs(CLI 參數)、providers/*.yaml(Provider Profile 範例)、examples/(官方範例) 研究基準日期 2026-10-27;main 分支追蹤至 commit 2ff59bf(2026-10-26),未發布變更見 18.2.1 實測狀態 未在本機安裝或實測(使用者決定只依文件撰寫)。所有指令都對照 v0.1.5 官方文件與 CLI 原始碼,標 📖;需要實際環境才能確認的內容標 🧪,並附驗證步驟與預期結果。1.1 新增的 4 支審查工具(policy-lint.py、check-test-evidence.py、check-dockerfile.sh、引用檢查)已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300(僅用於撰寫與文件驗證,未安裝 OpenShell) 手冊版本 1.1(2026-10-27:新增 AI 產出審查方法與工具、main 未發布變更追蹤;版本紀錄見 24.11) 文件性質:企業內部教育訓練與開發規範。內容為重新整理與組織,不是官方文件翻譯;所有範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、example.internal、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 124 min · 26236 words · Eric Cheng