chore: add HTTP2 Linux soak runner

CHANGELOG.md

@@ -5,6 +5,7 @@
 - 新增独立 `transport/http2` 实验 Runner：支持 h2c/TLS h2、连接上限、全局请求并发闸门、GOAWAY 排空、RST_STREAM 单流取消和生命周期统计；不改变 native HTTP/1.1 默认路径。
 - HTTP/2 实验 Runner 增加标准 1 MiB 头部上限、默认 8 MiB 请求体上限、128 路同连接多路复用、2 MiB 慢读取流控验收、协议错误和 GOAWAY 计数；已声明超限请求在进入业务 handler 前返回 413。
 - 新增可配置时长的 HTTP/2 TLS soak：默认 3 秒，Linux 验收可通过 `GO_OMNI_HTTP2_SOAK_DURATION=30m` 覆盖，混合验证 128 路 stream、慢 handler、请求体、Keep-Alive 和退出回收。
+- 新增 `scripts/verifyHTTP2.py`，固定在 Go 1.25 Linux 容器中运行 HTTP/2 TLS race 长测。
 - native TLS 明确限制 ALPN 为 `http/1.1`：缺省自动宣告该协议，误配置 `h2` 等未实现协议时在启动阶段报错。
 - native `Server.Stats()` 新增连接和请求过载拒绝计数；新增可信代理配置，访问日志只在 socket 对端属于配置网段时解析 `X-Forwarded-For`。
 - 新增 transport-neutral `metrics` 包，支持请求数、错误数、in-flight、累计耗时和状态分布，并可直接注册 `/metrics` 接口。

ROADMAP.md

@@ -51,6 +51,7 @@
 - native `Stats()` 已记录连接和请求过载拒绝数；访问日志已支持可信代理网段配置，默认拒绝伪造的 `X-Forwarded-For`。
 - native TLS 已明确只宣告 HTTP/1.1 ALPN；HTTP/2 暂由边缘代理终止或使用 `transport/nethttp`，已整理独立协议设计、流控和压测门槛，见 [native HTTP/2 进入条件](transport/native/HTTP2.md)，完成后再接入 native。
 - 已加入独立 `transport/http2` 实验 Runner，验证 h2c/TLS h2、连接上限、全局请求并发拒绝和恢复，以及 GOAWAY 排空、RST_STREAM 单流取消和服务关闭超时；它使用 `x/net/http2` 作为临时帧/流控实现，尚未达到 native 生产协议的流控和长测门槛。
+- HTTP/2 实验已补齐头部/请求体上限、128 路同连接多路复用、慢读取流控、协议错误与 GOAWAY 统计，并提供 `scripts/verifyHTTP2.py --duration 30m` 的 Linux TLS 长测入口；RST_STREAM 独立计数、代理联调和长测结果仍是进入 native 前的门槛。
 - 已用 16 个并发 worker 完成 3,200 次建连/断连 race 验收；MaxConnections 满载拒绝、槽位释放和 TLS 连接上限均已覆盖。
 - 新增 `scripts/verifyLinux.py`，固定在 Go 1.25 Linux 容器内运行 race、vet、build 和可选 TLS/非 TLS perfcheck；perfcheck 记录堆、goroutine、连接和 Linux 文件描述符。
 - Linux/arm64 已完成 30 秒、128 并发、512 空闲连接的 TLS 与非 TLS 持续回归，报告见 `performance/linuxSoak.json` 和 `performance/linuxSoakTLS.json`，均为 0 错误且连接、goroutine、FD 回收正常。

scripts/verifyHTTP2.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+"""Run the opt-in HTTP/2 TLS soak in a pinned Linux Go image."""
+
+import argparse
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--image", default="golang:1.25")
+    parser.add_argument("--duration", default="30m")
+    parser.add_argument("--gomaxprocs", type=int, default=2)
+    args = parser.parse_args()
+    if not args.duration or args.gomaxprocs < 1:
+        parser.error("--duration must be non-empty and --gomaxprocs must be positive")
+
+    docker = shutil.which("docker")
+    if docker is None:
+        raise SystemExit("docker is required for HTTP/2 Linux soak")
+    root = Path(__file__).resolve().parent.parent
+    command = [
+        docker, "run", "--rm", "--pull=missing",
+        "-v", f"{root}:/workspace", "-w", "/workspace",
+        "-e", "GOWORK=off", "-e", f"GOMAXPROCS={args.gomaxprocs}",
+        "-e", f"GO_OMNI_HTTP2_SOAK_DURATION={args.duration}",
+        args.image, "go", "test", "-race", "./transport/http2",
+        "-run", "^TestTLSSoak$", "-count=1",
+    ]
+    print(f"HTTP/2 Linux soak image: {args.image}", flush=True)
+    print(f"HTTP/2 TLS soak duration: {args.duration}", flush=True)
+    result = subprocess.run(command, cwd=root)
+    if result.returncode != 0:
+        raise SystemExit(f"HTTP/2 Linux soak failed with exit code {result.returncode}")
+    print("PASS HTTP/2 TLS soak", flush=True)
+
+
+if __name__ == "__main__":
+    main()

transport/native/HTTP2.md

@@ -2,7 +2,7 @@
 
 当前 `transport/native` 是经过 Linux 长连接和反向代理验收的 HTTP/1.1 实现。HTTP/2 暂不直接打开，原因是它把一个 TCP 连接变成多个独立请求流，连接级的 Keep-Alive、超时和并发限制不能直接复用现有 HTTP/1.1 状态机。
 
-当前已提供独立的 `transport/http2` 实验 Runner。它已经验证 TLS/h2、h2c、本地连接和请求闸门、GOAWAY 排空以及 RST_STREAM 取消；这些结果用于验证生命周期设计，不代表 native 已经启用 HTTP/2。实验 Runner 还覆盖了默认 1 MiB 头部上限、8 MiB 请求体上限、128 路同连接 stream 多路复用，以及 2 MiB 慢读取 body 在窗口耗尽后的恢复。`TestTLSSoak` 默认运行 3 秒，Linux 长测通过 `GO_OMNI_HTTP2_SOAK_DURATION=30m go test -race ./transport/http2 -run '^TestTLSSoak$'` 启动。
+当前已提供独立的 `transport/http2` 实验 Runner。它已经验证 TLS/h2、h2c、本地连接和请求闸门、GOAWAY 排空以及 RST_STREAM 取消；这些结果用于验证生命周期设计，不代表 native 已经启用 HTTP/2。实验 Runner 还覆盖了默认 1 MiB 头部上限、8 MiB 请求体上限、128 路同连接 stream 多路复用，以及 2 MiB 慢读取 body 在窗口耗尽后的恢复。`TestTLSSoak` 默认运行 3 秒，Linux 长测通过 `python3 scripts/verifyHTTP2.py --duration 30m` 启动。
 
 ## 目标边界