如何在Ubuntu的Dockerfile中无root权限安装Python库？

核心思路 #

通过创建非root用户、调整pip安装路径、优化镜像构建流程，彻底解决权限问题，同时提升依赖安装效率。

方案一：使用官方Python基础镜像（推荐） #

官方Python镜像已预配置好稳定的Python环境，无需手动安装，且能轻松切换到非root用户：

# 选择兼容pandas==1.5.1的Python版本（3.7-3.10均可，slim版更轻量化）
FROM python:3.9-slim

# 创建非root用户，指定固定UID/GID避免权限冲突
RUN useradd -m -u 1000 appuser

# 设置工作目录并修改权限为非root用户所有
WORKDIR /app
RUN chown -R appuser:appuser /app

# 切换到非root用户执行后续操作
USER appuser

# 将pip用户安装目录加入环境变量，确保能找到安装的依赖包
ENV PATH="/home/appuser/.local/bin:${PATH}"

# 先复制requirements.txt（利用Docker缓存，修改代码无需重复安装依赖）
COPY --chown=appuser:appuser requirements.txt .

# 使用--user参数让pip安装到用户目录，无需root权限；--no-cache-dir减少镜像体积并避免缓存权限问题
RUN pip install --user --no-cache-dir -r requirements.txt

# 复制业务脚本
COPY --chown=appuser:appuser script2.py .

# 启动脚本
CMD ["python3", "./script2.py"]

方案二：基于Ubuntu镜像调整（适配原有基础镜像需求） #

若坚持使用Ubuntu作为基础镜像，可按以下方式修改：

# 指定具体Ubuntu版本（避免latest版本的不确定性）
FROM ubuntu:20.04

# 安装Python3、pip并清理apt缓存，减小镜像体积
RUN apt update && \
    apt install -y python3 python3-pip && \
    rm -rf /var/lib/apt/lists/*

# 创建非root用户
RUN useradd -m -u 1000 appuser

# 设置工作目录并修改权限
WORKDIR /Desktop/DS
RUN chown -R appuser:appuser /Desktop/DS

# 切换到非root用户
USER appuser

# 配置pip用户安装目录的环境变量
ENV PATH="/home/appuser/.local/bin:${PATH}"

# 复制依赖清单并安装
COPY --chown=appuser:appuser requirements.txt .
RUN pip3 install --user --no-cache-dir -r requirements.txt

# 复制脚本文件
COPY --chown=appuser:appuser script2.py .

# 启动命令
CMD ["python3", "./script2.py"]

关键注意事项 #

• 避免使用latest基础镜像，指定具体版本（如ubuntu:20.04、python:3.9-slim）保证构建一致性
• 复制requirements.txt放在复制代码之前，利用Docker层缓存，大幅减少重复构建时的依赖安装时间
• --no-cache-dir参数不仅能减小镜像体积，还能避免因缓存文件权限问题导致的安装失败
• 确保requirements.txt中的包版本与所选Python版本兼容（如pandas==1.5.1支持Python3.7~3.10）

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