# 打流测试 · 原生引擎服务端（Docker 版 / scratch 基底，极致轻量）
#
# ── 构建（在有 docker 的机器上跑，构建上下文 = pml-linux/ 这一层）──
#   cd pml-linux
#   docker build -f docker/Dockerfile --build-arg ARCH=amd64 -t pml-speedtest:3.44.9 .
#   docker build -f docker/Dockerfile --build-arg ARCH=arm64 -t pml-speedtest:3.44.9-arm64 .
#
# ── 为什么基底用 scratch ──
#   引擎是 CGO_ENABLED=0 的纯静态单文件（宿主实测 ldd = "not a dynamic executable"），
#   不需要 libc / shell / 包管理器，镜像里只留「二进制 + TLS 根证书 + 时区」三样东西，
#   amd64 体积 ≈ 9.9 MB —— 比 alpine 基底再省约 8 MB。构建期零网络依赖
#   （scratch 是空镜像，不拉任何东西），适合外网受限的机器。
#
# ── 为什么必须带 CA 证书 ──
#   测速源由后台统一下发，走 HTTPS（默认 https://speedtest.xyz201704.com/report/api/builtin，
#   可用 PML_REPORT_URL 改）。没有根证书 ⇒ 源池拉不到，面板能开、一按「开始」却是空源。
#   随仓带一份 Debian 12 的标准 ca-certificates（Mozilla 集合）。
#
# ── 为什么带时区 ──
#   引擎日志的时间戳走本地时区。不带 zoneinfo 的话容器里是 UTC，看日志要心算 8 小时。
#   只放 Asia/Shanghai 一个文件（561 B）。不想带就在下面删掉那两行 TZ。
#
# ── 网络模式 ──
#   默认建议 --network host：打流测的是「本机到公网」的极限吞吐，容器 NAT 会额外吃
#   CPU、可能压低数字。要端口映射也行，但数字口径与宿主直跑不一致 ——
#   三种模式的实测对比见 ../README.md 第九节。
#
# ── 跑起来（host 网络，与宿主直跑同口径）──
#   docker run -d --name pml --network host \
#     -e PML_PORT=62071 -v pml-data:/data \
#     --restart unless-stopped pml-speedtest:3.44.9
#
# ── 命令行测速（不起服务、不占端口）──
#   docker run --rm --network host pml-speedtest:3.44.9 test -mode download -secs 10 -json

FROM scratch

# 支持的架构与 dist/ 里的文件名后缀一致：amd64 / arm64 / arm / 386 / mips / mipsle
ARG ARCH=amd64

# 1) 后台源池下发走 HTTPS，必须有根证书
COPY docker/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt

# 2) 时区（只为日志可读，纯可选）
COPY docker/Shanghai /usr/share/zoneinfo/Asia/Shanghai

# 3) 引擎本体（纯静态二进制，单文件）
# 关于执行位（踩过的坑）：
#   scratch 基底里没有 shell，用不了 RUN chmod —— 镜像里 /pml 的权限只能靠「源文件本身」带过来。
#   Windows 交叉编译出来的产物没有执行位这个概念，经 scp / 共享目录拷到 Linux 时通常落成 0644，
#   于是容器启动直接失败：exec: "/pml": permission denied。
#   ⇒ 构建前必须确保 dist/pml-linux-<arch> 是可执行的（docker/build-image.sh 里已代劳，
#     它会先 chmod +x 再 build，构建完还会自动起一把容器冒烟）。
#   ⇒ 手动构建的话，先跑一句 chmod +x dist/pml-linux-amd64。
#   （docker 开了 BuildKit 的话，把这行换成 COPY --chmod=755 dist/pml-linux-${ARCH} /pml 也等价。）
COPY dist/pml-linux-${ARCH} /pml

# 4) 容器形态：面板与 /healthz 上的来源徽标会显示 docker。
#    引擎自己也能靠 /.dockerenv + cgroup 指纹认出来，这里显式写死更稳、不依赖运行时实现。
ENV TZ=Asia/Shanghai \
    PML_CLIENT=docker \
    PML_BIND=0.0.0.0 \
    PML_PORT=62071 \
    PML_NO_OTA=1 \
    PML_DATA=/data

# 5) 数据目录（日志 / 端口文件 / 源池缓存落这里），挂卷即可持久化
VOLUME ["/data"]

EXPOSE 62071

# 无参数 = 起服务；带参数 = 命令行测速（test -mode download -secs 10 -json）
ENTRYPOINT ["/pml"]