前提条件

参考官方文档：https://github.com/coze-dev/coze-studio/blob/v0.2.2/README.zh_CN.md

安装 Dify 之前, 请确保你的机器已满足最低安装要求：

CPU >= 2 Core
RAM >= 4 GiB

我的系统环境是macos，安装Docker桌面端即可：《在 Mac 内安装 Docker 桌面端》

克隆 Coze 代码仓库

克隆 Coze 源代码至本地环境。

1 2	# 假设当前最新版本为 0.2.2 git clone https://github.com/coze-dev/coze-studio.git --branch v0.2.2

很多人可能访问github有问题，所以也可以用gitee：

1	git clone https://gitee.com/coze-dev/coze-studio.git --branch v0.2.0

启动Coze

step1: Coze 源代码目录

1	cd coze-studio

step2: 复制模型配置模版

1	cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml

step3: 在配置文件目录下，修改模版文件。

进入目录 backend/conf/model。打开复制后的文件ark_doubao-seed-1.6.yaml。
设置 id、meta.conn_config.api_key、meta.conn_config.model 字段，并保存文件。
- id：Coze Studio 中的模型 ID，由开发者自行定义，必须是非 0 的整数，且全局唯一。模型上线后请勿修改模型 id 。
- meta.conn_config.api_key：模型服务的 API Key，在本示例中为火山方舟的 API Key，获取方式可参考获取火山方舟 API Key。
- meta.conn_config.model：模型服务的 model ID，在本示例中为火山方舟 doubao-seed-1.6 模型接入点的 Endpoint ID，获取方式可参考获取 Endpoint ID。

step4: 部署并启动服务。首次部署并启动 Coze Studio 需要拉取镜像、构建本地镜像，可能耗时较久，请耐心等待。部署过程中，你会看到以下日志信息。如果看到提示 “Container coze-server Started”，表示 Coze Studio 服务已成功启动。

# 启动服务
cd docker
cp .env.example .env
docker compose up -d

运行命令后，你应该会看到类似以下的输出，显示所有容器的状态和端口映射：

[+] Running 11/11
 ✔ Container coze-redis          Healthy                                          1.1s 
 ✔ Container coze-minio          Healthy                                          1.1s 
 ✔ Container coze-mysql          Healthy                                          1.1s 
 ✔ Container coze-nsqlookupd     Healthy                                          0.6s 
 ✔ Container coze-nsqd           Running                                          0.0s 
 ✔ Container coze-nsqadmin       Running                                          0.0s 
 ✔ Container coze-elasticsearch  Healthy                                          1.1s 
 ✔ Container coze-etcd           Healthy                                          0.6s 
 ✔ Container coze-milvus         Healthy                                          1.1s 
 ✔ Container coze-server         Running                                          0.0s 
 ✔ Container coze-web            Running                                          0.0s                                     54.2s

最后检查是否所有容器都正常运行：

1	docker compose ps

NAME                 IMAGE                                            COMMAND                    SERVICE         CREATED         STATUS                   PORTS
coze-elasticsearch   bitnami/elasticsearch:8.18.0                     "/opt/bitnami/script…"    elasticsearch   4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52418->9200/tcp, [::]:52418->9200/tcp
coze-etcd            bitnami/etcd:3.5                                 "/opt/bitnami/script…"    etcd            4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:2379-2380->2379-2380/tcp, [::]:2379-2380->2379-2380/tcp
coze-milvus          milvusdb/milvus:v2.5.10                          "/tini -- bash -c '\n…"   milvus          4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52469->9091/tcp, [::]:52469->9091/tcp, 0.0.0.0:52468->19530/tcp, [::]:52468->19530/tcp
coze-minio           minio/minio:RELEASE.2025-06-13T11-33-47Z-cpuv1   "/bin/sh -c '# Run i…"    minio           4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52413->9000/tcp, [::]:52413->9000/tcp, 0.0.0.0:52414->9001/tcp, [::]:52414->9001/tcp
coze-mysql           mysql:8.4.5                                      "docker-entrypoint.s…"    mysql           4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52424->3306/tcp, [::]:52424->3306/tcp
coze-nsqadmin        nsqio/nsq:v1.2.1                                 "/nsqadmin --lookupd…"    nsqadmin        4 minutes ago   Up 3 minutes             0.0.0.0:52449->4171/tcp, [::]:52449->4171/tcp
coze-nsqd            nsqio/nsq:v1.2.1                                 "/nsqd --lookupd-tcp…"    nsqd            4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52451->4150/tcp, [::]:52451->4150/tcp, 0.0.0.0:52450->4151/tcp, [::]:52450->4151/tcp
coze-nsqlookupd      nsqio/nsq:v1.2.1                                 "/nsqlookupd"              nsqlookupd      4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52415->4160/tcp, [::]:52415->4160/tcp, 0.0.0.0:52416->4161/tcp, [::]:52416->4161/tcp
coze-redis           bitnami/redis:8.0                                "/opt/bitnami/script…"    redis           4 minutes ago   Up 3 minutes (healthy)   0.0.0.0:52417->6379/tcp, [::]:52417->6379/tcp
coze-server          opencoze/opencoze:latest                         "/app/opencoze"            coze-server     4 minutes ago   Up 34 seconds            0.0.0.0:8889->8889/tcp, [::]:8889->8889/tcp, 0.0.0.0:52970->8888/tcp, [::]:52970->8888/tcp
coze-web             opencoze/web:latest                              "/docker-entrypoint.…"    coze-web        4 minutes ago   Up 30 seconds            0.0.0.0:8888->80/tcp, [::]:8888->80/tcp

通过这些步骤，你可以在本地成功安装 Coze。

更新 Coze

进入 dify 源代码的 docker 目录，按顺序执行以下命令：

cd coze-studio/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d

同步环境变量配置 (重要！)

如果 .env.example 文件有更新，请务必同步修改你本地的 .env 文件。
检查 .env 文件中的所有配置项，确保它们与你的实际运行环境相匹配。你可能需要将 .env.example 中的新变量添加到 .env 文件中，并更新已更改的任何值。

访问 Coze

# 本地环境
http://localhost:8888/

# 服务器环境
http://your_server_ip:8888/

自定义配置

编辑 .env 文件中的环境变量值。然后重新启动 Coze：

1 2	docker compose down docker compose up -d

完整的环境变量集合可以在 docker/.env.example 中找到。

花日の博客