正常安装过程: 

  •  1.安装docker(一键联网安装)
  •  2.安装docker compose
  •  3.

    # 克隆官方仓库代码
    git clone https://github.com/coze-dev/coze-studio.git
    # 进入docker配置目录
    cd coze-studio/docker
    # 复制环境配置文件
    cp .env.example .env

    //

    cp ../backend/conf/model/template/model_template_ark_volc_deepseek-r1.yaml backend/conf/model/deepseek-r1.yaml

    //

    修改deepseek-r1.yaml以下三个参数(qwen.yaml一样)

    base_url: "https://api.deepseek.com/v1"

    api_key: "sk-xxxxxxxx" # 在[DeepSeek平台](https://platform.deepseek.com/)申请

    model: "deepseek-reasoner"

    //

    #在coze-studio/docker目录执行:

    docker compose --profile '*' up -d

    #首次运行需下载镜像

     #出现Container coze-server Started提示即启动成功
  • 4.访问控制台:👉 http://localhost:8888

注意注意,踩坑来了

1.github打不开

->解决方式: /etc/hosts文件,新加如下这条

151.101.72.249 github.global.ssl.fastly.net

2.docker compose --profile '*' up -d后镜像下载失败

->解决方式:/etc/docker/daemon.json 新加镜像源

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [

    "https://docker.xuanyuan.me",
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "https://mirror.ccs.tencentyun.com",
    "https://docker.m.daocloud.io",
    "https://docker.imgdb.de",
    "https://docker-0.unsee.tech",
    "https://docker.hlmirror.com",
    "https://docker.1ms.run",
    "https://func.ink",
    "https://lispy.org",
    "https://docker.xiaogenban1993.com"
  ]
}

备注:如果是内网离线部署coze的话,可以先用在线环境按照如上步骤下载所需镜像,然后再把镜像打包成tar,再导入内网,过程如下:

1 外网下载好镜像如下:

2 逐一打包:

   docker save -o coze-studio-web.tar cozedev/coze-studio-web:latest
   docker save -o coze-studio-server.tar cozedev/coze-studio-server:latest
   docker save -o bitnamilegacy-redis.tar bitnamilegacy/redis:8.0
   docker save -o minio-minio.tar minio/minio:RELEASE.2025-06-13T11-33-47Z-cpuv1
   docker save -o bitnamilegacy-etcd.tar bitnamilegacy/etcd:3.5
   docker save -o bitnamilegacy-elasticsearch.tar bitnamilegacy/elasticsearch:8.18.0
   docker save -o milvusdb-milvus.tar milvusdb/milvus:v2.5.10
   docker save -o nsqio-nsq.tar nsqio/nsq:v1.2.1
   docker save -o mysql.tar mysql:8.4.5

3.在内网机逐一地docker load -i xxx.tar即可

(如有需要以上包的,私信即可,大约6G)

3.好不容易下载好了,发现elasticsearch启动waiting之后error了 

->解决方式:设计等待时间为300s,docker目录下docker-compose.yml

4.另外 不要在docker里安装docker哟,不然它会提示你bridge联网有问题(也就是docker-compose.yml) 哈哈哈哈

5.其他:日志查看 docker compose logs -f 或 docker logs -f coze-server或/var/log/docker.log

6.若想将本机部署的coze服务让其他任意ip访问,按如下流程:

1.修改docker目录下.env,把这一行 WEB_LISTEN_ADDR地址改成0.0.0.0:8888

2.down一下服务,因为restart的时候,它(docker)没问题不会重新启动

docker compose --profile '*' down

3. docker compose --profile '*' up -d

4.用其他电脑即可访问

备注:

如果是云服务器,需要开启它自己的安全机制,需要在工作台/控制台添加具体端口,设置位置如下图:

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐