Coze开源版（即扣子开发平台）虽然功能大幅精简，但依然值得本地部署体验。本文将从功能缩水情况、完整部署流程、常见问题排查三个维度，带你快速上手。
一、Coze开源版功能概述
好消息是扣子官方将开发平台开源了，但坏消息是开源的是“丐版”，即功能被大量阉割。原本对Coze开源抱有较高期待的用户，在本地部署后可能会感到失望。官方这波操作显得格局较小，既然决定开源，至少应拿出更完整的功能。不过，本地部署仍有一定技术门槛，下面我们快速过一遍流程。
二、环境要求
- 硬件最低要求： 2 核 CPU、4 GB 内存
- 软件环境： 预装 Docker 和 Docker Compose，并确保 Docker 服务已启动
小提示：如果系统中未安装Docker，可参考官方文档进行安装；建议使用 Docker Desktop 20.10 及以上版本。
三、部署步骤详解
1. 获取源码
在终端中执行以下命令，克隆 Coze Studio 的代码仓库：
git clone https://github.com/coze-dev/coze-studio.git
2. 配置模型
首先进入项目目录，然后从模板目录复制 doubao-seed-1.6 模型的模板文件到配置目录：
cd coze-studio
cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml接着编辑复制后的配置文件：
vim backend/conf/model/ark_doubao-seed-1.6.yaml你需要根据实际情况填写以下三个关键字段：
- 模型 ID：由开发人员自己定义，必须是非零整数且全局唯一。上线后请勿修改。
- API Key：本例中为 Volcengine Ark 的 API Key。获取方法请参考：https://www.volcengine.com/docs/82379/1541594
- 模型服务的模型 ID：在本例中为 Volcengine 方舟豆包种子-1.6 模型接入点的 Endpoint ID。检索方法请参见：https://www.volcengine.com/docs/82379/1099522
小提示：如果使用其他模型，可参照模板目录下的示例文件自行创建配置；注意API Key和Endpoint ID不要混淆。
3. 部署并启动服务
进入 docker 目录，复制环境变量模板，然后启动所有服务：
cd docker
cp .env.example .env
docker compose --profile '*' up -d服务启动成功后，在浏览器中访问 http://localhost:8888/。如果一切正常，你将看到如下页面：
小提示：首次启动可能需要下载多个镜像，请保持网络畅通；若端口被占用，可修改 .env 文件中的映射端口。
四、常见问题解决方案
问题1：unable to get image 'arigaio/atlas:0.35.0-community-alpine'
解决方法：请确保 Docker 服务已启动，然后手动拉取该镜像：
docker pull arigaio/atlas:0.35.0-community-alpine拉取完成后重新执行 docker compose --profile '*' up -d 即可。
问题2：service "elasticsearch-setup" didn't complete successfully: exit 127
原因：在 Windows 系统下克隆项目后，setup_es.sh 文件包含 CRLF 换行符，而 Linux 容器需要 LF 格式。
解决方法：使用 vim 将文件从 DOS 格式转换为 UNIX 格式：
vim setup_es.sh
:set fileformat=unix
:wq转换后，重新启动容器：
docker compose --profile '*' up -d五、功能体验
由于开源版功能过于简陋（“丐中丐”），此处不再逐一演示具体功能，仅展示页面内容供参考。你可以在本地环境下探索基本的对话、知识库等功能，但 插件、工作流、高级编排等核心能力已被大幅阉割。建议将本地部署作为学习与研究用途，生产环境仍需使用官方托管版。
以上就是 Coze 开源版的完整本地部署教程。虽然功能缩水，但通过本地部署可以快速了解其架构与基本原理，为后续二次开发打下基础。如果遇到其他问题，欢迎在社区或官方 GitHub Issue 中交流。