Coze本地部署实战：Windows环境完整配置指南与常见问题解答

最新推荐文章于 2025-11-04 10:16:17 发布

原创最新推荐文章于 2025-11-04 10:16:17 发布 · 3.4k 阅读

31 ·

CC 4.0 BY-SA版权

文章标签：

#人工智能 #ai #langchain #大模型 #程序员 #转行 #学习

给大家带来用你自己的电脑实现Coze本地化部署的教程，只需要三步就可以完成搭建！

每个步骤十分详细，保证每一个小白跟着一步步走都可以快速成功部署！

步骤拆解

1️⃣ 准备Coze所需环境

2️⃣ 获取apikey和modelid

3️⃣ DockerCompose一键部署启动

在这里插入图片描述

详细步骤拆解

第一步，准备Coze所需环境

先把网盘里面的东西下载下来，安装Docker的window桌面版

在这里插入图片描述

点击OK，等待安装

在这里插入图片描述

这样就算是安装成功了（如果安装失败可看文末错误合集解决方案）

点击close and restart重启电脑完成安装

重启完成后，会出现这个界面，点击accept

点击右上角 Login in登录一下，没有账号的注册一个再登录

在这里插入图片描述

如果有这个WSL needs updating的情况直接点击这个restart即可

会自动弹出一个命令行界面，回车开始下载Linux子系统

输入快捷键Win + R，输入cmd回车

输入以下命令检查docker和docker-compose的版本号

这样就算安装成功了

第二步，获取apikey和modelid

进入火山官网后注册登录，官网如下：

https://console.volcengine.com/auth/login

登录完成后进入火山方舟，地址如下：

https://console.volcengine.com/ark/region:ark+cn-beijing/overview

点击左侧在线推理，选择自定义推理接入点，点击创建推理接入点

输入一些基本信息，接入点名称填入：Coze本地化部署，接入点描述填入：Coze本地化部署，这两个你们随便写啥都可以，自己清楚就好

点击选择模型就可以选择想要接入的模型

这里就选择Deepseek-R1

确认后点击确认接入

随后自动跳转以下界面，图中标注出来的就是modelid

点击选择API Key并复制，会弹出以下弹窗

如果列表没有数据的话，点击创建API Key

直接点击创建就好

会自动跳转API Key的列表页面，点击小眼睛就可以复制这个apikey了

第三步，DockerCompose一键部署启动

解压网盘下载的coze-studio-main.zip，进入文件夹docker下，将.env.example复制一份，重命名为.env

进入文件夹下的backend/conf/model/template，将这个图中文件复制到上一级model文件夹下

使用记事本打开这个文件

往下翻找到api_key和model，将上一步得到的api_key和model填入这里保存后关闭文件

进入coze-studio-main文件夹下的docker文件夹，点击文件夹路径输入cmd回车

进入命令行界面，然后输入以下命令

docker-compose --profile "*" up -d

等待执行完毕后看到以下这些就说明已经部署成功了！（如果安装失败可看文末错误合集解决方案）

访问localhost:8888进入到你的coze网站啦！

错误合集

一、Docker桌面版安装失败

在Docker桌面版安装的时候报这个错误

解决步骤如下

1.删除两个目录下的文件夹（如果没有就不用删除）

C:\Program Files\DockerC:\Users\你的用户名\.docker

2.打开搜索框搜索msconfig

打开系统配置

切换到服务tab，找到power服务，取消勾选后点击确定

选择重新启动，重启后再次安装即可

二、dockercompose部署的时候报错

在最后一步启动的时候报错，应该大部分人都会遇到这个问题

解决步骤如下

1.复制以下json文本

{    "default-address-pools": [        {            "base": "10.255.0.0/16",            "size": 24        }    ],    "registry-mirrors": [        "https://mirrors-ssl.aliyuncs.com/",        "https://hub-mirror.c.163.com",        "https://docker.mirrors.ustc.edu.cn",        "https://registry.docker-cn.com",        "https://k4lo9gcp.mirror.aliyuncs.com",        "https://docker.registry.cyou",        "https://docker-cf.registry.cyou",        "https://dockercf.jsdelivr.fyi",        "https://docker.jsdelivr.fyi",        "https://dockertest.jsdelivr.fyi",        "https://mirror.aliyuncs.com",        "https://dockerproxy.com",        "https://mirror.baidubce.com",        "https://docker.m.daocloud.io",        "https://docker.nju.edu.cn",        "https://docker.mirrors.sjtug.sjtu.edu.cn",        "https://docker.mirrors.ustc.edu.cn",        "https://mirror.iscas.ac.cn",        "https://docker.rainbond.cc",        "https://do.nark.eu.org",        "https://dc.j8.work",        "https://dockerproxy.com",        "https://gst6rzl9.mirror.aliyuncs.com",        "https://registry.docker-cn.com",        "http://hub-mirror.c.163.com",        "http://mirrors.ustc.edu.cn/",        "https://mirrors.tuna.tsinghua.edu.cn/",        "http://mirrors.sohu.com/"    ],    "max-concurrent-downloads": 20,    "debug": true,    "log-level": "debug",    "builder": {        "gc": {            "defaultKeepStorage": "20GB",            "enabled": true        }    },    "experimental": false}

2.打开桌面版docker，按照图中指示，原封不动将json复制到DockerEngine后，点击右下角的apply使配置生效