﻿打流测试 · Docker 版「自己构建镜像」材料（2026-10-12）
=====================================================

先说清楚：现成的镜像已经放在 1-一键安装（推荐）\ 里了，正常不用来这一层。
这一层是给三种情况准备的：

  · 想自己从 Dockerfile 构建（比如要改基底、改标签）
  · 需要别的架构（本层随包的 dist\ 只有 amd64 一份）
  · 想审计构建过程（Dockerfile 全程可读，构建期零网络依赖）


【文件夹里有什么】
docker\Dockerfile            scratch 基底（默认，最小）—— 镜像里只有三样：二进制 + 根证书 + 时区
docker\Dockerfile.alpine     alpine 基底（备选，带 shell 和健康检查）
docker\docker-compose.yml    编排文件（默认 host 网络；含 bridge 端口映射的备选写法）
docker\build-image.sh        构建脚本（先补执行位 → build → 构建完自动起容器冒烟）
docker\bench-3modes.sh       三组口径对比脚本（宿主直跑 / host 网络 / bridge 网络）
docker\ca-certificates.crt   TLS 根证书 —— 测速源走 HTTPS 下发，缺了它面板能开但按开始是空源
docker\Shanghai              时区文件（只为日志时间可读，561 字节，纯可选）
dist\pml-linux-amd64         镜像里要装的那份二进制（amd64）
说明.txt                     本文件

注意：scratch 基底里没有 shell，镜像内 /pml 的执行位完全靠源文件带过去 ——
Windows 出来的产物拷到 Linux 常丢执行位（落成 0644），容器会直接报
exec: "/pml": permission denied。build-image.sh 已代劳补一次，手动构建请先 chmod +x。


【怎么构建】
在「2-自己构建镜像」这一层执行（构建上下文就是这一层）：
    sh docker/build-image.sh                  # amd64 + scratch，镜像约 9.9 MB（磁盘占用）
    TAG=3.45.0 sh docker/build-image.sh       # 指定镜像标签（引擎版本变了记得改）
    BASE=alpine sh docker/build-image.sh      # 换 alpine 基底
    OUT=1 sh docker/build-image.sh            # 顺手导出 tar（离线分发用）


【怎么跑】
    docker run -d --name pml --network host -v pml-data:/data --restart unless-stopped pml-speedtest:3.44.9
    浏览器开 http://<本机IP>:62071/lite

或走编排：
    cd docker && docker compose up -d

只做一次命令行测速（不起服务、不占端口）：
    docker run --rm --network host pml-speedtest:3.44.9 test -mode download -secs 10 -json


【要 arm64 镜像怎么办】
两条路，随你：

  A) 在 arm64 机器上构建（最省事，推荐）
     把 Linux 版里的 arm64 二进制拷成 dist/pml-linux-arm64，在那台机器上跑同一个脚本：
         ARCH=arm64 sh docker/build-image.sh

  B) 在 x86 机器上跨架构构建
     需要 docker buildx；没有 buildx 的 docker 会报
     "image ... does not provide the specified platform (linux/arm64)"。
     没有 buildx 时，等价的替代做法是「rootfs 导入」：
         mkdir -p rfs/etc/ssl/certs rfs/usr/share/zoneinfo/Asia
         cp docker/ca-certificates.crt rfs/etc/ssl/certs/
         cp docker/Shanghai            rfs/usr/share/zoneinfo/Asia/
         cp dist/pml-linux-arm64       rfs/pml && chmod 0755 rfs/pml
         tar -C rfs -cf rfs.tar .
         docker import --platform linux/arm64 \
           -c 'ENTRYPOINT ["/pml"]' \
           -c 'ENV TZ=Asia/Shanghai PML_CLIENT=docker PML_BIND=0.0.0.0 PML_PORT=62071 PML_NO_OTA=1 PML_DATA=/data' \
           -c 'VOLUME ["/data"]' -c 'EXPOSE 62071' \
           rfs.tar pml-speedtest:3.44.9-arm64
     （1-一键安装 里那个 arm64 镜像就是这么做的，已在 qemu-aarch64 下真跑验过 /healthz）


【几个关键点】
· 网络默认用 host。打流测的是「本机到公网」的极限吞吐，容器 NAT 会额外吃 CPU、
  可能把数字压低 —— 这是量法差异，不是网络变慢。三组实拍对比见 3-实测截图\。
· 镜像比裸二进制只多约 250 KB（一个根证书 + 一个时区文件），构建期零网络依赖。
· 来源徽标在容器里显示 docker（引擎也能靠 /.dockerenv + cgroup 自己认出来，镜像里显式写死更稳）。
· 默认端口 62071，与 Linux 版、OpenWrt 版一致。