如何以宿主机用户身份运行Docker容器解决文件权限问题？

方案1：启动容器时动态创建匹配宿主机UID/GID的用户（无需修改镜像） #

适合无法自定义镜像的场景，通过覆盖入口命令临时创建用户：

docker run -v /宿主机目录:/容器内挂载目录 \
  -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) \
  --entrypoint /bin/sh 镜像名 \
  -c "groupadd -g \$GROUP_ID myuser && useradd -u \$USER_ID -g myuser myuser && su myuser -c '容器原启动命令'"

• 替换/宿主机目录:/容器内挂载目录为实际挂载路径
• 替换容器原启动命令为镜像默认的启动指令（可通过docker inspect 镜像名查看Entrypoint和Cmd字段）

方案2：修改Dockerfile，预创建可动态适配UID/GID的用户（适合自定义镜像） #

解决安装深度学习库时的权限问题，安装阶段用root，运行阶段切换到匹配用户：

Dockerfile示例 #

FROM pytorch/pytorch:latest

# 以root身份安装依赖，避免权限问题
RUN pip install torchvision transformers

# 预创建基础用户组和用户
RUN groupadd -r appuser && useradd -r -g appuser appuser

WORKDIR /app
COPY . .

# 添加启动脚本
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

ENTRYPOINT ["/entrypoint.sh"]
CMD ["python", "train.py"]

启动脚本entrypoint.sh #

#!/bin/sh
# 动态调整用户UID/GID为宿主机传递的值
if [ -n "$USER_ID" ] && [ -n "$GROUP_ID" ]; then
    groupmod -g "$GROUP_ID" appuser
    usermod -u "$USER_ID" appuser
    chown -R appuser:appuser /app
fi

# 切换用户执行命令
exec su appuser -c "$*"

启动容器命令 #

docker run -v /宿主机目录:/app/data \
  -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) \
  自定义镜像名

方案3：用gosu工具安全切换用户（适合已有镜像） #

如果镜像支持包管理，临时安装gosu替代su，切换用户更安全：

# Debian/Ubuntu系镜像
docker run -v /宿主机目录:/容器内挂载目录 \
  -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) \
  --entrypoint /bin/sh 镜像名 \
  -c "apt-get update && apt-get install -y gosu && groupadd -g \$GROUP_ID myuser && useradd -u \$USER_ID -g myuser myuser && gosu myuser 容器原启动命令"

# Alpine系镜像
docker run -v /宿主机目录:/容器内挂载目录 \
  -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) \
  --entrypoint /bin/sh 镜像名 \
  -c "apk add --no-cache gosu && groupadd -g \$GROUP_ID myuser && useradd -u \$USER_ID -g myuser myuser && gosu myuser 容器原启动命令"

为什么直接用docker run -u $USER_ID:$GROUP_ID会报错？ #

容器内默认不存在对应UID/GID的用户和组，部分启动脚本（如start-stop-daemon）要求必须有合法用户实体，无法直接用未映射的UID/GID运行，因此会抛出权限错误。必须先在容器内创建匹配的用户组和用户，再切换身份执行命令。

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