Docker中minio/minio:latest镜像默认用户从root改为自定义用户/组的配置及权限报错问题

我来帮你解决这个MinIO容器切换非root用户后出现的权限报错问题。

问题原因分析 #

你遇到的file access denied错误，核心原因很明确：
虽然你通过MINIO_USERNAME和MINIO_GROUPNAME环境变量在容器内创建了自定义用户ouss，但挂载的/data目录所有权仍然属于root用户。当MinIO进程切换到ouss用户启动时，没有权限在/data下创建.minio.sys这类必要的系统目录和文件，因此触发了权限拒绝错误。

从你提供的docker-entrypoint.sh脚本也能看出来：脚本只是负责创建用户/组并切换身份，但完全没有处理/data目录的权限变更，这就是问题的根源。

解决方案（推荐方案一） #

我们需要在MinIO启动前，先让root用户把/data目录的所有权修改为自定义用户对应的UID/GID，再启动MinIO服务。修改后的docker-compose.yaml如下：

---
services:
    minio:
        image: minio/minio:latest
        container_name: minio
        volumes:
            - minio:/data
        environment:
            MINIO_USERNAME: ouss
            MINIO_GROUPNAME: ouss
            MINIO_UID: 1000  # 指定自定义用户的UID
            MINIO_GID: 1000  # 指定自定义组的GID
        command: >
            sh -c "chown -R ${MINIO_UID}:${MINIO_GID} /data && exec minio server /data"
        restart: always
volumes:
  minio:

配置说明：

1. 添加MINIO_UID和MINIO_GID：给自定义用户/组指定明确的UID和GID，避免容器内用户ID冲突
2. 修改启动命令：用sh -c组合两个命令：
   • 先通过chown -R把/data目录及其所有子内容的所有权改为1000:1000（对应ouss用户/组）
   • 再用exec启动MinIO服务，确保信号能正确传递给MinIO进程

其他可选方案 #

方案二：直接使用Docker的user参数

如果你不需要依赖MinIO的MINIO_USERNAME环境变量，也可以直接通过Docker的user参数指定运行身份，同时提前处理目录权限：

---
services:
    minio:
        image: minio/minio:latest
        container_name: minio
        volumes:
            - minio:/data
        user: "1000:1000"  # 替换为你需要的UID:GID
        command: >
            sh -c "chown -R 1000:1000 /data || true && exec minio server /data"
        restart: always
volumes:
  minio:

方案三：自定义Entrypoint脚本（长期复用场景）

如果需要长期复用这个配置，可以自定义一个entrypoint脚本，把权限修改逻辑整合进去：

1. 先创建custom-entrypoint.sh文件：

#!/bin/sh
# 先修改/data目录权限，确保自定义用户能读写
if [ -n "${MINIO_UID}" ] && [ -n "${MINIO_GID}" ]; then
    chown -R ${MINIO_UID}:${MINIO_GID} /data
fi
# 调用官方原entrypoint脚本
exec /usr/bin/docker-entrypoint.sh "$@"

2. 修改docker-compose.yaml挂载并使用这个自定义entrypoint：

---
services:
    minio:
        image: minio/minio:latest
        container_name: minio
        volumes:
            - minio:/data
            - ./custom-entrypoint.sh:/usr/bin/custom-entrypoint.sh  # 挂载自定义脚本
        environment:
            MINIO_USERNAME: ouss
            MINIO_GROUPNAME: ouss
            MINIO_UID: 1000
            MINIO_GID: 1000
        entrypoint: /usr/bin/custom-entrypoint.sh
        command: server /data
        restart: always
volumes:
  minio:

验证配置是否生效 #

启动容器后，你可以通过以下命令检查/data目录的权限：

docker exec -it minio ls -ld /data

输出应该类似这样（显示所有权为ouss:ouss）：

drwxr-xr-x    3 ouss     ouss          4096 Mar 19 14:30 /data

此时MinIO就能正常写入/data目录，不会再出现权限拒绝的错误了。

备注：内容来源于stack exchange，提问作者Ouss