别再被卡住了！Coze Studio 开源版本地部署 5 分钟搞定（含完整踩坑指南 适配windows系统）

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家:人工智能学习网

环境要求

在开始之前，请确保你的设备满足以下条件：

⚠️Docker Desktop 必须启用 WSL 2 后端

步骤一：克隆项目源码

gitclone https://github.com/coze-dev/coze-studio.gitcdcoze-studio

步骤二：配置模型（以火山引擎 Ark 的 doubao 模型为例）

1. 复制模型模板

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

2. 修改模型配置

编辑backend/conf/model/ark_doubao-seed-1.6.yaml，修改以下字段：

id:1001# 自定义唯一模型 ID，必须是非零整数meta:conn_config:api_key:<你的 Volcengine Ark API Key>model:ep-xxxxxxxxxxxxxxxxxxxxxx# ⚠️ 填写 Endpoint ID，不是模型名！

模型字段说明：

步骤三：配置环境变量

进入docker目录，复制.env文件：

cddockercp.env.example .env

步骤四：启动服务（重点来了！）

正确的 Docker Compose 命令（避免多个项目混在一起）

如果你有多个项目都叫docker文件夹，建议指定项目名：

dockercompose-pcoze-studio--profile"*"up-d

否则默认项目名为docker，多个项目的网络、容器可能会冲突。

常见报错 & Windows 特有坑解决

报错：/bin/sh: /setup_es.sh: not found

这是 Windows 用户常见问题！

原因：

• Windows 保存的.sh文件换行符是CRLF，Linux 容器只能识别LF
• 脚本虽然存在，但 shell 认为它无效或无法执行

解决方案一（推荐）：修改换行符为 LF

用 VS Code 打开docker/volumes/elasticsearch/setup_es.sh：

• 点击右下角的CRLF→ 选择LF
• 保存并重新启动容器

或使用 Notepad++ → 菜单：编辑 → EOL转换 → 转换为 UNIX格式

解决方案二：使用 WSL 命令行运行 Compose

cd/mnt/c/Users/你的用户名/Desktop/coze-studio/dockerdockercompose--profile"*"up-d

步骤五：访问 Web 页面

启动完成后，打开浏览器输入：

http://localhost:8888

补充说明：服务状态正常与否？

服务启动后，以下几个容器退出（Exited (0)）是正常现象：

• coze-elasticsearch-setup
• coze-minio-setup
• coze-mysql-setup-init-sql
• coze-mysql-setup-schema

只要看到：

Container coze-server Started

就代表你的 Coze Studio 成功跑起来了！

觉得写的不错的话点个关注不迷路