Docker运行Minecraft服务器时-v挂载导致容器内文件被抹除如何解决

问题原因 #

当你使用宿主机目录绑定挂载到容器内的/home路径时，Docker的绑定挂载逻辑会直接用宿主机的目录内容覆盖容器内对应路径的原有内容，因此镜像内提前复制的服务端jar、配置文件都会被隐藏，出现文件缺失的问题。

解决方案 #

以下两种方案都不需要提前将文件放到宿主机目录： #

方案1：使用Docker命名卷（推荐，操作最简单）

命名卷的逻辑与绑定挂载不同：首次挂载空命名卷到容器内有内容的路径时，Docker会自动将容器内该路径的原有文件复制到卷中，不会覆盖原有内容，后续所有数据修改都会持久化保存在卷内，容器删除重建也不会丢失数据。
操作步骤：

1. 原有Dockerfile、镜像构建命令无需修改
2. 启动容器时将绑定挂载替换为命名卷即可，命令如下：

docker run -dp 25565:25565 -v minecraft_data:/home minecraftdev

如果后续需要导出卷内的备份数据，可以使用docker cp命令将卷内容复制到宿主机，也可以直接访问Docker的默认卷存储路径获取文件。 #

方案2：保留宿主机绑定挂载，新增初始化逻辑

如果你需要直接在宿主机目录修改配置、查看文件，可以修改Dockerfile增加初始化逻辑，首次启动时自动将镜像内的原始文件复制到空的宿主机挂载目录：
修改后的Dockerfile示例：

FROM anapsix/alpine-java 
# 将服务端文件先复制到镜像的备用目录，避免被挂载覆盖
COPY ./ /opt/minecraft
# 构建启动脚本：判断挂载目录是否为空，为空则先复制原始文件再启动服务
RUN echo '#!/bin/sh' > /start.sh \
    && echo 'if [ ! -f /home/server.properties ]; then cp -rn /opt/minecraft/* /home/; fi' >> /start.sh \
    && echo 'exec java -jar /home/main.jar' >> /start.sh \
    && chmod +x /start.sh
CMD ["/start.sh"]
EXPOSE 25565

重新构建镜像后，使用你原来的启动命令即可：

docker run -dp 25565:25565 -v C:/Users/user/server:/home minecraftdev

首次启动时会自动将镜像内的原始服务端文件复制到宿主机的挂载目录，后续启动不会覆盖已修改的配置，所有数据都会持久化保存在宿主机目录中。

内容的提问来源于stack exchange，提问作者networkguy2.0