为何docker-compose创建的文件/目录属主为999:999？求解决办法

这问题我之前帮不少人解决过，属于Docker卷挂载时的典型权限映射问题，我给你一步步讲清楚原因和可行的解决方案：

为什么会出现999:999的权限？ #

这是因为官方MySQL 5.7镜像里运行mysqld进程的用户是mysql，这个用户在容器内的UID（用户ID）是999，GID（组ID）也是999。

Docker挂载宿主机目录到容器时，会直接把容器内文件的UID/GID映射到宿主机系统上——哪怕宿主机没有对应的用户或组，所以你看到的就是无归属的999:999权限。而且每次启动容器，MySQL进程会自动调整挂载目录的权限，所以你手动修改后又会被改回去。

解决方案 #

方案1：在宿主机创建匹配UID/GID的用户组（最推荐，长期稳定） #

直接在宿主机上创建对应UID/GID的用户和组，让权限映射完全匹配，后续不会再出现权限冲突：

• 创建GID为999的mysql组：

  sudo groupadd -g 999 mysql
  

• 创建UID为999的mysql用户并加入该组：

  sudo useradd -r -u 999 -g mysql mysql
  

• 修正现有目录的权限（如果已经启动过容器生成了文件）：

  sudo chown -R mysql:mysql ./var/lib/mysql
  

之后再执行docker-compose up，挂载目录的权限就会保持一致，不会再被容器重置了。

方案2：在docker-compose.yml中指定运行容器的用户（临时快速调整） #

你可以让容器直接以宿主机的某个用户身份运行，这样挂载的文件权限就会对应这个用户：
比如用当前登录用户的UID和GID（可以用id -u和id -g获取），修改你的docker-compose.yml：

version: '3.5'
services:
  mysql-server:
    image: mysql:5.7
    user: "${UID}:${GID}"  # 读取宿主机环境变量的UID和GID
    environment:
      - MYSQL_ROOT_PASSWORD=root_pwd
    volumes:
      - ./var/lib/mysql:/var/lib/mysql:rw

启动前先导出环境变量（或者直接在命令行中传递）：

export UID=$(id -u)
export GID=$(id -g)
docker-compose up -d

⚠️ 注意：这种方法可能导致容器内的mysql用户没有权限访问容器内的默认系统文件，出现启动失败的情况，适合临时测试场景。

方案3：自定义MySQL镜像修改用户UID/GID（长期定制化） #

如果需要长期使用特定的UID/GID，可以自定义镜像修改容器内mysql用户的ID：

1. 在项目根目录创建Dockerfile：

FROM mysql:5.7
# 把mysql用户的UID和GID改成你需要的数值，比如1000（替换成你的目标ID）
RUN usermod -u 1000 mysql && groupmod -g 1000 mysql

2. 修改docker-compose.yml使用这个自定义镜像：

version: '3.5'
services:
  mysql-server:
    build: .  # 指向Dockerfile所在的目录
    environment:
      - MYSQL_ROOT_PASSWORD=root_pwd
    volumes:
      - ./var/lib/mysql:/var/lib/mysql:rw

构建并启动后，容器内的mysql用户UID/GID就会变成你指定的数值，宿主机挂载目录的权限也会对应匹配。

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