一、先准备机器

一个入门级实验环境就够了：

  • CPU：2C
  • 内存：4G
  • 磁盘：40G
  • 系统：Ubuntu 22.04

如果你只是做实验，使用云上的抢占式实例会更省钱，用完及时销毁即可。

二、安装 Docker 和 Docker Compose

sudo apt install docker.io docker-compose-v2
sudo systemctl start docker
sudo systemctl enable docker

如果镜像拉取慢，可以配置加速器：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerhub.timeweb.cloud"
  ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

三、克隆源码

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

四、修改监听配置

默认情况下，Web 只监听本地回环地址，需要改成对外可访问：

把 docker/.env 里的：

export WEB_LISTEN_ADDR="127.0.0.1:8888"

改成：

export WEB_LISTEN_ADDR="0.0.0.0:8888"

五、启动 Coze Studio

sudo apt install make
cd coze-studio
sudo make web

六、访问与注册

浏览器访问：

http://<your-server-ip>:8888/

image/png

第一次进入时按流程注册即可。

七、配置模型

后台管理入口示例：

http://<your-server-ip>:8888/admin/#model-management

image/png

这里可以接入 DeepSeek 等模型。需要准备：

  • DEEPSEEK_API_KEY=<your-api-key>

模型名称可以根据需求选择：

  • deepseek-reasoner
  • deepseek-chat

前者偏思考模式，后者偏普通对话模式。

八、这条路线适合谁

如果你想保留 Coze 式的交互体验，同时又希望拥有自己的部署权、数据控制权和后续扩展能力，那么开源版 Coze 很值得尝试。它比纯 SaaS 麻烦一些，但换来的是可控性。