Coze Studio 教程：0.5.1 能启动只是第一步

Coze Studio 把 Agent、应用、workflow、知识库、插件、数据库和提示词放进一个可视化平台。社区版后端用 Go，前端用 React 与 TypeScript；自托管并不是只起一个网页容器，默认 Compose 还会带起数据库、搜索、向量库、对象存储和消息组件。

1. 默认部署里有什么

前端调用 Go 服务管理 Agent、workflow 和各类资源。默认 docker-compose.yml 编排 MySQL、Redis、Elasticsearch、MinIO、Milvus、etcd、NSQ、coze-server 和 coze-web。模型、embedding、rerank、OCR 与文档解析再通过环境变量选择外部或本地服务。

官方写的 2 核、4 GB 是最低安装条件。完整 Compose 的实际资源会随文档量、向量索引、并发 workflow 和模型调用增长，不能把最低门槛当成生产规格。

2. 本机启动步骤

先装 Git LFS、Docker 与 Docker Compose，再克隆官方仓库。复制环境文件后启动：

cp ./docker/.env.example ./docker/.env
docker compose -f ./docker/docker-compose.yml up

浏览器访问 http://localhost:8888/sign 注册本地账号，再到 http://localhost:8888/admin/#model-management 添加模型。官方明确说明：没有模型配置，就不能在 Agent、workflow 和应用里选择模型。

首次启动前应更换示例中的数据库、MinIO、插件加密等默认凭证，固定 0.5.1 镜像版本，并确认数据卷位置。直接使用 latest 会让回滚和复现变得困难。

3. 先做一条最小 workflow

第一条流程只放输入、模型和输出节点，不接插件、不上传敏感文档、不启用 Python 代码节点。确认模型连通、token 成本和日志后，再添加知识库检索；然后分别检查分段、embedding、召回结果和权限。

要接业务系统时，社区版 API 和 Chat SDK 使用 Personal Access Token。先为测试环境签发最小权限 token，验证撤销和日志，再决定是否开放给其他系统。

4. 公网部署前必须处理的风险

官方 README 直接列出开放注册、workflow Python 执行环境、Coze Server 监听地址、SSRF 和部分 API 水平越权风险。v0.5.1 修复了一项水平越权问题，并不代表所有部署配置自动安全。

上线前至少要限制注册，放在反向代理和身份认证之后；将代码节点放到隔离网络与低权限容器；限制出站访问，防止 SSRF 触达云元数据或内网；检查 API 的 workspace、resource 和 conversation 授权；为 MySQL、MinIO、Milvus 与 Elasticsearch 建立备份和恢复演练。

5. 开源版与商业版的边界

仓库使用 Apache-2.0，并给出完整自托管路径。README 也把部分使用说明链接到 Coze 商业平台文档，并明确指出 tone customization 等功能只在商业版提供。看到商业文档里的按钮或功能时，应先对照社区版 feature list，不能默认镜像里一定存在。

官方仓库当前没有价格、充值、返佣、订阅额度分发或付费转售入口，因此本轮不按严重商业漏斗隔离。模型 API、对象存储或云资源可能由部署者自行付费，这是运行成本，不等于该仓库强制销售自己的额度。

6. 验证边界

7. 与 Dify 对比

Dify同样覆盖 LLM 应用、agent workflow 和 RAG pipeline，也提供 Docker 自托管。Coze Studio 的官方架构更强调 Coze 风格的 Agent/应用/资源一体化，以及 Eino runtime 和 FlowGram 画布。

实际选型应拿同一个模型、同一份文档和同一条含人工审批的流程做对照，检查插件生态、DSL/导出、API 权限、日志、升级和恢复。界面截图不能回答这些问题。

常见问题