---
title: "安裝 Comma：自行託管開源 AI 代理 · Comma 文件"
description: "用 Docker Compose 啟動一個新的 Comma 執行個體。"
url: https://comma.surf/zh-tw/docs/self-host/install
language: zh-TW
---

自架

# 安裝

使用 Docker Compose 在單台機器上啟動新的 Comma 執行個體。

## 開始之前

安裝 Docker Engine 與 Compose v2.24 以上版本，複製 [Comma 儲存庫](https://github.com/AFK-surf/Comma)，並視需要準備好模型供應商資訊。

## 首次啟動

複製範例設定檔，填寫 `COMMA_OWNER_EMAIL`（及選填的模型供應商變數），然後建置並啟動服務：

```
cp .env.example .env
docker compose up -d --build
```

首次啟動會從原始碼建置伺服器與前端，並由 `configure` 服務在 `config` 磁碟區中一次性產生持久化密鑰，需要數分鐘。之後啟動會沿用這些密鑰並依 `.env` 重新產生設定。若未在 `.env` 設定模型供應商，登入後可在設定新增個人模型。

## 登入

1. 開啟 `http://localhost:8080` 並輸入你的電子郵件地址。
2. 在本機 Mailpit 收件匣 `http://localhost:8025` 讀取驗證碼並完成登入。
3. `COMMA_OWNER_EMAIL` 帳號可存取 `http://localhost:8082` 管理主控台；產品 API 位於 `8081` 埠，Salix 儀表板位於 `http://localhost:4000/dash`。

預設僅繫結本機迴路位址，Mailpit 亦僅供本機評估使用。若要公開提供服務，請透過同一可註冊網域下的 HTTPS 反向代理存取、停用事件串流的代理緩衝，並在 `.env` 設定真實 SMTP 伺服器。詳見[設定](https://comma.surf/zh-tw/docs/self-host/configuration)。
