前些天发现了一个巨牛的人工智能学习网站通俗易懂风趣幽默忍不住分享一下给大家:人工智能学习网环境要求在开始之前请确保你的设备满足以下条件项目要求操作系统Windows 10/11建议开启 WSL 2内存至少 4 GB推荐 8 GBCPU至少双核预装软件Docker Desktop、Docker Compose、Git、VS Code推荐⚠️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.yaml2. 修改模型配置编辑backend/conf/model/ark_doubao-seed-1.6.yaml修改以下字段id:1001# 自定义唯一模型 ID必须是非零整数meta:conn_config:api_key:你的 Volcengine Ark API Keymodel:ep-xxxxxxxxxxxxxxxxxxxxxx# ⚠️ 填写 Endpoint ID不是模型名模型字段说明字段说明id自定义模型 ID必须唯一api_key在火山方舟后台申请的 API 密钥modelEndpoint ID形如ep-m-20250319200227-k7zp5不是doubao-seed-1.6步骤三配置环境变量进入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文件换行符是CRLFLinux 容器只能识别LF脚本虽然存在但 shell 认为它无效或无法执行解决方案一推荐修改换行符为 LF用 VS Code 打开docker/volumes/elasticsearch/setup_es.sh点击右下角的CRLF→ 选择LF保存并重新启动容器或使用 Notepad → 菜单编辑 → EOL转换 → 转换为 UNIX格式解决方案二使用 WSL 命令行运行 Composecd/mnt/c/Users/你的用户名/Desktop/coze-studio/dockerdockercompose--profile*up-d步骤五访问 Web 页面启动完成后打开浏览器输入http://localhost:8888补充说明服务状态正常与否服务启动后以下几个容器退出Exited (0)是正常现象coze-elasticsearch-setupcoze-minio-setupcoze-mysql-setup-init-sqlcoze-mysql-setup-schema只要看到Container coze-server Started就代表你的 Coze Studio 成功跑起来了觉得写的不错的话点个关注不迷路 
长河君 · 2026/9/10 12:31:02 · 阅读 1.2k 别再被卡住了！Coze Studio 开源版本地部署 5 分钟搞定（含完整踩坑指南 适配windows系统）
前些天发现了一个巨牛的人工智能学习网站通俗易懂风趣幽默忍不住分享一下给大家:人工智能学习网环境要求在开始之前请确保你的设备满足以下条件项目要求操作系统Windows 10/11建议开启 WSL 2内存至少 4 GB推荐 8 GBCPU至少双核预装软件Docker Desktop、Docker Compose、Git、VS Code推荐⚠️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.yaml2. 修改模型配置编辑backend/conf/model/ark_doubao-seed-1.6.yaml修改以下字段id:1001# 自定义唯一模型 ID必须是非零整数meta:conn_config:api_key:你的 Volcengine Ark API Keymodel:ep-xxxxxxxxxxxxxxxxxxxxxx# ⚠️ 填写 Endpoint ID不是模型名模型字段说明字段说明id自定义模型 ID必须唯一api_key在火山方舟后台申请的 API 密钥modelEndpoint ID形如ep-m-20250319200227-k7zp5不是doubao-seed-1.6步骤三配置环境变量进入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文件换行符是CRLFLinux 容器只能识别LF脚本虽然存在但 shell 认为它无效或无法执行解决方案一推荐修改换行符为 LF用 VS Code 打开docker/volumes/elasticsearch/setup_es.sh点击右下角的CRLF→ 选择LF保存并重新启动容器或使用 Notepad → 菜单编辑 → EOL转换 → 转换为 UNIX格式解决方案二使用 WSL 命令行运行 Composecd/mnt/c/Users/你的用户名/Desktop/coze-studio/dockerdockercompose--profile*up-d步骤五访问 Web 页面启动完成后打开浏览器输入http://localhost:8888补充说明服务状态正常与否服务启动后以下几个容器退出Exited (0)是正常现象coze-elasticsearch-setupcoze-minio-setupcoze-mysql-setup-init-sqlcoze-mysql-setup-schema只要看到Container coze-server Started就代表你的 Coze Studio 成功跑起来了觉得写的不错的话点个关注不迷路