本地编译docker镜像方法

现在本项目已经使用github的自动编译docker镜像功能，如果您拉取的是项目发行的镜像，您没有自己编译镜像的需求，那就忽略本文档。

如果您修改了源码，然后想采用docker的方式部署运行，可以参照以下步骤操作：

1、环境准备

安装docker：

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

2、编译镜像

当你修改好代码后，需要编译新的镜像时，需要按照以下步骤操作：

准备好你的你的用户名和新的版本号。

这个你的用户名是你在docker hub注册的用户名，例如xiaozhi。当然，如果你不需要推送到docker hub，你可以自由定义。
这个新的版本号是你编译的镜像版本，例如1.2.3，你可以根据需要自定义或者使用日期格式（例如20260609）主要是方便和现在运行的版本号做区分，同时也方便下次回忆你是什么时候构建的，不要和现在你本机运行的版本号相同。

进入xiaozhi-esp32-server项目根目录，编译 server 和 web 两个镜像：

cd 项目根目录

# 编译server镜像
docker build -f Dockerfile-server -t 你的用户名/xiaozhi-esp32-server:新的版本号 .

# 编译web镜像
docker build -f Dockerfile-web -t 你的用户名/xiaozhi-esp32-server-web:新的版本号 .

3、修改docker-compose配置

cd main/xiaozhi-server

编辑 docker-compose_all.yml 文件，将镜像版本替换为你刚才编译的版本：

services:
  xiaozhi-esp32-server:
    image: 你的用户名/xiaozhi-esp32-server:新的版本号   # 修改为你的镜像地址
    ...

  xiaozhi-esp32-server-web:
    image: 你的用户名/xiaozhi-esp32-server-web:新的版本号   #修改为你的镜像地址
    ...

4、重启服务

# 停止旧容器
docker compose -f docker-compose_all.yml down

# 启动新容器
docker compose -f docker-compose_all.yml up -d

5、验证

查看日志确认服务启动正常：

# 查看server日志
docker logs -f -n 50 xiaozhi-esp32-server

# 查看web日志
docker logs -f -n 50 xiaozhi-esp32-server-web

2.2 KiB Raw Permalink Blame History Unescape Escape