运行中的Docker容器内pip install安装Python库报权限错误怎么办
问题根因
你通过docker exec进入容器后使用的是普通用户anychat身份,此时pip的两个默认安装路径都没有写入权限:
- 全局Python包目录是镜像构建阶段由root身份创建的,属主为root,普通用户无写权限
- 普通用户
anychat的家目录/home/anychat在创建时没有分配对应所有权,pip自动降级为用户级安装时,也无法写入/home/anychat/.local目录
最终触发[Errno 13] Permission denied的权限报错。
可落地解决方法
临时调试场景(不改动容器权限,快速完成安装)
直接以root身份进入容器执行安装,跳过权限限制:
# 以root身份进入指定容器 docker exec -it --user root 1ab2a4b34 bash # 直接执行pip安装,此时root身份可正常写入全局Python包目录 pip install requests
注意:该方式安装的第三方包仅存在当前运行的容器可写层中,容器删除后安装内容会丢失,仅适合临时调试使用。
必须使用anychat用户身份安装的场景
先通过root身份修正普通用户的家目录权限,再切回普通用户执行安装:
# 以root身份进入容器 docker exec -it --user root 1ab2a4b34 bash # 把anychat用户家目录的所有权分配给该用户,解决目录不可写问题 chown -R anychat:anychat /home/anychat # 切回anychat用户 su anychat # 此时执行pip安装,pip会自动将包装到用户可写的~/.local目录,不会触发权限报错 pip install requests
正式生产场景(从Dockerfile根源规避问题)
不要依赖运行时手动安装依赖,应当在镜像构建阶段就固化依赖,同时修正用户权限配置,避免后续运行时的权限问题,核心调整点包括:
- 创建普通用户时,同步初始化其家目录下pip运行需要的缓存、包目录,提前分配所有权
- 给工作目录
/app分配普通用户的操作权限,避免root身份占死目录权限 - 服务运行阶段切换到普通用户身份启动,不要长期以root身份运行
修正后的核心Dockerfile片段:
FROM python:3.9.1 ARG APP_USER=anychat # 创建用户时同步初始化家目录结构,避免空目录权限异常 RUN groupadd -r ${APP_USER} && useradd --no-log-init -r -g ${APP_USER} -m ${APP_USER} WORKDIR /app/ COPY requirements.txt /app/ RUN set -ex \ && BUILD_DEPS="build-essential libpcre3-dev libpq-dev vim" \ && apt-get update && apt-get install -y --no-install-recommends $BUILD_DEPS \ && pip install -r requirements.txt \ # 清理apt缓存,减少镜像体积 && rm -rf /var/lib/apt/lists/* \ # 给工作目录、用户家目录分配普通用户所有权 && chown -R ${APP_USER}:${APP_USER} /app /home/${APP_USER} COPY ./src /app/ EXPOSE 8000 # 运行前切换到普通用户,不再使用root身份跑服务 USER ${APP_USER} ENTRYPOINT ["/app/scripts/docker/entrypoint.sh"]
内容的提问来源于stack exchange,提问作者Anuj TBE
相关产品推荐
相关产品推荐

