coze 开源版本地部署及踩过的坑【喂饭级教程】

coze 开源版本地部署及踩过的坑【喂饭级教程】

扣子 Coze 教程

字节跳动于2025年7月26日正式宣布,将AI智能体开发平台”扣子(Coze)”的开源版本——Coze Studio开源,具体信息如下:

  • 开源产品:
  • Coze Studio:用于AI Agent开发,提供可视化设计与编排工具,支持零代码或低代码方式快速打造智能体、应用和工作流,适合构建低代码AI产品。
  • Coze Loop:用于运维管理(类似罗盘)。
  • 许可证:采用Apache‑2.0许可证,允许自由使用、修改及商用,限制极少。
  • 技术架构:后端基于Golang开发,前端使用React + TypeScript,整体为微服务架构,遵循领域驱动设计(DDD)原则,具备高性能、高扩展性,便于二次开发。

Coze Studio的开源旨在降低AI Agent开发与应用门槛,鼓励社区共建。本文主要讲一下 本地部署过程及踩过的坑。

网址:www.docker.com/

一路点击下一步安装即可,因为docker会用到hyper-v,如果电脑没开启hyper-v,可能会需要重启一次。

开源地址:github.com/coze-dev/co…

获取源码有两种方式,通过git克隆,或者直接下载源码包

本地没安装git的同学可以使用第二种方式:直接下载源码包

这一步是为了配置项目大模型的,是核心步骤,coze的大模型配置是一个大模型一个专门配置文件,目前支持的大模型相较于dify是不够丰富的,不过相信未来coze会支持的更多,现在支持市面上主流的大模型,也够用了,Coze Studio 支持的模型服务如下:

  • Ark(火山方舟)
  • OpenAI
  • DeepSeek
  • Claude
  • Ollama
  • Qwen
  • Gemini

在 Coze Studio 开源版中,模型配置统一放在 目录中,目录下存在多个 yaml 文件,每个文件对应一个可访问的模型。 为方便开发者快速配置,Coze Studio 在 目录下提供了一些模板文件,覆盖了常见的模型类型,例如火山方舟、OpenAI 等。开发者可以找到对应厂商的模型模板,复制到 目录,根据模板注释设置各个参数。

下面以 模型为例:

1、获取deepseek的api key

地址:platform.deepseek.com/

注册账号并获取自己的api key

2、复制模型配置模版

3、配置大模型

不要被模型配置的一大堆参数吓住了,我们只需要配置核心的几个参数即可:

1、进入docker目录

2、复制项目env配置文件

执行如下命令启动服务:

在浏览器打开地址:http://localhost:8888

1、创建一个工作流

2、设置好节点并测试

问题原因:

我之前本地安装过Mysql服务,所以占用了3306端口了,有两个解决方案:

1、关闭本地mysql服务

快捷键调出运行窗口,输入 即可调出服务运行窗口,找到 服务 ,停止服务即可

2、改配置文件内的mysql端口

修改 docker 目录下的env文件,将mysql端口配置改为其他端口数字即可,只要不和其他服务端口冲突就行

刚拿到coze源码比较激动,急着想看看开源coze长啥样,到底有没有和官方版是否一模一样,直接启动,没想到报错了,原来是忘记启动docker服务了,这点大家可别学我哈[捂脸哭]

好不容易镜像拉完了,到了启动服务的激动时刻,没想到mysql服务启动失败

于是,我进入docker容器内部查看报错原因:

明明配置文件中MYSQL_USER是coze,这里为什么是oot呢?忽然想起,我之前给win全局配置过环境变量:

MYSQL相关的全局变量删掉就好了!

启动发现 容器又启动失败:

我们根据报错去容器内查看提示 文件找不到,但其实这个文件是存在的:

这是为什么呢?答案是:LF和CRLF表示的换行方式不同导致;解决方案:

打开IDE(我这里以vscode举例),切换CRLF为LF即可

有任何问题,可以找我交流,全网同名公众号可以找到我~

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/259483.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 上午8:18
下一篇 2026年3月13日 上午8:18


相关推荐

关注全栈程序员社区公众号