项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 33763
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装并能正常运行的 Docker(需可访问 Docker API / Docker socket)
- 安装器需 root 权限,或将当前用户加入 docker 组
- Linux(amd64/arm64)、Windows(amd64) 或 macOS(amd64/arm64) 系统,且下载对应架构的安装包
- 至少一个 LLM 提供方的账号与 API 密钥(OpenAI、Anthropic、Gemini、Bedrock、Ollama、DeepSeek、GLM、Kimi
- 可访问外网,以便下载安装器与调用模型/搜索引擎服务
安装与启动步骤
-
1确认 Docker 可用
安装器需与 Docker API 交互,默认使用 /var/run/docker.sock。先确认 Docker 正常运行,否则先装好 Docker。
docker ps -
2下载并解压安装器
创建安装目录并下载对应平台/架构的官方安装包,注意选择与你的系统匹配的链接(此处为 Linux amd64)。
mkdir -p pentagi && cd pentagi wget -O installer.zip https://pentagi.com/downloads/linux/amd64/installer-latest.zip -
3以 root 运行安装器
生产环境建议用 sudo 运行;开发环境也可将用户加入 docker 组后直接运行 ./installer。
sudo ./installer -
4按向导完成配置
向导依次执行系统检查、生成并配置 .env、选择 LLM 提供方、配置搜索引擎、生成安全凭据与 SSL 证书,最后用 docker-compose 部署。
-
5登录使用 PentAGI
部署完成后打开 PentAGI 界面登录,进入后可创建渗透测试任务并使用多智能体协作能力。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
DOCKER_INSIDE | 否 | 设为 true 时在 agent 沙箱内提供 docker 客户端 | true |
DOCKER_SOCKET | 否 | 挂载宿主 Docker socket,官方不推荐,存在启动顺序竞态风险 | |
DOCKER_INSIDE_HOST | 否 | 指向加固后的 dind 守护进程地址,注入为容器内 DOCKER_HOST | tcp://10.0.0.5:3376 |
DOCKER_INSIDE_TLS_VERIFY | 否 | 控制沙箱内 docker 客户端是否校验 TLS 证书 | 1 |
DOCKER_INSIDE_CERT_PATH | 否 | 客户端证书目录,会以只读方式挂载到沙箱同一路径 | /etc/docker/dind/certs/client |
如何确认成功
安装器完成 docker-compose 部署后无报错,能通过浏览器打开 PentAGI 界面并成功登录,即部署成功。
常见问题
Q:提示没有 Docker 访问权限怎么办?
A:生产环境推荐 sudo ./installer 以 root 运行;开发环境可执行 sudo usermod -aG docker $USER 后重新登录或 newgrp docker,再用 docker ps 验证。注意加入 docker 组等同 root 权限。
Q:macOS 提示安装器是恶意软件?
A:只从官方 pentagi.com 链接下载,并选择与 CPU 架构匹配(Intel 用 amd64、M 系列用 arm64)的包,确认来源后按官方 installer troubleshooting 指南处理再放行。
Q:必须给 agent 沙箱 Docker 能力吗?
A:不是必须。若需要,官方推荐设置 DOCKER_INSIDE=true、留空 DOCKER_SOCKET,并指向加固的 dind over TLS 端点;不推荐直接挂载 DOCKER_SOCKET。
Q:安装器会自动生成哪些配置?
A:安装器会创建并配置 .env 文件、写入最优默认值,配置 LLM 提供方与搜索引擎,并生成安全凭据和 SSL 证书,然后启动部署。
注意事项
- README 未给出解压 installer.zip 的具体命令,请按官方安装器说明解压后再执行 ./installer。
- 安装器默认使用 /var/run/docker.sock;将用户加入 docker 组会获得等同 root 的权限,生产环境建议用 sudo 或 rootless Docker。
- 不要用 DOCKER_SOCKET 直接挂载宿主 Docker socket,存在 worker 重启后的启动顺序竞态等风险。
- README 节选中未给出 Web 端口、默认账号密码等信息,请以安装器输出和官网文档为准。
核心亮点
- 多智能体协作架构,能自动拆分复杂渗透任务并并行执行,显著提升效率
- 深度集成 Anthropic 和 GPT 模型,支持灵活切换不同AI引擎,适应多种场景
- 提供完整自动化流程,从侦察到报告生成全链路覆盖,减少人工干预
不足之处
- 自主操作可能产生误报或遗漏,仍需安全专家审核结果
- 文档/社区待观察
适用场景
- 企业安全团队进行定期渗透测试和漏洞评估
- 红队演练中快速模拟攻击路径,验证防御体系
- 安全培训平台用于教学演示和实战练习
替代项目
AutoGPT、BabyAGI、MetaGPT
上一篇:sentient-os
下一篇:mochibot
同类项目推荐
mcp-codestyle-server
开源
让 AI 按你的代码模板生成,告别风格漂移
MCP Codestyle Server 是一个基于 Spring AI 实现的 Model Context Protocol (MCP) 服务器···
ZeusHammer
开源
本地大脑+语音交互,打造懂你的专属 AI 开发助手
ZeusHammer - AI Super Agent with Local Brain, Voice Interaction & Three-Tier Memory
MIRIX
开源
自动记住你的屏幕活动,随时问答找回。
Mirix is a multi-agent personal assistant designed to track on-screen activities and···
harness-anything
开源
让 AI 直接操控你的电脑软件,一句话完成办公与学术任务
Harness Anything - AI agent control hub: WPS, MS Office, Zotero, Photoshop, 47 CLI c···
hcom
开源
让终端里的 AI 智能体互相喊话、协作干活
Let AI agents message, watch, and spawn each other across terminals. Claude Code, Co···
oh-my-claudecode
开源
让 Claude Code 多实例并行协作,团队效率翻倍
Teams-first Multi-agent orchestration for Claude Code
clawapp
开源
手机随时连上你的 AI 智能体,聊天、发图、调工具。
ClawApp — OpenClaw AI 智能体手机聊天客户端 | 流式对话 · 图片收发 · 工具调用 · PW···
quorum-alpha-dash
开源
多智能体协作,对抗验证,让原油交易决策更稳健。
Advanced Multi-Agent AI Crude Oil Trading System with Adversarial Validation 2026
wanwu
开源
企业级多租户AI智能体平台,可视化编排工作流与RAG应用
China Unicom's Yuanjing Wanwu Agent Platform is an enterprise-grade, multi-tenant AI···
