本文介绍了如何在Windows 11环境下使用Docker部署Coze Studio，包括拉取代码、配置模型、启动服务以及添加新模型的步骤。同时，还提供了常见问题的解决方案，如Elasticsearch设置和端口占用问题，帮助用户顺利部署和运行Coze Studio。

📦 安装Docker并配置镜像源：在Windows 11上部署Coze Studio前，需要安装Docker并配置合适的镜像源以提高下载速度。文章列出了多个可用的镜像源，如unsee.tech、rat.dev等。

🛠️ 拉取代码和配置模型：通过git clone命令获取Coze Studio源代码，并复制模型配置模板进行修改。需要设置模型的id、API key和模型名称等关键信息，以确保服务正常运行。

🚀 启动服务并访问：使用docker compose命令启动Coze Studio服务，并在本地浏览器访问http://localhost:8888进行使用。文章还强调了本地部署无需开放8888端口，简化了配置过程。

🔄 添加新模型：以添加qwen3-235b-a22b-instruct-2507模型为例，详细说明了如何复制配置文件、修改相关字段并重启服务。文章还提供了模型配置的参考链接，方便用户查找更多信息。

🔍 常见问题解决：针对部署过程中可能遇到的Elasticsearch设置问题，文章提供了修改脚本换行符和解决端口占用的方法。通过netstat命令可以检查端口占用情况，并根据提示进行相应调整。

参考链接

github.com/coze-dev/co…

github.com/coze-dev/co…

环境说明

Docker：28.3.2

系统：Window 11

配置要求

CPU：2核

内存：4G

容器镜像源

这里的镜像源可以下载所需要的镜像

"registry-mirrors": [    "https://docker-0.unsee.tech",    "https://hub.rat.dev",    "https://hub.fast360.xyz",    "https://docker.1panel.live"  ]

部署

1）拉取代码

git clone https://github.com/coze-dev/coze-studio.git

2）切换到 coze-studio 目录

cd coze-studio

3）复制模型配置模版

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

4）在配置文件目录下，修改模版文件

目录：backend/conf/model设置 id、meta.conn_config.api_key、meta.conn_config.model 字段，并保存文件模型配置请参考：github.com/coze-dev/co…

以下配置可以参考

ark_doubao-seed-1.6.yaml：

# id 我也进行了修改，还是喜欢按顺序id: 1meta.conn_config.base_url: https://ark.cn-beijing.volces.com/api/v3/meta.conn_config.model: doubao-seed-1-6-250615meta.conn_config.api-key: 需要换成你自己的 api_key （参考：https://www.volcengine.com/docs/82379/1541594）

5）启动服务

cd dockercp .env.example .envdocker compose --profile "*" up -d

最后：使用

访问：http://localhost:8888/

因为我是window本地部署，本地打开的，所以不需要开放8888端口

输入账号密码，点击注册即可使用

如何添加一个新的模型？

以添加一个 qwen 的模型（qwen3-235b-a22b-instruct-2507）为例子

1）打开 backend/conf/model 目录

2）复制 ark_doubao-seed-1.6.yaml，然后修改名称

3）设置 相关 字段，并保存文件

# 必须保证唯一即可id: 2name: qwen3-235b-a22b-instruct-2507# 因为我设置了 icon_url, 这个默认的我就设置为空了icon_uri: # 这个是 qwen 的图标 url, 可以不设icon_url: "https://assets.alicdn.com/g/qwenweb/qwen-webui-fe/0.0.166/static/favicon.png"meta.protocol:qwenmeta.conn_config.base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"meta.conn_config.api_key: 设置成阿里百炼的apikey（https://bailian.console.aliyun.com/?tab=model#/api-key）meta.conn_config.model: "qwen3-235b-a22b-instruct-2507"

4）重新启动服务

cd dockerdocker compose --profile "*" restart coze-server

5）测试

Q&A

service "elasticsearch-setup" didn't complete successfully: exit 127

解决

参考链接：github.com/coze-dev/co…

1）使用代码编辑器（如 VS Code）打开 docker/volumes/elasticsearch/setup_es.sh

我使用的是 Trae

2）修改为 LF，然后保存

Error response from daemon: ports are not available: exposing port TCP 0.0.0.0:6379 -> 127.0.0.1:0: listen tcp 0.0.0.0:6379: bind: An attempt was made to access a socket in a way forbidden by its access permissions

解决

参考链接：github.com/coze-dev/co…

分为两种情况：

端口占用WinNAT 的问题

如何区分是不是端口占用?

window

netstat -ano | findstr :端口

linux

# 和上面的同理netstat -ntpl | grep 端口

端口占用

比如我上面是 6379 端口被占用

1）打开 docker/docker-compose.yml

2）更换端口尝试

WinNAT 的问题

net stop winnatnet start winnat