---
title: "自托管 Comma：在你的服务器上运行开源 AI 智能体"
description: "在你自己管理的机器上运行 Comma。Docker Compose 从开源代码构建它，你的数据留在你自己的数据库里。"
url: https://comma.surf/zh/self-host
language: zh-CN
---

# 自托管 Comma

在你自己管理的机器上运行 Comma。Docker Compose 从开源代码构建它，你的数据留在你自己的数据库里。

[阅读指南](https://comma.surf/zh/docs/self-host/install) [GitHub](https://github.com/AFK-surf/Comma)

## 首次启动

一个示例。你在终端里克隆代码仓库，复制示例设置，然后用 Docker Compose 启动 Comma。设置步骤最先运行，接着是 PostgreSQL、Redis、ClickHouse、MinIO 和一个本地收件箱。然后，整套服务创建存储桶并准备好数据库，Comma 的服务端和网页版最后启动。终端后面是一个打开 localhost:8080 的浏览器，Comma 正在等你输入它发出的登录验证码。

## 你的机器上运行着什么

一张自托管实例的示意图。在你的机器里，Comma 的网页版、Admin、API 和 Salix 与 PostgreSQL、Redis、ClickHouse、MinIO 以及一个本地收件箱一起运行。模型调用发往你的模型服务商。如果你添加了 Exa 的密钥，网页搜索会发往 Exa。在公开实例上，登录验证码通过你的邮件服务器发出。

### 一整套服务

Docker Compose 会启动 Comma 的网页版、Admin、API 和 Salix，以及 PostgreSQL、Redis、ClickHouse、MinIO 和一个本地收件箱。

### 数据留在这里

你的任务、对话和文件都存放在这些数据库里，就在你的机器上。

### 调用只去你指定的地方

模型调用发往你的服务商，网页搜索在你添加 Exa 的密钥后发往 Exa，登录邮件经由你的邮件服务器发出。整套服务不会向 Comma 发送任何分析数据或追踪数据。

## 由你掌控

### 使用你自己的模型

在 .env 中填写服务商的接口地址、模型和密钥。模型调用由你的服务商向你计费，你不需要 Comma 的套餐、额度或银行卡。

[模型设置](https://comma.surf/zh/docs/self-host/configuration#model-provider)

### 代码可读，也可改

Comma 以 AGPL-3.0 协议开源。你可以阅读代码、修改它，并构建自己的版本。每个实例都会提供它自己这次构建的源代码。

[在 GitHub 上查看](https://github.com/AFK-surf/Comma)

### 开放给你的团队

为网页版、Admin 和 API 分别配置同一域名下的 HTTPS 地址。为登录验证码配置一个真实的邮件服务器。注册默认关闭，直到你打开它。

[公开访问](https://github.com/AFK-surf/Comma#public-access)

### 升级不丢数据

升级会重新构建代码，并保留存放你的数据和密钥的五个数据卷。升级前先把它们一起备份，再用同一个项目名启动下一个版本。

[升级与备份](https://comma.surf/zh/docs/self-host/operations)

## 托管还是自托管

|  | comma.surf | 自托管 |
| --- | --- | --- |
| 运行在 | Comma 的服务器 | 你自己管理的机器 |
| 你的数据 | 由 Comma 存储 | 在你自己的数据库里 |
| 模型 | Comma 的模型，或你自己的密钥或订阅 | 你的服务商，或每人各自的私有模型 |
| 费用 | 套餐和额度 | 你的机器和你的模型调用 |
| 云电脑 | 每个工作区一台 | 默认关闭，需要 Cloudflare |
| 会议录音 | 包含 | 不包含，可定制 |
| 更新与备份 | 由 Comma 负责 | 由你负责 |

## 常见问题

### 运行它需要什么？

需要 Docker Engine 和 Compose v2.24 或更高版本，以及足够首次构建使用的磁盘空间，首次构建会下载所需的工具链。要进行真实的模型调用，你还需要一个模型服务商账号。

### 需要 Comma 账号吗？

不需要。整套服务从公开的代码仓库构建，不需要 Comma 账号，也不需要访问令牌。你用邮箱验证码登录你自己的实例。

### 自托管实例要花多少钱？

Comma 不为此收费，也不需要套餐、额度或银行卡。你为运行它的机器付费。模型调用由你的模型服务商向你计费。如果你添加了 Exa 的密钥，网页搜索由 Exa 计费。

### 我可以用哪些模型？

在 .env 中为整个实例设置一个模型：它的接口地址、它使用的 API、模型 ID 和一个密钥。如果不设置，每个人登录后可以在设置中添加自己的私有模型，调用会使用这个人的服务商账号。

### 自托管不包含哪些功能？

会议录音需要一个代码仓库里没有的运行时。云电脑默认关闭，新建云电脑需要配置 Cloudflare。在设备设置中连接你自己的电脑后，Comma 仍然可以在上面工作。

### AGPL 对我有什么要求？

在 AGPL-3.0 下，你可以运行、研究和修改 Comma 的代码。如果你把修改后的版本提供给其他人使用，就要让他们能拿到它的源代码。每个实例本来就会在 /source.tar.gz 提供它自己这次构建的源代码。

## Run Comma, Yourself.

[阅读指南](https://comma.surf/zh/docs/self-host/install)
