# 快速开始

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

## [系统要求](https://pentagi.com/zh-cn/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 或更高版本及 Docker Compose；若使用 [Podman](https://pentagi.com/zh-cn/docs/deployment/production/#podman)，请[手动安装](https://pentagi.com/zh-cn/docs/getting-started/manual-installation/)
* 至少 2 vCPU 和 4 GB 内存
* 25 GB 可用磁盘空间
* 能够访问互联网以下载镜像和更新

## [下载安装程序](https://pentagi.com/zh-cn/docs/getting-started/quickstart/#download-the-installer)

安装程序是一个终端用户界面，用于检查您的系统、配置 [providers](https://pentagi.com/zh-cn/docs/glossary/#provider) 和 [search engines](https://pentagi.com/zh-cn/docs/glossary/#search-engine)、加固设置并部署技术栈。

| 平台                  | 压缩包                                                                                      |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Linux amd64         | [installer-latest.zip](https://pentagi.com/downloads/linux/amd64/installer-latest.zip)   |
| Linux arm64         | [installer-latest.zip](https://pentagi.com/downloads/linux/arm64/installer-latest.zip)   |
| Windows amd64       | [installer-latest.zip](https://pentagi.com/downloads/windows/amd64/installer-latest.zip) |
| macOS Intel         | [installer-latest.zip](https://pentagi.com/downloads/darwin/amd64/installer-latest.zip)  |
| macOS Apple silicon | [installer-latest.zip](https://pentagi.com/downloads/darwin/arm64/installer-latest.zip)  |

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

## [先观看演示](https://pentagi.com/zh-cn/docs/getting-started/quickstart/#watch-it-first)

您可以在 [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu) 上观看安装程序运行的终端录屏。

## [运行安装程序](https://pentagi.com/zh-cn/docs/getting-started/quickstart/#run-it)

```bash
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` 组的用户：

```bash
sudo usermod -aG docker $USER
newgrp docker
docker ps
```

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

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

1. **系统检查** — 检查 Docker、网络连接及系统要求。
2. **环境设置** — 包含合理默认配置的 `.env` 文件。
3. **LLM providers** — OpenAI、Anthropic、Gemini、Bedrock、Ollama、DeepSeek、GLM、Kimi、Qwen、MiniMax、Mistral、xAI 或自定义端点。
4. **Search engines** — DuckDuckGo、Google、Tavily、Firecrawl、Traversaal、Perplexity、Sploitus、SearXNG。
5. **安全加固** — 生成凭据和 SSL 证书。
6. **部署** — 使用 Docker Compose 启动技术栈。

## [登录](https://pentagi.com/zh-cn/docs/getting-started/quickstart/#sign-in)

打开 `https://localhost:8443` 并使用默认账户 `admin@pentagi.com` / `admin` 登录，然后修改密码。

Web UI 和其他服务均绑定到 localhost，但每个 [flow](https://pentagi.com/zh-cn/docs/glossary/#flow) 的 [sandbox](https://pentagi.com/zh-cn/docs/glossary/#sandbox) 会在 Docker 主机的所有网络接口上发布两个回调端口，默认范围为 `28000`–`29999`，且 ufw 不会过滤这些端口。如果其他用户可以访问该主机，请首先限制该端口范围——请参阅[网络暴露](https://pentagi.com/zh-cn/docs/configuration/security/#network-exposure)。然后继续[您的第一个 flow](https://pentagi.com/zh-cn/docs/getting-started/first-flow/)；如需稍后更新安装，请按照[升级](https://pentagi.com/zh-cn/docs/deployment/upgrade/)进行操作。