跳到主要内容
PentAGI
入门指南

快速开始

使用交互式安装程序安装 PentAGI — 系统要求、下载、providers 和 search engines 的引导式设置,以及首次登录。

系统要求

  • Docker Engine 20 或更高版本及 Docker Compose;若使用 Podman,请手动安装
  • 至少 2 vCPU 和 4 GB 内存
  • 25 GB 可用磁盘空间
  • 能够访问互联网以下载镜像和更新

下载安装程序

安装程序是一个终端用户界面,用于检查您的系统、配置 providers 和 search engines、加固设置并部署技术栈。

平台压缩包
Linux amd64installer-latest.zip
Linux arm64installer-latest.zip
Windows amd64installer-latest.zip
macOS Intelinstaller-latest.zip
macOS Apple siliconinstaller-latest.zip

macOS 构建版本已签名并经过公证。如果 macOS 仍然阻止安装程序,请勿忽略警告:请从上述链接重新下载适用于您 CPU 架构的归档文件。

先观看演示

您可以在 asciinema 上观看安装程序运行的终端录屏。

运行安装程序

mkdir -p ~/pentagi && cd ~/pentagi
uname -sm | sed -e 's,Linux ,linux/,' -e 's,Darwin ,darwin/,' -e s/x86_64/amd64/ -e s/aarch64/arm64/ | xargs -I PLATFORM curl -fLo installer.zip https://pentagi.com/downloads/PLATFORM/installer-latest.zip
unzip -o installer.zip
sudo ./installer

安装程序通过 /var/run/docker.sock 与 Docker API 通信,因此需要 root 权限或属于 docker 组的用户:

sudo usermod -aG docker $USER
newgrp docker
docker ps

加入 docker 组等同于拥有 root 权限。请仅向受信任的用户授予此权限;在生产环境中,请使用 sudo 运行安装程序或使用无根 Docker。

安装程序将依次执行以下步骤:

系统检查 — 检查 Docker、网络连接及系统要求。

环境设置 — 包含合理默认配置的 .env 文件。

LLM providers — OpenAI、Anthropic、Gemini、Bedrock、Ollama、DeepSeek、GLM、Kimi、Qwen、MiniMax、Mistral、xAI 或自定义端点。

Search engines — DuckDuckGo、Google、Tavily、Firecrawl、Traversaal、Perplexity、Sploitus、SearXNG。

安全加固 — 生成凭据和 SSL 证书。

部署 — 使用 Docker Compose 启动技术栈。

登录

打开 https://localhost:8443 并使用默认账户 [email protected] / admin 登录,然后修改密码。

Web UI 和其他服务均绑定到 localhost,但每个 flow 的 sandbox 会在 Docker 主机的所有网络接口上发布两个回调端口,默认范围为 28000–29999,且 ufw 不会过滤这些端口。如果其他用户可以访问该主机,请首先限制该端口范围——请参阅网络暴露。然后继续您的第一个 flow;如需稍后更新安装,请按照升级进行操作。

最后更新于