纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享


Coze 开源了,正在学习 AI 的我赶紧动手试下本地化部署。


作为新手小白,我之前从未Cursor 和 Docker 等工具,用时 3 个小时,根据网上的教程一步步本地化部署Coze ,虽然遇到了点问题,但最终也解决掉了,所以我整理出自己搭建的过程和遇到的问题及解决方法,希望可以帮到有需要的人。


本地化部署 Coze一共五步:

下载 Coze文件配置 Coze下载 安装Docker下载安装Cursor本地运行Coze


一、下载Coze 文件

点击GitHub链接 https://github.com/coze-dev/coze-studio ,点击【Code】下的【Download Zip】,解压下载后的压缩包。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享


二、配置Coze

1.创建 API Key

进入火山引擎官网 https://www.volcengine.com ,打开【控制台】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

搜索并进入【火山方舟】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

点击【API Key 管理】下的【创建 API Key】,选择【创建】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

点击小眼睛即可查看 API Key ,复制备用。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

2.创建Endpoint

进入【在线推理】页面,选择【自定义推理接入点】,点击【创建推理接入点】

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

输入接入点名称,建议以模型命名,点击【添加模型】

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

模型目前支持:豆包、DeepSeek、Kimi、Qwen,这里以豆包 1.6 为例,选择后确定。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

模型首次开通需要实名认证,输入个人信息,手机刷脸验证。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

认证完成刷新网页,勾选协议,点击【开通模型并接入】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

复制Endpoint。注意:模型名称下方的 ID 就是Endpoint。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

3.配置 Coze 文件

1.在解压的Coze 本地文件夹里找到【coze-studio-main/backen/conf/model/tamplate】,找到刚才选定的模型。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享
纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

2.右键选择打开方式【文本编辑】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享
  1. id 修改为任意 5 位以上纯数字。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

4.将前面创建的【API Key】和【Endpoint】填入下图位置内,保存并关闭文件。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

三、下载安装 Docker

1.电脑没有安装过 Docker 的需要打开网站:https://www.docker.com,点击【Download Docker Desktop】,选择适合自己电脑的版本,我 的电脑是 Intel 版 Mac,选择第二个。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

2.下载后安装并打开 Docker Desktop,跳过登录,进入主界面,看到左下方显示【Engine running】则 Docker 正常运行。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享


四、下载安装 Cursor

1.电脑没有装过 Cursor 的点击https://cursor.com/cn下载后安装。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

2.打开软件需要登录,如果不会用 Google 登录,就用 GitHub 登录。

汉化教程参考:https://blog.csdn.net/m0_62930053/article/details/146347432


3.在 Cursor 的【文件】下选择【打开文件夹】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

4.选择下载后 Coze 解压的文件夹

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

5.将左侧 docker 下的【.env.example】文件复制粘贴一份新的文件,并改名为【.env】

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

6.复制后,打开文件选择保存,并退出Cursor。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

7.重新打开 Cursor,打开右上角的终端,可以在中间下方看到终端面板。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

8.在终端里输入以下内容,并回车:

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

之后再输入以下内容,并回车:

cd docker

之后再输入以下内容,并回车:

docker compose --profile '*' up -d

出现以下内容则代表下载完成。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享


Docker 镜像不可用

但是!!!很多人第一次运行 Docker 就跟我一样,大概率会报错,报错内容如下

Error response from daemon: Get “https://registry-1.docker.io/v2/“: context deadline exceede

原因是镜像加速器不可用,我根据网上资源配置了多个镜像加速器后终于解决。


Windows /Mac 可通过Docker Desktop进行界面配置,配置方法如下:

打开 Docker-Settings-Docker Engine,复制下方代码到,点击【Apply & Restart】,配置生效后,重新运行 上面的Cursor 终端代码即可。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享
{"registry-mirrors": [  "https://registry.docker-cn.com",  "https://s4uv0fem.mirror.aliyuncs.com",  "https://docker.1ms.run",  "https://registry.dockermirror.com",  "https://docker.m.daocloud.io",  "https://docker.kubesre.xyz",  "https://docker.mirrors.ustc.edu.cn",  "https://docker.1panel.live",  "https://docker.kejilion.pro",  "https://dockercf.jsdelivr.fyi",  "https://docker.jsdelivr.fyi",  "https://dockertest.jsdelivr.fyi",  "https://hub.littlediary.cn",  "https://proxy.1panel.live",  "https://docker.1panelproxy.com",  "https://image.cloudlayer.icu",  "https://docker.1panel.top",  "https://docker.anye.in",  "https://docker-0.unsee.tech",  "https://hub.rat.dev",  "https://hub3.nat.tf",  "https://docker.1ms.run",  "https://func.ink",  "https://a.ussh.net",  "https://docker.hlmirror.com",  "https://lispy.org",  "https://docker.yomansunter.com",  "https://docker.xuanyuan.me",  "https://docker.mybacc.com",  "https://dytt.online",  "https://docker.xiaogenban1993.com",  "https://dockerpull.cn",  "https://docker.zhai.cm",  "https://dockerhub.websoft9.com",  "https://dockerpull.pw",  "https://docker-mirror.aigc2d.com",  "https://docker.sunzishaokao.com",  "https://docker.melikeme.cn"  ]}

五、本地运行Coze

1.用浏览器打开:http://localhost:8888,进入 Coze页面。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

2.输入邮箱和密码,点击【注册】后再重新登录即可。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

3.点击【创建】,选择【创建智能体】。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

4.输入智能体名称和介绍,点击【确定】即可。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

5.配置智能体的 Prompt、工作流并进行预览调试与发布即可。

纯小白用时3 小时,终于成功本地化部署了一套 Coze,血泪踩坑经验分享

以上就是 Coze 本地化部署的所有步骤。

Agent智能体langchain新闻资讯

langgraph 1.0.4 最新发布:功能优化与修复详解

2026-5-4 12:41:34

Agent智能体Openclaw新闻资讯

Hermes Agent vs OpenClaw:完整迁移指南

2026-5-4 13:28:07

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
购物车
优惠劵
搜索