Ubuntu下Docker Desktop主机与容器用户ID映射及权限问题解决选项

核心原因 #

Docker Desktop for Linux通过容器化后台运行Docker daemon，默认会将主机用户UID/GID映射到容器内的100999:100999范围，导致你在Dockerfile中创建的1000:1000用户无法匹配挂载文件的所有者，引发权限异常。

可用解决选项 #

1. 动态调整容器内用户的UID/GID（快速修复推荐） #

在启动容器时，先以root身份修改ruby用户的UID/GID，使其匹配容器内挂载文件的所有者ID，再切换到该用户运行应用。修改你的docker-compose.yml：

services:
  app:
    build: .
    command: >
      sh -c "usermod -u $(id -u) ruby && groupmod -g $(id -g) ruby && exec bundle exec rails s"
    user: root
    volumes:
      - .:/app

• 原理：$(id -u)和$(id -g)在容器内执行时，会返回Docker Desktop映射后的UID/GID（即你看到的100999），修改后ruby用户即可获得挂载文件的操作权限。
• 说明：每次启动容器都会执行修改操作，不会改动镜像本身。

2. 构建镜像时指定匹配映射后的UID/GID #

修改Dockerfile，通过构建参数传入目标UID/GID，确保容器内用户ID与挂载文件所有者一致：

# 在原Dockerfile基础上添加构建参数
ARG UID=100999
ARG GID=100999

RUN groupadd -g $GID ruby && useradd -m -u $UID -g ruby ruby
# 后续保持原Dockerfile内容不变

执行构建命令：

docker-compose build --build-arg UID=$(id -u) --build-arg GID=$(id -g)

3. 切换到原生Docker Engine（彻底解决，适合无需Desktop GUI场景） #

Docker Desktop的UID映射是其虚拟化架构导致的，原生Docker Engine直接与主机共享UID空间，和你旧笔记本的运行环境一致：

1. 卸载Docker Desktop：

   sudo apt remove docker-desktop
   rm -rf ~/.docker
   

2. 安装原生Docker Engine和Docker Compose：

   sudo apt update
   sudo apt install docker.io docker-compose
   sudo usermod -aG docker $USER
   

3. 重启会话后，容器内1000:1000的ruby用户会直接匹配主机用户ID，权限问题消失。

4. 调整Docker Desktop的UID/GID映射配置 #

通过修改主机用户映射配置，让Docker Desktop将主机的1000:1000直接映射到容器内的1000:1000：

1. 编辑/etc/subuid和/etc/subgid文件：

   echo "dockremap:1000:1" | sudo tee -a /etc/subuid
   echo "dockremap:1000:1" | sudo tee -a /etc/subgid
   

2. 创建或编辑~/.docker/daemon.json：

   {
     "userns-remap": "default"
   }
   

3. 重启Docker Desktop，此时主机的1000用户会映射到容器内的1000用户，与Dockerfile中创建的ruby用户匹配。

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