如何用Docker Compose启动容器时避免卷内文件权限变更

问题原因 #

1. 权限日志泛滥：marctv/minecraft-papermc-server镜像启动时会递归检查/data目录下所有文件的权限，确保归属为容器内的dockeruser:dockergroup。Dynmap生成的数千张地图tile文件都会被扫描，因此输出大量权限保留的日志。
2. 用户设置报错：直接在Compose中指定user: UID:GID时，容器以非root用户启动，而镜像的初始化脚本需要root权限执行addgroup/adduser操作，导致启动失败。

解决方案 #

方案1：跳过权限检查（最快解决日志问题） #

在Docker Compose的环境变量中添加SKIP_PERM_CHECK=true，让镜像跳过权限扫描步骤：

version: "3.9"
services:
  minecraft:
    image: "marctv/minecraft-papermc-server:latest"
    container_name: "minecraftserver"
    environment:
      MEMORYSIZE: "6G"
      PAPERMC_FLAGS: ""
      SKIP_PERM_CHECK: "true"  # 添加此行跳过权限检查
    volumes:
      - "/home/mcserver:/data:rw"
    ports:
      - "25565:25565"
      - "25566:25566"
    stdin_open: true
    tty: true

重启容器后，将不再输出大量权限日志。

方案2：预先设置宿主机目录权限 #

先获取容器内dockeruser的UID和GID：

docker exec minecraftserver id dockeruser

输出类似uid=9001(dockeruser) gid=9001(dockergroup) groups=9001(dockergroup)，记下对应的UID和GID（如9001:9001）。

然后在宿主机上修改目录权限：

sudo chown -R 9001:9001 /home/mcserver

后续启动容器时，镜像检查到权限已正确匹配，就不会输出权限日志。

方案3：正确指定自定义用户UID/GID（如需自定义权限） #

不要直接用user字段，而是使用镜像提供的PUID和PGID环境变量，初始化脚本会自动以root权限创建对应UID/GID的用户，再切换到该用户运行服务：

version: "3.9"
services:
  minecraft:
    image: "marctv/minecraft-papermc-server:latest"
    container_name: "minecraftserver"
    environment:
      MEMORYSIZE: "6G"
      PAPERMC_FLAGS: ""
      PUID: "1000"  # 替换为你的宿主机用户UID
      PGID: "1000"  # 替换为你的宿主机用户GID
    volumes:
      - "/home/mcserver:/data:rw"
    ports:
      - "25565:25565"
      - "25566:25566"
    stdin_open: true
    tty: true

这样既可以自定义权限，又不会触发初始化报错。

内容的提问来源于stack exchange，提问作者bwsmith1000