基于Alpine的Docker-in-Docker环境中pip为何不安装.whl包？

核心原因 #

docker:dind 镜像基于 Alpine Linux，而Alpine默认使用musl libc，而非主流Linux发行版采用的glibc。PyPI上的manylinux预编译.whl包是针对glibc环境构建的，pip会检测到系统libc不匹配，因此自动放弃预编译包，转而尝试从源码编译。

解决方案 #

方案1：切换到基于glibc的Docker-in-Docker镜像 #

改用Debian/Ubuntu系的dind镜像作为基础，这类镜像默认使用glibc，直接兼容manylinux预编译包：

FROM docker:24.0.6-dind-bookworm  # Debian Bookworm版本的dind镜像
RUN apt-get update && apt-get install -y --no-install-recommends \
    mtr \
    tcpdump \
    dnsutils \
    iputils-ping \
    python3 \
    python3-pip \
    git \
    && rm -rf /var/lib/apt/lists/*

方案2：在Alpine镜像中添加glibc兼容层 #

Alpine社区有第三方维护的glibc兼容包，安装后可以让pip识别当前环境兼容manylinux预编译包。操作步骤：

1. 添加对应软件源并安装glibc包
2. 设置LD_LIBRARY_PATH环境变量指向glibc库路径

示例Dockerfile片段：

FROM docker:dind

RUN apk add --no-cache \
    mtr \
    tcpdump \
    bind-tools \
    iputils \
    python3 \
    py3-pip \
    git \
    # 安装glibc兼容包（需先添加对应软件源）
    glibc \
    && rm -rf /var/cache/apk/*

# 设置环境变量，确保系统能找到glibc库
ENV LD_LIBRARY_PATH=/usr/glibc-compat/lib:$LD_LIBRARY_PATH

方案3：安装编译依赖（仅当必须从源码编译时） #

如果坚持使用原生Alpine环境，需要安装编译Python扩展所需的依赖包，确保NumPy、Pandas能顺利完成源码编译：

FROM docker:dind

RUN apk add --no-cache \
    mtr \
    tcpdump \
    bind-tools \
    iputils \
    python3 \
    py3-pip \
    git \
    # 编译依赖包
    gcc \
    gfortran \
    musl-dev \
    python3-dev \
    openblas-dev \
    lapack-dev

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