Docker部署Django+MySQL时创建文件如何避免权限问题

问题核心 #

Linux系统下文件权限基于UID/GID匹配，容器内默认root用户的UID是0，和宿主机普通用户的UID（Ubuntu默认普通用户UID为1000）不一致，导致容器内创建的文件在宿主机需要root权限才能修改。

调整步骤 #

1. 修改Dockerfile，创建与宿主机UID/GID匹配的普通用户 #

新增创建普通用户、切换用户的逻辑，使用动态参数避免硬编码UID：

FROM python:3.9.5
ENV PYTHONUNBUFFERED 1

# 新增：接收UID/GID构建参数，创建匹配宿主机权限的普通用户
ARG UID=1000
ARG GID=1000
RUN groupadd -g $GID appuser && \
    useradd -m -u $UID -g $GID appuser

WORKDIR /app
COPY requirements.txt /app/requirements.txt
RUN pip install -r requirements.txt
COPY . /app

# 新增：给工作目录授予普通用户权限
RUN chown -R appuser:appuser /app

# 切换到普通用户执行后续操作
USER appuser

CMD python manage.py runserver 0.0.0.0:8000

2. 调整docker-compose.yml，传递用户权限参数 #

修改backend服务的构建和运行配置：

version: "3.9"
services:
  backend:
    build:
      context: .
      dockerfile: Dockerfile
      # 新增：传递当前用户的UID/GID到构建过程
      args:
        UID: ${UID:-1000}
        GID: ${GID:-1000}
    ports:
      - 8000:8000
    volumes:
      - .:/app
    depends_on:
      - mysqldb
    # 新增：指定运行时用户，避免操作切回root
    user: appuser

  mysqldb:
    image: mysql:5.7.34
    restart: always
    environment:
      MYSQL_DATABASE: mydb
      MYSQL_USER: django
      MYSQL_PASSWORD: djangopass
      MYSQL_ROOT_PASSWORD: mysecretpassword
    volumes:
      - .dbdata:/var/lib/mysql
    ports:
      - 3306:3306

3. 重建镜像和容器生效 #

执行以下命令完成配置更新：

# 停止删除旧容器
docker-compose down
# 传入当前用户UID/GID重新构建镜像
UID=$(id -u) GID=$(id -g) docker-compose build
# 启动服务
docker-compose up

其他注意事项 #

如果之前已经存在root创建的遗留文件，执行一次sudo chown -R $(id -u):$(id -g) .即可把现有文件权限修正为当前用户所有。调整完成后，容器内执行python manage.py startapp等操作创建的文件，宿主机PyCharm可直接编辑，不需要额外调整权限。

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