Coze 生产环境部署指南｜零基础可学

适合对象：

• 想把 Coze / Coze Studio 部署到服务器上的新手
• 想搭建企业内部 AI Agent / 智能体平台的开发者
• 想从测试环境迁移到生产环境的团队

本文将从零开始，讲清楚生产环境部署 Coze 需要准备什么、如何规划服务器、如何使用 Docker 部署、如何配置域名与 HTTPS、如何做安全加固、备份、监控与常见问题排查。

一、什么是 Coze？

Coze 是一个用于构建 AI Bot / AI Agent / 智能体应用的平台。通过 Coze，用户可以快速创建对话机器人、配置插件、接入知识库、设计工作流，并将机器人发布到不同渠道。

在实际业务中，Coze 常用于以下场景：

• 企业智能客服
• 内部知识库问答
• AI 办公助手
• 数据查询机器人
• 自动化流程助手
• 营销文案生成工具
• 私有化智能体平台

如果只是个人体验，通常使用官方提供的在线平台即可；但如果你希望：

• 数据保存在自己的服务器中
• 接入企业内部系统
• 控制模型、插件、知识库和权限
• 满足安全合规要求
• 长期稳定运行

那么就需要进行生产环境部署。

二、生产环境部署前需要理解的概念

在正式部署之前，建议先了解几个基础概念。即使你是零基础，也不用担心，下面会用通俗方式解释。

1. 服务器

服务器可以理解为一台长期在线的电脑。Coze 部署在服务器上后，用户就可以通过浏览器访问它。

常见服务器来源包括：

• 阿里云 ECS
• 腾讯云 CVM
• 华为云服务器
• AWS EC2
• Azure VM
• 公司机房物理服务器
• 私有云虚拟机

2. Linux 系统

生产环境通常使用 Linux 系统，例如：

• Ubuntu Server
• Debian
• CentOS / Rocky Linux
• AlmaLinux

如果你是新手，推荐使用：

Ubuntu Server 22.04 LTS

原因是资料多、社区活跃、软件兼容性好。

3. Docker

Docker 是一种容器化部署工具。你可以把它理解为“软件运行环境打包器”。

使用 Docker 的好处是：

• 不需要手动安装大量依赖
• 环境更统一
• 部署更方便
• 升级和回滚更简单
• 适合生产环境维护

很多现代应用都会使用 Docker 或 Docker Compose 部署。

4. Docker Compose

Docker Compose 用于同时管理多个容器。

一个完整的 Coze 服务可能不仅包含主程序，还可能包含：

• 数据库
• 缓存服务
• 对象存储
• 向量数据库
• 后端服务
• 前端服务
• 网关服务

如果逐个启动会非常麻烦，而 Docker Compose 可以用一个配置文件统一管理。

5. 域名与 HTTPS

生产环境不建议直接使用服务器 IP 访问，而应该配置域名，例如：

https://coze.example.com

同时，生产环境必须启用 HTTPS。HTTPS 可以加密浏览器和服务器之间的数据传输，避免账号、密码、Token 等敏感信息被窃取。

三、生产环境推荐架构

一个较为标准的 Coze 生产环境可以采用如下结构：

用户浏览器
   ↓
域名 / HTTPS
   ↓
Nginx 反向代理
   ↓
Coze Web / API 服务
   ↓
数据库 / 缓存 / 对象存储 / 向量库
   ↓
大模型服务 / 插件服务 / 知识库服务

推荐组件说明

实际部署时，不同版本的 Coze 所依赖的组件可能不同，应以官方文档和项目 README 为准。本文重点讲生产环境思路和通用部署方法。

四、服务器配置建议

服务器配置需要根据使用人数、机器人数量、知识库大小和并发请求量决定。

1. 个人学习或小团队测试

适合 1～5 人体验：

CPU：2 核
内存：4GB
磁盘：50GB SSD
系统：Ubuntu 22.04

这种配置只能用于学习或轻量测试，不建议直接用于正式生产。

2. 小型生产环境

适合 5～30 人使用：

CPU：4 核
内存：8GB～16GB
磁盘：100GB～200GB SSD
带宽：5Mbps 以上

如果知识库文件较多，建议增加磁盘容量。

3. 中型生产环境

适合企业内部使用：

CPU：8 核以上
内存：16GB～32GB
磁盘：300GB SSD 以上
带宽：10Mbps 以上

数据库、对象存储、向量库可以逐步拆分到独立服务器，提升稳定性。

4. 大型生产环境

如果有大量用户、高并发请求或多个业务系统接入，建议采用集群部署：

• 应用服务多副本
• 数据库主从或云数据库
• Redis 高可用
• 对象存储使用云服务或分布式存储
• 统一日志平台
• 统一监控告警
• Kubernetes 管理服务

对于零基础用户，建议先从单机 Docker Compose 部署开始，等业务稳定后再逐步升级。

五、部署前准备工作

1. 准备服务器

假设你已经购买了一台 Ubuntu 22.04 服务器，并拥有 root 权限。

通过 SSH 登录服务器：

ssh root@你的服务器IP

第一次登录后，建议先更新系统：

apt update && apt upgrade -y

安装常用工具：

apt install -y curl wget git vim unzip tar net-tools ca-certificates gnupg lsb-release

2. 设置服务器时区

建议设置为中国时区：

timedatectl set-timezone Asia/Shanghai

查看时间：

date

如果服务器时间不准确，可能会影响日志排查、证书签发和接口鉴权。

3. 创建部署目录

建议所有服务统一放到 /opt 目录下：

mkdir -p /opt/coze
cd /opt/coze

4. 配置防火墙

生产环境只开放必要端口。

常用端口：

如果使用 Ubuntu 的 UFW：

ufw allow 22
ufw allow 80
ufw allow 443
ufw enable

查看状态：

ufw status

六、安装 Docker 和 Docker Compose

1. 安装 Docker

可以使用官方安装脚本：

curl -fsSL https://get.docker.com | bash

启动 Docker：

systemctl enable docker
systemctl start docker

查看 Docker 版本：

docker version

2. 安装 Docker Compose

现在 Docker Compose 通常作为 Docker 插件存在，可以这样查看：

docker compose version

如果系统提示不存在，可以安装：

apt install -y docker-compose-plugin

再次确认：

docker compose version

七、获取 Coze 部署文件

如果你部署的是开源版本，通常需要从官方代码仓库获取项目。

示例：

cd /opt
git clone  coze
cd coze

注意：
不同版本的 Coze 代码仓库地址、目录结构、启动方式可能不同。实际部署时请以官方 GitHub、Gitee 或文档说明为准。

查看项目目录：

ls -la

通常你需要重点关注：

README.md
docker-compose.yml
.env.example
docs/
deploy/

如果项目中提供了 .env.example，一般需要复制为 .env：

cp .env.example .env

然后修改 .env 配置文件。

八、配置环境变量

环境变量是生产部署中非常关键的一步。很多新手部署失败，往往都是因为环境变量没有配置正确。

打开 .env 文件：

vim .env

常见需要配置的内容包括：

1. 服务访问地址

APP_URL=https://coze.example.com
API_URL=https://coze.example.com/api

如果你的服务最终通过域名访问，一定要配置为正式域名，而不是 localhost。

2. 数据库配置

DB_HOST=postgres
DB_PORT=5432
DB_USER=coze
DB_PASSWORD=请设置一个强密码
DB_NAME=coze

生产环境中数据库密码一定不要使用默认值，例如 123456、password、admin。

3. Redis 配置

REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=请设置一个强密码

如果 Redis 没有密码，并且端口暴露到公网，会非常危险。

4. 对象存储配置

如果使用 MinIO：

MINIO_ENDPOINT=http://minio:9000
MINIO_ACCESS_KEY=请设置AccessKey
MINIO_SECRET_KEY=请设置SecretKey
MINIO_BUCKET=coze

如果使用云厂商对象存储，则需要配置对应的：

• Endpoint
• AccessKey
• SecretKey
• Bucket
• Region

5. 大模型配置

Coze 需要调用大模型服务。你可以根据实际情况配置：

LLM_PROVIDER=openai
OPENAI_API_KEY=你的API_KEY
OPENAI_BASE_URL=https://api.openai.com/v1

如果使用国内模型，也可以配置对应的服务商参数，例如：

• 火山方舟 / 豆包
• 阿里云通义千问
• 智谱 GLM
• 百度千帆
• 腾讯混元
• DeepSeek
• 本地大模型服务

6. 安全密钥

很多应用都需要配置 JWT Secret、Session Secret 等：

JWT_SECRET=随机生成的长字符串
SESSION_SECRET=随机生成的长字符串

可以使用下面命令生成随机字符串：

openssl rand -base64 32

生产环境中不要使用默认密钥，否则可能带来严重安全风险。

九、启动 Coze 服务

如果项目提供了 Docker Compose 文件，可以执行：

docker compose up -d

查看容器状态：

docker compose ps

查看日志：

docker compose logs -f

如果只想查看某个服务日志：

docker compose logs -f 服务名

例如：

docker compose logs -f api

常见启动状态

正常情况下，你应该看到各容器状态为：

Up
healthy
running

如果出现：

Exited
Restarting
unhealthy

说明容器启动失败，需要查看日志。

十、配置 Nginx 反向代理

生产环境一般不会直接暴露 Coze 容器端口，而是通过 Nginx 统一代理。

1. 安装 Nginx

apt install -y nginx
systemctl enable nginx
systemctl start nginx

2. 创建站点配置

假设你的域名是：

coze.example.com

创建配置文件：

vim /etc/nginx/sites-available/coze.conf

写入示例配置：

server {
    listen 80;
    server_name coze.example.com;

    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:你的Coze服务端口;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

启用配置：

ln -s /etc/nginx/sites-available/coze.conf /etc/nginx/sites-enabled/coze.conf

检查配置：

nginx -t

重载 Nginx：

systemctl reload nginx

十一、配置 HTTPS 证书

推荐使用 Let’s Encrypt 免费证书。

1. 安装 Certbot

apt install -y certbot python3-certbot-nginx

2. 申请证书

certbot --nginx -d coze.example.com

按照提示输入邮箱、同意协议即可。

申请成功后，访问：

https://coze.example.com

如果可以正常打开，说明 HTTPS 配置成功。

3. 查看自动续期

Let’s Encrypt 证书有效期通常为 90 天，Certbot 会自动续期。

测试续期：

certbot renew --dry-run

十二、生产环境安全加固

部署成功只是第一步，生产环境必须做好安全加固。

1. 不要暴露内部服务端口

数据库、Redis、MinIO 管理端口等不要直接暴露到公网。

错误做法：

0.0.0.0:5432
0.0.0.0:6379
0.0.0.0:9000

正确做法：

• 只在 Docker 内部网络访问
• 或只监听 127.0.0.1
• 云服务器安全组只开放 80、443、22

2. 使用强密码

以下内容都必须使用强密码：

• 数据库密码
• Redis 密码
• MinIO 密钥
• 管理员账号密码
• JWT Secret
• Session Secret

强密码建议：

长度不少于 16 位
包含大小写字母、数字、特殊字符
不要使用公司名、生日、手机号

3. 限制 SSH 登录

建议禁用 root 远程密码登录，改用普通用户 + SSH Key。

创建用户：

adduser deploy
usermod -aG sudo deploy

配置 SSH Key 后，可修改：

vim /etc/ssh/sshd_config

建议配置：

PermitRootLogin no
PasswordAuthentication no

重启 SSH：

systemctl restart ssh

注意：
修改 SSH 配置前，请确保你已经能够使用新用户和密钥登录，否则可能把自己锁在服务器外面。

4. 定期更新系统

apt update && apt upgrade -y

对于生产环境，建议先在测试环境验证，再升级正式环境。

5. 控制管理员权限

不要所有员工都使用管理员账号。应根据业务角色划分权限：

• 平台管理员
• 应用开发者
• 运营人员
• 只读用户
• 审计人员

十三、数据备份策略

生产环境最重要的不是“能跑”，而是“出问题后能恢复”。

1. 需要备份什么？

通常需要备份：

• 数据库数据
• 上传文件
• 对象存储数据
• .env 配置文件
• Nginx 配置文件
• Docker Compose 文件
• 日志归档
• 证书配置

2. 数据库备份示例

如果使用 PostgreSQL，可以执行：

docker exec -t postgres容器名 pg_dump -U coze coze > /backup/coze_$(date +%F).sql

如果使用 MySQL：

docker exec mysql容器名 mysqldump -u coze -p coze > /backup/coze_$(date +%F).sql

3. 定时备份

可以使用 crontab 定时执行备份脚本：

crontab -e

例如每天凌晨 2 点备份：

0 2 * * * /opt/coze/scripts/backup.sh

4. 备份保留策略

建议采用：

本地保留 7 天
远程保留 30 天
重要版本长期归档

备份不要只放在同一台服务器上。否则服务器磁盘损坏时，备份也会一起丢失。

十四、日志与监控

1. 查看 Docker 日志

docker compose logs -f

查看最近 100 行：

docker compose logs --tail=100

2. 控制日志大小

Docker 日志如果不限制，可能会撑爆磁盘。可以配置 Docker 日志轮转。

编辑：

vim /etc/docker/daemon.json

写入：

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "200m",
    "max-file": "5"
  }
}

重启 Docker：

systemctl restart docker

3. 监控指标

生产环境建议监控：

• CPU 使用率
• 内存使用率
• 磁盘空间
• 网络流量
• 容器状态
• 接口响应时间
• 数据库连接数
• Redis 内存
• 大模型接口调用失败率
• Token 消耗量

4. 推荐监控工具

新手可以先使用：

• 云服务器自带监控
• Docker stats
• Uptime Kuma

进阶可以使用：

• Prometheus
• Grafana
• Loki
• Alertmanager

查看容器资源使用：

docker stats

十五、升级与回滚

生产环境升级一定要谨慎。

1. 升级前 checklist

升级前请确认：

• 已阅读版本更新说明
• 已备份数据库
• 已备份配置文件
• 已记录当前版本号
• 已在测试环境验证
• 已准备回滚方案

2. 常见升级流程

cd /opt/coze
git pull
docker compose pull
docker compose down
docker compose up -d

如果涉及数据库迁移，应按照官方说明执行迁移命令。

3. 回滚思路

如果升级后出现严重问题：

1. 停止当前服务
2. 切回旧版本代码或镜像
3. 恢复旧配置
4. 如有必要恢复数据库备份
5. 启动服务
6. 检查核心功能

生产环境不建议在没有备份的情况下直接升级。

十六、常见问题排查

问题 1：容器启动失败

查看日志：

docker compose logs -f

常见原因：

• 环境变量缺失
• 数据库连接失败
• 端口冲突
• 镜像拉取失败
• 权限不足
• 密钥配置错误

问题 2：网页打不开

检查步骤：

docker compose ps
systemctl status nginx
nginx -t
curl -I http://127.0.0.1:端口

还要检查：

• 域名 DNS 是否解析到服务器 IP
• 云服务器安全组是否开放 80/443
• Nginx 代理端口是否正确
• 服务是否实际监听该端口

问题 3：HTTPS 证书申请失败

常见原因：

• 域名没有正确解析
• 80 端口未开放
• Nginx 配置错误
• 防火墙拦截
• 同一域名频繁申请触发限制

问题 4：大模型调用失败

需要检查：

• API Key 是否正确
• Base URL 是否正确
• 模型名称是否支持
• 账户余额是否充足
• 网络是否能访问模型服务
• 是否被代理、防火墙或地区限制影响

问题 5：上传文件失败

检查：

• 对象存储配置是否正确
• Bucket 是否存在
• AccessKey 是否有权限
• 文件大小是否超过 Nginx 限制
• client_max_body_size 是否过小
• 后端服务是否配置了上传大小限制

十七、生产环境最佳实践

为了让 Coze 长期稳定运行，建议遵循以下实践：

1. 测试环境和生产环境分离

不要直接在生产环境试错。建议至少准备两个环境：

测试环境：验证功能、升级、插件配置
生产环境：正式用户使用

2. 配置文件不要提交到公开仓库

.env 文件通常包含敏感信息，不能上传到 GitHub 或其他公开仓库。

应在 .gitignore 中加入：

.env
*.key
*.pem

3. 使用独立域名

建议使用专门子域名：

coze.example.com

不要与官网、管理后台、其他系统混用。

4. 做好权限审计

定期检查：

• 谁拥有管理员权限
• 谁创建了机器人
• 谁配置了插件
• 谁上传了知识库
• 谁调用了敏感接口

5. 控制成本

AI 平台的成本不只包括服务器，还包括：

• 大模型 API 调用费用
• 向量化费用
• 存储费用
• 带宽费用
• 日志与监控费用

建议对不同机器人设置调用限制，避免异常调用造成账单暴涨。

十八、部署完成后的验收清单

部署完成后，不要只看页面能打开，还应逐项检查。

基础访问

• [ ] 域名可以正常访问
• [ ] HTTPS 证书有效
• [ ] HTTP 自动跳转 HTTPS
• [ ] 页面加载正常
• [ ] 登录和退出正常

核心功能

• [ ] 可以创建 Bot / Agent
• [ ] 可以调用大模型
• [ ] 可以上传知识库文件
• [ ] 可以进行知识库问答
• [ ] 可以配置插件或工作流
• [ ] 可以查看运行日志

安全检查

• [ ] 数据库端口未暴露公网
• [ ] Redis 端口未暴露公网
• [ ] 管理员密码已修改
• [ ] .env 文件权限安全
• [ ] SSH 已限制登录方式
• [ ] 防火墙只开放必要端口

运维检查

• [ ] 已配置备份
• [ ] 已测试备份恢复
• [ ] 已配置日志轮转
• [ ] 已配置基础监控
• [ ] 已记录部署文档
• [ ] 已准备升级和回滚方案

十九、零基础部署建议路线

如果你是第一次部署 Coze，可以按照下面路线学习：

第一步：学习 Linux 基础命令
第二步：学会 SSH 登录服务器
第三步：安装 Docker
第四步：使用 Docker Compose 启动服务
第五步：配置域名解析
第六步：配置 Nginx 反向代理
第七步：申请 HTTPS 证书
第八步：配置大模型 API
第九步：测试机器人功能
第十步：配置备份、监控和安全策略

不要一开始就追求复杂集群。对于零基础用户来说，最重要的是先跑通完整流程，然后再逐步优化。

二十、总结

Coze 的生产环境部署并不是简单地“把服务启动起来”，而是一个完整的工程过程。它至少包括服务器准备、Docker 部署、环境变量配置、数据库和缓存管理、域名与 HTTPS、权限控制、数据备份、日志监控、安全加固和升级回滚等环节。

如果你是零基础，建议先使用单机 Docker Compose 方式部署，这是学习成本最低、维护难度相对可控的方案。等业务规模扩大后，再考虑拆分数据库、使用云对象存储、接入监控系统，甚至迁移到 Kubernetes 集群。

最终，一个合格的 Coze 生产环境应该满足三个标准：

1. 稳定可用：服务能长期运行，出现问题可以快速定位。
2. 安全可靠：敏感端口不暴露，账号密钥安全，数据可备份可恢复。
3. 便于维护：有清晰的部署文档、升级流程、回滚方案和监控告警。

只要按照本文的步骤逐步实践，即使你没有太多运维经验，也可以完成一套较为规范的 Coze 生产环境部署。