參考鏈接
https://github.com/coze-dev/coze-studio/wiki/2.-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B
https://github.com/coze-dev/coze-studio/wiki/3.-%E6%A8%A1%E5%9E%8B%E9%85%8D%E7%BD%AE
環境說明
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.git2）切換到 coze-studio 目錄
cd coze-studio3）復制模型配置模版
cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml4）在配置文件目錄下，修改模版文件
- 目錄：backend/conf/model
- 設置
id、meta.conn_config.api_key、meta.conn_config.model字段，并保存文件 - 模型配置請參考：https://github.com/coze-dev/coze-studio/wiki/3.-%E6%A8%A1%E5%9E%8B%E9%85%8D%E7%BD%AE
以下配置可以參考
ark_doubao-seed-1.6.yaml：
# 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）啟動服務
cd docker
cp .env.example .env
docker 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: 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）重新啟動服務
cd docker
docker compose --profile "*" restart coze-server?
5）測試
?
?
Q&A
service "elasticsearch-setup" didn't complete successfully: exit 127
解決
參考鏈接：https://github.com/coze-dev/coze-studio/issues/6
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
?
?
解決
參考鏈接：https://github.com/coze-dev/coze-studio/wiki/9.-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
?
分為兩種情況：
- 端口占用
- WinNAT 的問題
?
如何區分是不是端口占用?
- window
netstat -ano | findstr :端口?
- linux
# 和上面的同理
netstat -ntpl | grep 端口?
端口占用
比如我上面是 6379 端口被占用
1）打開 docker/docker-compose.yml
?
2）更換端口嘗試
?
?
WinNAT 的問題
net stop winnat
net start winnat?
?
?
