# 快速入門

> 使用互動式安裝程式安裝 PentAGI — 系統需求、下載、引導設定 providers 和 search engines，以及首次登入。

## [系統需求](https://pentagi.com/zh-tw/docs/getting-started/quickstart/#system-requirements)

* Docker Engine 20 或更新版本，並搭配 Docker Compose；若使用 [Podman](https://pentagi.com/zh-tw/docs/deployment/production/#podman)，請[手動安裝](https://pentagi.com/zh-tw/docs/getting-started/manual-installation/)
* 至少 2 vCPU 與 4 GB RAM
* 25 GB 可用磁碟空間
* 需具備網際網路連線以下載映像檔與更新

## [下載安裝程式](https://pentagi.com/zh-tw/docs/getting-started/quickstart/#download-the-installer)

安裝程式是一個終端機使用者介面，可檢查您的系統、設定 [providers](https://pentagi.com/zh-tw/docs/glossary/#provider) 與 [search engines](https://pentagi.com/zh-tw/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-tw/docs/getting-started/quickstart/#watch-it-first)

您可以在 [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu) 上觀看安裝程式運作的終端機錄影。

## [執行安裝程式](https://pentagi.com/zh-tw/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-tw/docs/getting-started/quickstart/#sign-in)

開啟 `https://localhost:8443` 並以預設帳號 `admin@pentagi.com` / `admin` 登入，然後變更密碼。

網頁介面與其他服務皆繫結至 localhost，但每個 [flow](https://pentagi.com/zh-tw/docs/glossary/#flow) 的 [sandbox](https://pentagi.com/zh-tw/docs/glossary/#sandbox) 會在 Docker 主機的所有介面上發布兩個回呼埠，預設範圍為 `28000`–`29999`，且 ufw 不會過濾這些埠。若其他使用者可存取該主機，請先限制該範圍 — 請參閱 [網路暴露](https://pentagi.com/zh-tw/docs/configuration/security/#network-exposure)。接著請繼續閱讀[您的第一個 flow](https://pentagi.com/zh-tw/docs/getting-started/first-flow/)；若要稍後更新安裝，請遵循 [升級](https://pentagi.com/zh-tw/docs/deployment/upgrade/)。