a76yyyy/onnxruntime repository overview

⁠onnxruntime Docker 镜像（Alpine）

onnxruntime 与 numpy 的 musllinux wheel 分发，另附装好的可运行镜像。不产出 apk 包。

• Docker Hub：https://hub.docker.com/r/a76yyyy/onnxruntime⁠
• 源码：qd-today/onnxruntime-docker⁠

⁠快速开始

FROM a76yyyy/onnxruntime:1.24.4

# syntax=docker/dockerfile:1
FROM alpine:3.24
RUN --mount=type=bind,from=a76yyyy/onnxruntime:1.24.4-wheelhouse,source=/wheels,target=/w \
    apk add --no-cache $(cat /w/system-packages.txt) uv && \
    uv export --frozen --no-hashes -o /tmp/req.txt && \
    uv pip install --system --break-system-packages --no-cache \
        --index-url https://pypi.org/simple \
        --extra-index-url file:///w/simple \
        -r /tmp/req.txt

多 wheelhouse：

ENV UV_EXTRA_INDEX_URL="file:///w/a/simple file:///w/b/simple"

RUN --mount 需要 BuildKit（首行 # syntax=docker/dockerfile:1）；Kaniko 等不支持时用 COPY --from。

⁠镜像内容

⁠支持的平台

loong64 构建需 --build-arg BASE_IMAGE=ghcr.io/loong64/alpine:3.24（该仓库有同版本 py3-onnxruntime / py3-numpy）。

⁠镜像体积

占用磁盘 取 docker images 口径：containerd 计入解压层与压缩 blob 两份。

⁠产物

onnxruntime-<ver>-cpXXX-cpXXX-musllinux_1_2_<arch>.whl
numpy-<ver>-cpXXX-cpXXX-musllinux_1_2_<arch>.whl
SHA256SUMS
system-packages.txt
simple/
  index.html
  <project>/index.html

system-packages.txt 是需要 apk add 的运行时包（wheel 已自带全部 C 库，这里只剩解释器与数据文件）， 构建期用它装 runtime 镜像，下游照单安装即可。

simple/ 由 src/pack_wheel.py --emit-index 生成，链接为相对路径（../../<wheel>#sha256=），可与 wheel 目录一起挂到任意位置。

⁠构建

# wheelhouse 内容（/wheels）
docker buildx build --platform linux/arm64 --target wheel \
    --output type=local,dest=./dist .

# 可运行镜像
docker buildx build --platform linux/arm64 --target runtime \
    -t onnxruntime:1.24.4 .

⁠依赖处理

⁠numpy

Requires-Dist: numpy>=1.21.6，而 PyPI 只有 x86_64 / aarch64 的 numpy musllinux 轮子，因此六个架构都从 Alpine 包重打包。

OCR 与数据处理不走 BLAS，未按架构拆分。

⁠auditwheel

打包前 wheel 里只放三个 .so，其余由 auditwheel repair 按 DT_NEEDED 补进 <pkg>.libs/ 并改写 RPATH。它看不到的两项：

auditwheel repair 要从系统里解析每个 DT_NEEDED，因此构建镜像必须已装被解析的库；缺少时报 Cannot repair wheel, because required library "libabsl_..." could not be located。

不必装 -dev 包，运行时库即可。不传 --plat：auditwheel 从 ELF interpreter 认出 libc=musl。

⁠体积

⁠已知限制

• 只含 icu-data-en（2.9 MB）。libre2 处理非英语 Unicode 字符类需 apk add icu-data-full（+31.6 MB）。
• sympy + mpmath 是 runtime 镜像里最大的一块，onnxruntime 的硬依赖，去掉会破坏形状推断。
• wheel 的 zip 条目带 mtime，构建不可逐字节复现；内容一致，sha256 每次不同。

⁠维护者