手把手教你Coze 开发平台开源本地部署详细教程（常见问题合集篇）

字节跳动旗下 AI Agent 开发平台 ------Coze（扣子）正式宣布开源，此次开源包含两大核心项目，全面覆盖 AI 智能体的开发、运维、测试与调优全流程：

CozeStudio（扣子开发平台）
CozeLoop（罗盘运维平台）

该项目采用 Apache 2.0 许可证，相关代码权益如下：

可商用自由：支持商业场景使用，无需附加特殊条款限制；
专利保障明确：包含清晰的专利授权条款，使用时无需担忧知识产权风险；
社区协作开放：鼓励全球开发者共同参与迭代，共建生态未来。

该平台以低门槛著称，仅需 2 核 CPU、4GB 内存即可运行，并配套一键部署脚本，Docker 环境即可快速启用

和公网 Coze 开发平台相比，本地版有这些差异：

功能上少了对话流、对话智能体、多 Agent 体系，也没有AI 应用模块；
缺少自定义空间功能；
发布渠道仅支持 WEB SDK 和 API------ 不过这一取舍其实颇为合理；
授权体系目前只支持个人令牌，且有效期仅能设 30 天。

好在核心功能基本都已覆盖，诚意虽有但不算太足。但对有开发能力的用户来说，它反倒比 Dify、N8N、FastGPT 等工具更值得一试。

更何况这才只是起点，后续的迭代升级值得期待。

整个安装流程共分四步，操作起来很简单，跟着一步步来就行：

安装 Docker Docker 可以理解为一个 "容器软件"，里面预装了 Coze 运行所需的各种组件，是安装 Coze 的必备前提，必须先完成安装。
获取 Coze 安装包可从 GitHub 下载源码或压缩包（码蜂 AI 已整理好安装包，不会下载的同学可私信领取）。
执行安装命令进入 Coze 安装包所在的文件夹，运行对应的安装命令即可启动安装。
初始化并登录完成安装后初始化 Coze 后台，设置用户名和密码，之后就能登录使用了～

具体安装步骤，可以参考这篇文章，这里就不在过多介绍。

本篇主要介绍本地部署coze时遇到的常见问题。

Coze 本地部署常见问题与解决办法：

一、启动coze时执行docker compose --profile up -d时，出现no service selected*

把 docker-compose.yml 里面所有 profile 都删掉

或者替换一下最新的docker-compose.yml文件。

二、Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:3306 -> 0.0.0.0:0: listen tcp 0.0.0.0:3306: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.

这个问题是因为我本地MySQL服务启动着，占用了3306的端口。而coze studio开源默认MySQL对外端口是3306，所以冲突了导致。修改（coze-studio/docker/docker-compose.yml）：

将MySQL对外暴露端口改为一个不存在的端口（比如3366）即可。其他类似端口冲突问题，按照同样方式解决。

三、[MY-012960] [InnoDB] Cannot create redo log files because data files are corrupt or the database was not shut down cleanly after creating the data files.

这个错误来自 MySQL 的 InnoDB 存储引擎，说明 MySQL 启动失败。删除已有的数据文件，重新初始化（适用于开发环境或可清除数据场景）

改进步骤：

1、清空coze-studio/docker/data目录内的文件

2、清空coze-studio/docker/volumes目录内的内容。如果你是Windows，可以直接这样删除：