Web UI 自动化

适用于被测系统在内网、自动化平台无法直连内网 IP 的场景。客户机主动建立 SSH 反向隧道，将本机 Chrome 调试端口映射到 TestHub，自动化在客户内网浏览器中执行。

一、客户机：启动 CDP 浏览器

在客户机上用 Playwright 镜像启动 Chrome 并开启远程调试（仅需执行一次，建议开机自启容器）：

docker run -d --name omniflow-cdp \
  --restart unless-stopped \
  --network host \
  --shm-size=1g \
  mcr.microsoft.com/playwright:v1.60.0-jammy \
  bash -lc 'CHROME=$(find /ms-playwright -name chrome -type f 2>/dev/null | head -n1); \
    exec "$CHROME" --headless=new --no-sandbox --disable-dev-shm-usage --disable-gpu \
      --remote-debugging-port=9222 --remote-debugging-address=0.0.0.0 \
      --user-data-dir=/tmp/chrome-cdp-profile'

验证：

curl -s http://127.0.0.1:9222/json/version | head -c 80

应返回包含 Browser 的 JSON。

二、客户机：生成 SSH 密钥（仅首次）

ssh-keygen -t ed25519 -N "" -f ~/.ssh/id_ed25519_omniflow_tunnel
cat ~/.ssh/id_ed25519_omniflow_tunnel.pub

复制输出的整行公钥（以 ssh-ed25519 开头）。

三、TestHub：场景配置

1. 打开本页 场景配置。
2. 将公钥粘贴到 公钥 文本框，点击 测试连接。
3. 点击 测试连接 后不要立即关闭场景配置弹窗，在公钥下方查看并复制 SSH 命令；确认无误后再点 保存（保存会关闭弹窗）。

四、客户机：建立反向隧道（须持续运行）

在客户机上执行场景配置里保存公钥后、或测试连接下方显示的完整 SSH 命令（系统已生成，请原样复制执行；用户须为 omniflow-tunnel，勿用 root）。

检查进程：

ps aux | grep "ssh.*omniflow-tunnel" | grep -v grep

五、TestHub：测试并运行

1. 场景配置中点击 测试连接，显示成功后再保存。
2. 主页面 运行环境根地址 中填写并勾选要执行的环境（内网地址填在对应环境框）。
3. 配置步骤后点击 运行场景。

六、常见问题

• 测试连接失败：检查 CDP 容器、SSH 隧道是否在跑；是否使用页面上的最新 SSH 命令（含 0.0.0.0:端口）。
• 证书错误：内网 HTTPS 自签证书已在隧道模式自动忽略，仍失败请检查 URL 是否可从客户机访问。
• 隧道断开：SSH 进程退出后需重新执行；建议用 autossh 或 systemd 常驻。