Coze 性能优化教程｜附完整命令

适用场景：本文主要面向 自部署 Coze / Coze Studio / 类 Coze 智能体平台 的性能优化，尤其适用于使用 Linux + Docker / Docker Compose + Nginx + MySQL / Redis / 向量数据库 / 对象存储 部署的场景。
如果你使用的是 Coze 官方云服务，无法直接调整底层系统参数，但仍可以参考本文中的 工作流设计、知识库优化、模型调用优化、缓存策略 等部分。

一、为什么 Coze 需要性能优化？

Coze 作为智能体平台，通常会涉及以下核心链路：

1. 用户访问 Web 页面；
2. 后端 API 接收请求；
3. 调用大模型接口；
4. 查询知识库或向量数据库；
5. 执行工作流、插件、工具调用；
6. 返回流式或非流式结果；
7. 记录会话、日志、任务状态等数据。

因此，Coze 的性能瓶颈通常不只在一个地方，而是可能出现在：

• 服务器 CPU、内存、磁盘 I/O；
• Docker 容器资源限制；
• Nginx 反向代理配置；
• 数据库慢查询；
• Redis 缓存不足；
• 向量检索性能差；
• 知识库切分不合理；
• 工作流节点过多；
• 大模型调用延迟高；
• 日志量过大；
• 并发连接数限制过低。

本文会从 系统层、容器层、反向代理层、数据库层、缓存层、应用层、知识库与工作流层 逐步优化，并附上可以直接执行或参考修改的完整命令。

二、优化前准备：确认服务器配置

在开始优化前，先确认当前机器资源。

# 查看 CPU 信息
lscpu

# 查看内存
free -h

# 查看磁盘空间
df -h

# 查看磁盘 I/O 情况
iostat -x 1 5

# 如果没有 iostat，先安装 sysstat
sudo apt update
sudo apt install -y sysstat

# 查看系统负载
uptime

# 查看当前进程资源占用
top

# 更友好的交互式资源查看工具
sudo apt install -y htop
htop

如果你的 Coze 部署在生产环境，建议最低配置：

如果同时运行数据库、Redis、向量数据库、对象存储、后端服务和前端服务，内存一定不要太小。很多 Coze 卡顿问题并不是代码问题，而是 内存不足导致频繁 Swap 或容器被系统杀掉。

三、第一步：更新系统并安装常用诊断工具

以 Ubuntu / Debian 系统为例：

sudo apt update
sudo apt upgrade -y

sudo apt install -y \
  curl \
  wget \
  vim \
  git \
  unzip \
  net-tools \
  htop \
  iftop \
  iotop \
  sysstat \
  lsof \
  jq \
  tree \
  ca-certificates \
  gnupg

CentOS / Rocky Linux / AlmaLinux 可使用：

sudo yum update -y

sudo yum install -y \
  curl \
  wget \
  vim \
  git \
  unzip \
  net-tools \
  htop \
  iftop \
  iotop \
  sysstat \
  lsof \
  jq \
  tree

四、第二步：优化 Linux 系统参数

1. 提高文件句柄数量

Coze 在高并发下会产生大量网络连接、日志文件、数据库连接。如果文件句柄过低，可能出现：

• too many open files
• WebSocket 连接异常
• API 请求偶发失败
• 容器日志写入异常

执行：

sudo vim /etc/security/limits.conf

在文件末尾追加：

* soft nofile 1048576
* hard nofile 1048576
* soft nproc 65535
* hard nproc 65535
root soft nofile 1048576
root hard nofile 1048576

然后修改 systemd 配置：

sudo vim /etc/systemd/system.conf

确认或追加：

DefaultLimitNOFILE=1048576
DefaultLimitNPROC=65535

再修改用户级 systemd：

sudo vim /etc/systemd/user.conf

加入：

DefaultLimitNOFILE=1048576
DefaultLimitNPROC=65535

重新加载配置：

sudo systemctl daemon-reexec

查看是否生效：

ulimit -n

如果没有生效，可以重新登录 SSH 或重启服务器：

sudo reboot

2. 优化内核网络参数

创建优化配置文件：

sudo vim /etc/sysctl.d/99-coze-performance.conf

写入以下内容：

# 提高最大连接队列
net.core.somaxconn = 65535
net.core.netdev_max_backlog = 65535

# TCP 队列优化
net.ipv4.tcp_max_syn_backlog = 65535
net.ipv4.tcp_syncookies = 1

# 端口范围扩大
net.ipv4.ip_local_port_range = 1024 65535

# TIME_WAIT 复用
net.ipv4.tcp_tw_reuse = 1

# 减少 FIN 等待时间
net.ipv4.tcp_fin_timeout = 15

# TCP keepalive 优化
net.ipv4.tcp_keepalive_time = 600
net.ipv4.tcp_keepalive_intvl = 30
net.ipv4.tcp_keepalive_probes = 5

# 内存相关
vm.swappiness = 10
vm.max_map_count = 262144

# 文件句柄
fs.file-max = 2097152

应用配置：

sudo sysctl --system

检查关键参数：

sysctl net.core.somaxconn
sysctl net.ipv4.ip_local_port_range
sysctl vm.max_map_count

注意：vm.max_map_count 对 Elasticsearch、OpenSearch、部分向量数据库非常重要，如果过低可能导致容器启动失败或检索性能异常。

五、第三步：优化 Docker 运行环境

1. 安装或升级 Docker

如果你还没有安装 Docker，可以执行：

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

启动 Docker：

sudo systemctl enable docker
sudo systemctl start docker

查看版本：

docker version
docker compose version

如果没有 Docker Compose 插件：

sudo apt install -y docker-compose-plugin

2. 配置 Docker 日志大小

默认 Docker 容器日志可能无限增长，导致磁盘被打满。建议限制日志大小。

创建或修改：

sudo vim /etc/docker/daemon.json

写入：

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

重启 Docker：

sudo systemctl daemon-reload
sudo systemctl restart docker

检查配置：

docker info | grep -A 5 "Logging Driver"

3. 清理无用镜像和容器

Coze 长期运行、频繁升级后，服务器中可能残留大量旧镜像。

# 查看磁盘占用
docker system df

# 清理停止的容器、无用网络、悬空镜像
docker system prune -f

# 清理未使用的镜像，谨慎执行
docker image prune -a -f

# 清理无用 volume，生产环境谨慎执行
docker volume prune -f

注意：docker volume prune 可能删除未挂载的数据卷，如果数据库或对象存储使用 Docker Volume，请务必确认后再执行。

六、第四步：为 Coze 服务设置合理资源限制

如果你使用 docker-compose.yml 部署 Coze，可以对核心服务设置资源限制，避免某个容器吃光整机资源。

示例：

services:
  coze-server:
    image: your-coze-server-image:latest
    restart: always
    deploy:
      resources:
        limits:
          cpus: "4"
          memory: 4096M
        reservations:
          cpus: "1"
          memory: 1024M
    ulimits:
      nofile:
        soft: 1048576
        hard: 1048576

  redis:
    image: redis:7
    restart: always
    command: redis-server /usr/local/etc/redis/redis.conf
    deploy:
      resources:
        limits:
          cpus: "1"
          memory: 1024M
    ulimits:
      nofile:
        soft: 1048576
        hard: 1048576

  mysql:
    image: mysql:8
    restart: always
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4096M
    ulimits:
      nofile:
        soft: 1048576
        hard: 1048576

如果你使用的是普通 docker compose，部分 deploy.resources 在非 Swarm 模式下不一定完全生效，可以改用：

services:
  coze-server:
    mem_limit: 4096m
    cpus: 4
    restart: always

重启服务：

docker compose down
docker compose up -d

查看容器资源占用：

docker stats

七、第五步：优化 Nginx 反向代理

如果 Coze 前面使用 Nginx，建议开启连接复用、压缩、超时控制和 WebSocket 支持。

安装 Nginx：

sudo apt install -y nginx

创建站点配置：

sudo vim /etc/nginx/conf.d/coze.conf

示例配置：

upstream coze_backend {
    server 127.0.0.1:8888;
    keepalive 64;
}

server {
    listen 80;
    server_name your-domain.com;

    client_max_body_size 100m;

    gzip on;
    gzip_comp_level 5;
    gzip_min_length 1k;
    gzip_types
        text/plain
        text/css
        application/json
        application/javascript
        text/xml
        application/xml
        application/xml+rss
        text/javascript;

    proxy_connect_timeout 60s;
    proxy_send_timeout 300s;
    proxy_read_timeout 300s;

    location / {
        proxy_pass http://coze_backend;
        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";

        proxy_buffering off;
    }
}

测试配置：

sudo nginx -t

重载 Nginx：

sudo systemctl reload nginx

查看 Nginx 状态：

sudo systemctl status nginx

如果需要 HTTPS，可以使用 Certbot：

sudo apt install -y certbot python3-certbot-nginx

sudo certbot --nginx -d your-domain.com

八、第六步：优化数据库性能

Coze 会频繁读写用户、会话、智能体配置、工作流、插件配置、任务状态等数据。数据库性能直接影响后台操作和接口响应。

以下以 MySQL 8 为例。

1. 进入 MySQL 容器

docker ps

找到 MySQL 容器名，例如 coze-mysql，进入：

docker exec -it coze-mysql mysql -uroot -p

查看当前连接数：

SHOW STATUS LIKE 'Threads_connected';
SHOW VARIABLES LIKE 'max_connections';

查看慢查询是否开启：

SHOW VARIABLES LIKE 'slow_query_log';
SHOW VARIABLES LIKE 'long_query_time';

2. 开启慢查询日志

如果 MySQL 使用配置文件挂载，可以编辑 my.cnf：

sudo mkdir -p /opt/coze/mysql/conf

sudo vim /opt/coze/mysql/conf/my.cnf

写入：

[mysqld]
max_connections = 1000
innodb_buffer_pool_size = 2G
innodb_log_file_size = 512M
innodb_flush_log_at_trx_commit = 2
innodb_flush_method = O_DIRECT

slow_query_log = 1
slow_query_log_file = /var/lib/mysql/slow.log
long_query_time = 1

character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

skip-name-resolve

innodb_buffer_pool_size 建议设置为数据库可用内存的 50%～70%。如果数据库和 Coze 后端部署在同一台机器，不要设置过大。

重启 MySQL 容器：

docker compose restart mysql

查看慢查询日志：

docker exec -it coze-mysql bash
tail -f /var/lib/mysql/slow.log

3. 查看数据库体积

SELECT 
  table_schema AS db_name,
  ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) AS size_mb
FROM information_schema.tables
GROUP BY table_schema
ORDER BY size_mb DESC;

查看大表：

SELECT 
  table_name,
  table_rows,
  ROUND((data_length + index_length) / 1024 / 1024, 2) AS size_mb
FROM information_schema.tables
WHERE table_schema = DATABASE()
ORDER BY size_mb DESC
LIMIT 20;

如果日志表、消息表、任务表增长过快，需要定期归档或清理历史数据。清理前一定要备份。

九、第七步：优化 Redis 缓存

Redis 通常用于缓存会话、任务状态、限流信息、临时数据等。Redis 慢会导致接口响应变慢。

1. 查看 Redis 状态

docker exec -it coze-redis redis-cli info

查看内存：

docker exec -it coze-redis redis-cli info memory

查看连接数：

docker exec -it coze-redis redis-cli info clients

查看慢查询：

docker exec -it coze-redis redis-cli slowlog get 10

2. Redis 推荐配置

创建配置文件：

sudo mkdir -p /opt/coze/redis

sudo vim /opt/coze/redis/redis.conf

写入：

bind 0.0.0.0
port 6379

timeout 0
tcp-keepalive 300

maxclients 10000
maxmemory 1gb
maxmemory-policy allkeys-lru

appendonly yes
appendfsync everysec

save 900 1
save 300 10
save 60 10000

slowlog-log-slower-than 10000
slowlog-max-len 128

说明：

• maxmemory 根据服务器内存调整；
• allkeys-lru 适合缓存场景；
• appendfsync everysec 在性能和数据安全之间比较均衡；
• 如果 Redis 只做缓存且不要求持久化，可以关闭 AOF，但不建议生产环境随意关闭。

重启 Redis：

docker compose restart redis

十、第八步：优化知识库与向量检索

Coze 的知识库问答性能，通常由以下因素决定：

1. 文档数量；
2. 文档切片大小；
3. embedding 模型速度；
4. 向量数据库性能；
5. Top K 设置；
6. 是否开启重排模型；
7. 检索结果是否过多；
8. 工作流中是否重复检索。

推荐策略

1. 合理切分文档

知识库切片不是越小越好，也不是越大越好。

推荐：

如果切片太小，召回片段多但上下文不完整；如果切片太大，检索速度变慢且模型输入 Token 增加。

2. 降低 Top K

很多人会把 Top K 设置到 10、20，导致每次检索返回大量文本，再交给大模型处理，延迟和费用都会升高。

建议：

• 普通问答：Top K = 3～5
• 精准资料库：Top K = 2～4
• 长文档检索：Top K = 5～8

如果开启重排模型，可以适当提高初始召回数量，但最终传给模型的内容不要太多。

3. 避免重复检索

在工作流中，如果多个节点都查询同一个知识库，会造成明显延迟。建议：

• 在前置节点统一检索；
• 将检索结果保存为变量；
• 后续节点复用变量；
• 不要每个节点都重新调用知识库。

十一、第九步：优化大模型调用

Coze 的响应速度很大程度取决于模型接口。即使服务器性能很好，如果模型本身响应慢，整体体验仍然慢。

1. 控制 Prompt 长度

过长的 System Prompt、用户上下文、知识库内容都会增加模型推理时间。

建议：

• 删除无意义角色描述；
• 把复杂规则拆成短规则；
• 只保留当前任务相关上下文；
• 限制历史对话轮数；
• 检索内容只传最相关片段。

2. 使用流式输出

如果支持流式输出，建议开启。虽然总耗时不一定明显减少，但用户会更早看到结果，体感速度大幅提升。

3. 为不同任务选择不同模型

不要所有任务都使用最大模型。可以按任务拆分：

这样可以显著降低延迟和成本。

十二、第十步：优化工作流设计

工作流越复杂，节点越多，延迟越高。常见性能问题包括：

• 串行节点过多；
• 每个节点都调用模型；
• 每个节点都访问外部 API；
• 缺少缓存；
• 条件判断过于复杂；
• 循环次数过多；
• 插件超时时间过长。

优化建议

1. 能并行就不要串行

如果 A、B、C 三个节点之间没有依赖关系，应尽量并行执行。

2. 减少模型调用次数

例如原来流程是：

用户输入 → 模型判断意图 → 模型提取参数 → 模型生成查询语句 → 模型总结结果

可以优化为：

用户输入 → 模型一次性输出意图和参数 → 查询数据 → 模型总结结果

这样可以减少 1～2 次模型调用。

3. 对稳定结果做缓存

例如：

• 产品价格；
• 固定 FAQ；
• 地区列表；
• 配置项；
• 用户权限；
• 常用工具返回结果。

这些都可以缓存，避免每次重新计算。

十三、第十一步：配置监控与日志分析

没有监控就无法判断优化是否有效。建议至少监控：

• CPU 使用率；
• 内存使用率；
• 磁盘 I/O；
• Docker 容器资源；
• Nginx 请求耗时；
• 数据库慢查询；
• Redis 内存；
• 接口错误率；
• 模型调用耗时；
• 工作流平均耗时。

1. 快速查看 Docker 容器资源

docker stats

2. 查看容器日志

docker logs -f --tail=200 coze-server

3. 查看 Nginx 访问日志

sudo tail -f /var/log/nginx/access.log

4. 查看 Nginx 错误日志

sudo tail -f /var/log/nginx/error.log

5. 查找耗时较高的请求

如果 Nginx 日志格式包含请求时间，可以使用：

awk '{print $0}' /var/log/nginx/access.log | tail -n 100

建议自定义 Nginx 日志格式：

log_format coze_main '$remote_addr - $remote_user [$time_local] "$request" '
                     '$status $body_bytes_sent "$http_referer" '
                     '"$http_user_agent" "$http_x_forwarded_for" '
                     'rt=$request_time uct=$upstream_connect_time '
                     'uht=$upstream_header_time urt=$upstream_response_time';

access_log /var/log/nginx/coze_access.log coze_main;

重载：

sudo nginx -t
sudo systemctl reload nginx

查看慢请求：

awk '{print $0}' /var/log/nginx/coze_access.log | sort -kNF | tail -n 50

十四、第十二步：备份与升级前检查

优化前务必备份，尤其是数据库、对象存储和配置文件。

1. 备份 MySQL

mkdir -p /opt/backup/coze

docker exec coze-mysql mysqldump -uroot -p your_database_name > /opt/backup/coze/coze_$(date +%F).sql

压缩备份：

gzip /opt/backup/coze/coze_$(date +%F).sql

2. 备份 Docker Compose 配置

cp docker-compose.yml docker-compose.yml.bak.$(date +%F-%H%M%S)

如果有 .env 文件：

cp .env .env.bak.$(date +%F-%H%M%S)

3. 备份 Nginx 配置

sudo cp /etc/nginx/conf.d/coze.conf /etc/nginx/conf.d/coze.conf.bak.$(date +%F-%H%M%S)

十五、一键巡检命令

下面提供一个简单的巡检脚本，用于快速查看服务器和 Docker 状态。

创建脚本：

vim coze_check.sh

写入：

#!/usr/bin/env bash

echo "========== System Info =========="
hostnamectl
echo

echo "========== CPU =========="
lscpu | grep -E "Model name|CPU\\(s\\)"
echo

echo "========== Memory =========="
free -h
echo

echo "========== Disk =========="
df -h
echo

echo "========== Load =========="
uptime
echo

echo "========== Top Processes =========="
ps aux --sort=-%cpu | head -n 10
echo

echo "========== Docker Version =========="
docker version --format '{{.Server.Version}}'
echo

echo "========== Docker Containers =========="
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
echo

echo "========== Docker Stats Snapshot =========="
docker stats --no-stream
echo

echo "========== Docker Disk Usage =========="
docker system df
echo

echo "========== Network Listen Ports =========="
ss -tulnp
echo

echo "========== Kernel Params =========="
sysctl net.core.somaxconn
sysctl net.ipv4.ip_local_port_range
sysctl vm.swappiness
sysctl vm.max_map_count
echo

echo "========== Done =========="

授权并执行：

chmod +x coze_check.sh
./coze_check.sh

十六、推荐的优化顺序

如果你不知道从哪里开始，建议按照以下顺序：

1. 先备份数据和配置；
2. 查看 CPU、内存、磁盘是否不足；
3. 清理 Docker 日志和无用镜像；
4. 调整 Linux 文件句柄和网络参数；
5. 优化 Docker 日志限制；
6. 优化 Nginx 反代配置；
7. 检查数据库慢查询和连接数；
8. 检查 Redis 内存和慢查询；
9. 降低知识库 Top K；
10. 减少 Prompt 和上下文长度；
11. 减少工作流模型调用次数；
12. 建立监控和定期巡检机制。

十七、常见问题排查

1. Coze 页面打开慢

可能原因：

• 前端静态资源未压缩；
• Nginx 未开启 gzip；
• 服务器带宽低；
• 后端接口慢；
• 数据库响应慢。

排查命令：

curl -o /dev/null -s -w "time_namelookup:%{time_namelookup}\ntime_connect:%{time_connect}\ntime_starttransfer:%{time_starttransfer}\ntime_total:%{time_total}\n" https://your-domain.com

2. 对话回复慢

可能原因：

• 模型接口慢；
• Prompt 太长；
• 知识库检索结果太多；
• 工作流节点太多；
• 插件接口超时。

建议：

• 开启流式输出；
• 降低 Top K；
• 减少历史对话轮数；
• 简化工作流；
• 给插件设置合理超时。

3. 容器频繁重启

排查：

docker ps -a
docker logs --tail=300 coze-server
docker inspect coze-server | jq '.[0].State'

常见原因：

• 内存不足；
• 环境变量错误；
• 数据库连接失败；
• Redis 连接失败；
• 端口冲突；
• 配置文件格式错误。

4. 磁盘空间被打满

排查：

df -h
du -sh /* 2>/dev/null | sort -h
docker system df

清理日志：

sudo journalctl --vacuum-time=7d
docker system prune -f

查看大文件：

sudo find / -type f -size +500M 2>/dev/null

十八、总结

Coze 性能优化不是单纯“加机器”就能解决的问题，而是需要从多个层面系统处理：

• 系统层：提高连接数、文件句柄、网络队列；
• Docker 层：限制日志、清理资源、合理分配 CPU 和内存；
• Nginx 层：开启压缩、连接复用、WebSocket 支持；
• 数据库层：开启慢查询、优化连接数和缓存；
• Redis 层：设置内存上限和淘汰策略；
• 知识库层：合理切片、降低 Top K、避免重复检索；
• 模型层：减少 Prompt、选择合适模型、开启流式输出；
• 工作流层：减少串行节点和重复模型调用；
• 运维层：建立监控、日志分析和备份机制。

对于大多数 Coze 部署来说，最有效的优化通常是：

1. 减少不必要的大模型调用；
2. 降低知识库检索返回内容；
3. 优化数据库和 Redis；
4. 限制 Docker 日志增长；
5. 改善 Nginx 和系统连接参数。

只要按照本文步骤逐步排查和优化，Coze 的访问速度、对话响应速度和高并发稳定性都会有明显提升。