树莓派环境下Docker容器内pip无法拉取wheel包仅从源码编译问题问询

问题核心原因 #

1. 树莓派ARMv7架构的Python预编译wheel包大多没有上传到官方PyPI源，你主机上的pip默认配置了树莓派专用的piwheels源作为额外索引，所以能直接拉到预编译包；官方Python Docker镜像默认没有添加该源，因此只能下载源码编译。
2. 你之前尝试添加的--no-binary=:all:是强制禁用所有wheel安装的参数，完全和需求相悖，需要删除，特权模式对该问题没有任何帮助也无需开启。

解决方案 #

方案1：单次安装临时指定源

执行pip安装命令时额外指定piwheels源即可，示例如下：

pip3 install --extra-index-url https://www.piwheels.org/simple numpy

方案2：容器内永久配置pip源

如果需要容器内所有pip操作都默认优先拉取piwheels的wheel包，可直接写入pip配置文件：

1. 容器内执行如下命令生成配置：

mkdir -p /root/.pip
cat > /root/.pip/pip.conf << EOF
[global]
extra-index-url = https://www.piwheels.org/simple
EOF

2. 建议提前更新pip、wheel、setuptools组件，避免兼容性问题：

pip install -U pip wheel setuptools

方案3：写入Dockerfile固化配置

构建镜像时直接把配置写到Dockerfile中，避免每次运行容器都手动配置，示例片段：

FROM python:3.7
# 配置piwheels源
RUN mkdir -p /root/.pip \
    && echo "[global]" > /root/.pip/pip.conf \
    && echo "extra-index-url = https://www.piwheels.org/simple" >> /root/.pip/pip.conf \
    # 更新基础组件
    && pip install -U pip wheel setuptools
# 后续安装其他Python包
RUN pip install numpy pillow

特殊情况说明 #

如果配置完成后仍有个别包下载源码编译，属于正常情况：说明该包对应版本没有在piwheels上发布适配你当前Python版本和ARMv7架构的wheel包，可尝试调整包版本号选择有wheel的版本。

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