---
title: "安装 Comma：自托管开源 AI 智能体 · Comma 文档"
description: "用 Docker Compose 启动一个新的 Comma 实例。"
url: https://comma.surf/zh/docs/self-host/install
language: zh-CN
---

自托管

# 安装

在一台机器上启动一个新的 Comma 实例。

本指南目前是占位内容。完整步骤（包括从其他机器访问）即将推出。

## 开始之前

安装 Docker Engine 及 Compose v2.24 或更高版本，并准备好你的模型服务商信息。

## 首次启动

复制示例设置，填入你的模型服务商，然后启动整套服务：

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

首次启动会构建每个服务并生成实例的密钥，所以需要一些时间。如果 `.env` 里没有填写模型服务商，登录后添加一个私有模型即可。

## 登录

打开 `http://localhost:8080`，用你的电子邮件地址申请登录验证码。验证码会发到本地收件箱 `http://localhost:8025`。

默认情况下，实例只能从本机访问。要让其他人访问，需要 HTTPS 和邮件服务器；相关指南即将推出。