当前位置： 首页 > news >正文

【Coze】Windows 环境下使用 Docker 部署 Coze Studio 的详细指南

news 2025/8/21 6:38:23

一、前言：

Coze Studio 是一站式 AI Agent 开发工具。提供各类最新大模型和工具、多种开发模式和框架，从开发到部署，为你提供最便捷的 AI Agent 开发环境。

  • 提供 AI Agent 开发所需的全部核心技术：Prompt、RAG、Plugin、Workflow，使得开发者可以聚焦创造 AI 核心价值。
  • 开箱即用，用最低的成本开发最专业的 AI Agent：Coze Studio 为开发者提供了健全的应用模板和编排框架，你可以基于它们快速构建各种 AI Agent ，将创意变为现实。

Coze Studio，源自服务了上万家企业、数百万开发者的「扣子开发平台」，我们将它的核心引擎完全开放。

它是一个一站式的 AI Agent 可视化开发工具，让 AI Agent 的创建、调试和部署变得前所未有的简单。

通过 Coze Studio 提供的可视化设计与编排工具，开发者可以通过零代码或低代码的方式，快速打造和调试智能体、应用和工作流，实现强大的 AI 应用开发和更多定制化业务逻辑，是构建低代码 AI 产品的理想选择。

Coze Studio 致力于降低 AI Agent 开发与应用门槛，鼓励社区共建和分享交流，助你在 AI 领域进行更深层次的探索与实践。

Coze Studio 的后端采用 Golang 开发，前端使用 React + TypeScript，整体基于微服务架构并遵循领域驱动设计（DDD）原则构建。

为开发者提供一个高性能、高扩展性、易于二次开发的底层框架，助力开发者应对复杂的业务需求。

二、windows配置要求：

  • 1、操作系统 Windows 10 
  • 2、CPU 四核或以上 
  • 3、内存 8GB 
  • 4、硬盘 256G或512G
  • 5、虚拟机平台

注意：必须有虚拟化平台这项服务，否则docker无法正常运行

三、docker安装

1、官网：https://www.docker.com/

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

docker正常启动后页面：

四、下载开源项目

开源地址：https://github.com/coze-dev/coze-studio

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

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

1、git克隆源码

git clone https://github.com/coze-dev/coze-studio.git

2、直接下载源码包

五、开始部署

1、进入项目

cd coze-studio

2、打开命令行

3、拷贝大模型配置文件（关键）

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

  • Ark（火山方舟）
  • OpenAI
  • DeepSeek
  • Claude
  • Ollama
  • Qwen
  • Gemini

在 Coze Studio 开源版中，模型配置统一放在backend/conf/model 目录中，目录下存在多个 yaml 文件，每个文件对应一个可访问的模型。

为方便开发者快速配置，Coze Studio 在 backend/conf/model/template 目录下提供了一些模板文件，覆盖了常见的模型类型，例如火山方舟、OpenAI 等。开发者可以找到对应厂商的模型模板，复制到backend/conf/model 目录，根据模板注释设置各个参数。

4、复制模型配置模版命令：

# 复制模型配置模版
cp backend/conf/model/template/model_template_ark_volc_deepseek-r1.yaml backend/conf/model/ark_volc_deepseek-r1.yaml

5、配置大模型

base_url: "https://api.deepseek.com/v1"
api_key: "你的api key"
model: "deepseek-reasoner"

6、部署并启动服务

Coze Studio 的初始部署和启动需要获取镜像并构建本地镜像。这个过程可能需要一些时间，请耐心等待。在部署过程中，您将看到以下日志信息。如果看到消息 "Container coze-server Started"，则表示 Coze Studio 服务已成功启动。

cd docker
cp .env.example .env
docker compose --profile '*' up -d

服务启动后，coze-elasticsearch-setup、coze-minio-setup、coze-mysql-setup-init-sql 和 coze-mysql-setup-schema 容器处于已退出状态（退出 0），这是正常的。

7、登录

启动服务后，使用浏览器访问：http://localhost:8888/http://localhost:8888/以打开Coze Studio。 8888是后端监听端口。
  • 请输入您的电子邮件和密码。
  • 点击 注册 按钮以完成注册。 注册后，页面将自动登录，您可以开始体验Coze Studio的所有功能和服务。 此时，您已成功部署并登录Coze Studio。

图像

8、常见问题总结

部署过程中如果出现以下报错：

图像

使用代码编辑器（如 VS Code）打开 。在编辑器的右下角，你会看到 CRLF 或 LF 的标识，点击它并选择 LF。保存文件后再重新启动。

图像

工作流代码节点如何添加 Python 第三方库

在 项目中，代码节点默认内置了两个第三方依赖库。

Coze Studio 也支持开发者自行添加其他的 第三方库。详细操作步骤如下：

修改配置文件。 在./scripts/setup/[python.sh](python.sh)脚本与./backend/Dockerfile 文件中，可找到 third - party libraries 注释，在这两个文件的第三方库注释下方直接添加依赖库对应的 pip install 命令即可。 例如添加 2.0.0 版本的 torch：

# If you want to use other third - party libraries, you can install them here.
pip install torch==2.0.0
在代码节点内部添加第三方库白名单列表。在 中可找到 变量，你可以在 内部添加所需使用的 第三方库字段。例如对于 ，只需修改为如下内容：./backend/domain/workflow/internal/nodes/code/code.gopythonThirdPartyWhitelistmapPythontorch
var pythonThirdPartyWhitelist = map[string]struct{}{"httpx":          {},"numpy":          {},"torch":          {},
}

执行以下命令重启服务

docker compose --profile '*' up -d --force-recreate --no-deps coze-server

默认情况下，Coze Studio服务器只监听localhost，当部署在公共网络环境中时，建议只在必要时监听0.0.0.0或添加额外的安全措施以防止服务直接暴露在公共网络中。

http://www.lryc.cn/news/626308.html

相关文章：

  • 基于分布式环境的令牌桶与漏桶限流算法对比与实践指南
  • Day 40:训练和测试的规范写法
  • 008.Redis Cluster集群架构实践
  • RabbitMQ：SpringAMQP Topic Exchange（主题交换机）
  • Linux中Cobbler服务部署与配置（快速部署和管理 Linux 系统）
  • mac电脑软件左上角的关闭/最小化/最大化按钮菜单的宽度和高度是多少像素
  • Mac 4步 安装 Jenv 管理多版本JDK
  • Mac 上安装并使用 frpc（FRP 内网穿透客户端）指南
  • 第四章:大模型（LLM)】07.Prompt工程-(4)思维链（CoT, Chain-of-Thought）Prompt
  • 第四章:大模型（LLM)】07.Prompt工程-(5)self-consistency prompt
  • 编译安装 Nginx
  • 从AI小智固件到人类智能：计算技术的层级跃迁
  • Linux-----《Linux系统管理速通：界面切换、远程连接、目录权限与用户管理一网打尽》
  • JavaScript 检查给定的四个点是否形成正方形（Check if given four points form a square）
  • [特殊字符] 小豆包 API 聚合平台：让 AI 接入更简单、更高效
  • PyTorch API 7
  • Linux 文件系统权限管理（补充）
  • pinctrl和gpio子系统实验
  • 前后端联合实现文件上传，实现 SQL Server image 类型文件上传
  • LeetCode热题100--101. 对称二叉树--简单
  • 【Kafka】常见简单八股总结
  • 力扣 30 天 JavaScript 挑战 第36天 第8题笔记 深入了解reduce，this
  • Linux Shell 常用操作与脚本示例详解
  • CNN 在故障诊断中的应用：原理、案例与优势
  • DAY 50 预训练模型+CBAM模块
  • 排查Redis数据倾斜引发的性能瓶颈
  • VScode ROS文件相关配置
  • 什么是大数据平台？大数据平台和数据中台有什么关系？
  • 网络间的通用语言TCP/IP-网络中的通用规则3
  • A股大盘数据-20250819 分析