参考链接
环境说明
Docker:28.3.2
系统:Window 11
配置要求
CPU:2核
内存:4G
容器镜像源
这里的镜像源可以下载所需要的镜像
json
"registry-mirrors": [
"https://docker-0.unsee.tech",
"https://hub.rat.dev",
"https://hub.fast360.xyz",
"https://docker.1panel.live"
]
部署
1)拉取代码
bash
git clone https://github.com/coze-dev/coze-studio.git
2)切换到 coze-studio 目录
bash
cd coze-studio
3)复制模型配置模版
bash
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:
makefile
# id 我也进行了修改,还是喜欢按顺序
id: 1
meta.conn_config.base_url: https://ark.cn-beijing.volces.com/api/v3/
meta.conn_config.model: doubao-seed-1-6-250615
meta.conn_config.api-key: 需要换成你自己的 api_key (参考:https://www.volcengine.com/docs/82379/1541594)

5)启动服务
bash
cd docker
cp .env.example .env
docker compose --profile "*" up -d

最后:使用
因为我是window本地部署,本地打开的,所以不需要开放8888端口
输入账号密码,点击注册即可使用


如何添加一个新的模型?
以添加一个 qwen 的模型(qwen3-235b-a22b-instruct-2507)为例子
1)打开 backend/conf/model 目录

2)复制 ark_doubao-seed-1.6.yaml,然后修改名称

3)设置 相关 字段,并保存文件
makefile
# 必须保证唯一即可
id: 2
name: 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:qwen
meta.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)重新启动服务
bash
cd docker
docker 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
perl
# 和上面的同理
netstat -ntpl | grep 端口
端口占用
比如我上面是 6379 端口被占用
1)打开 docker/docker-compose.yml

2)更换端口尝试

WinNAT 的问题
arduino
net stop winnat
net start winnat