跳转到内容
WebDebugXWebDebugX

调试浏览器（本机或远程）

WebDebugX 的调试目标不限于移动设备。任何以远程调试端口启动的 Chromium 内核浏览器都可以添加为一台设备，无论它运行在本机还是同一网络中的其他机器上。

1. 以调试端口启动浏览器

Section titled “1. 以调试端口启动浏览器”

必须在启动时指定参数；对于已经在运行的实例，无法事后开启调试端口。

Windows

Terminal window
chrome.exe --remote-debugging-port=9222 --user-data-dir="D:\chrome-debug"

macOS

Terminal window
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug

Linux

Terminal window
google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug

确认是否启动成功：

Terminal window
curl http://localhost:9222/json/version

2. 在 WebDebugX 中添加

Section titled “2. 在 WebDebugX 中添加”
  1. 点击设备列表底部的添加自定义设备。
  2. 填写 IP 与调试端口。
    • 本机 → localhost（或 127.0.0.1）+ 9222。
    • 其他机器 → 该机器的 IP 地址与端口。
  3. 确认后，该条目会以本机或自定义设备的形式出现在设备列表中。
  4. 选中该条目并点击刷新，即可列出其已打开的标签页。

页面将在 Chrome DevTools 中打开。

调试其他机器上的浏览器

Section titled “调试其他机器上的浏览器”

以下两个条件必须满足，且均需在目标机器一侧完成配置：

  • 调试端口需可访问。 Chromium 默认将调试端口绑定在环回地址上，远程机器无法直接连接。推荐使用 SSH 隧道，这也是最安全的方式：

    Terminal window
    ssh -L 9222:localhost:9222 user@that-machine

    随后在本地添加 localhost:9222。

  • 防火墙需放行对应端口（若确实需要直接暴露该端口）。

常见问题

Section titled “常见问题”
现象 原因
端口可连接但无法列出页面 浏览器在已有 profile 上启动 —— 请指定 --user-data-dir 后重启
连接被拒绝 浏览器启动时未指定参数，或端口填写有误
本机可连接、远程无法连接 调试端口绑定在环回地址上，请使用 SSH 隧道
提示「设备已存在」 该 IP 与端口的组合已存在于设备列表中