Chrome / Edge 远程调试对接 AI 代理三步开启 CDP 调试端口很多 AI 编码代理、浏览器自动化工具都需要「接管」你本地的 Chrome/Edge 来操作网页。底层统一走Chrome DevTools ProtocolCDP。本文讲清通用三步开调试端口、验证、排错。至于具体代理工具里的私有配置项各家用各家的本文不绑定某一家。一、核心原理Chrome 和 Edge都是 Chromium 内核都内置了远程调试能力。启动浏览器时加上调试参数它就会在本地起一个 HTTP/WebSocket 服务默认 9222 端口外部程序通过这套 CDP 协议就能列出/新建标签页/json/list、/json/new通过webSocketDebuggerUrl建立 WebSocket 控制页面点击、输入、截图、跑 JS复用你已登录的浏览器会话免去重复登录。只要「浏览器侧开了调试端口 代理侧指向该端口」对接就完成了。Chrome 和 Edge 逻辑完全通用只是启动命令和调试入口略有差异。二、步骤 1开启远程调试方式 AGUI 入口最省事Chrome地址栏打开chrome://inspect/#remote-debugging勾选允许远程调试Edge地址栏打开edge://inspect/#remote-debugging。页面显示Server running at: 127.0.0.1:9222即表示端口已开。方式 B命令行启动更可控推荐用独立用户数据目录启动避免复用无调试参数的旧窗口# ChromemacOS 示例/Applications/Google\Chrome.app/Contents/MacOS/Google\Chrome\--remote-debugging-port9222\--user-data-dir/tmp/chrome-debug# EdgemacOS 示例/Applications/Microsoft\Edge.app/Contents/MacOS/Microsoft\Edge\--remote-debugging-port9222\--user-data-dir/tmp/edge-debug--user-data-dir很关键它让本次启动用全新会话不会和已经打开的普通浏览器窗口冲突。三、步骤 2验证端口可用curlhttp://127.0.0.1:9222/json/version正常返回类似{Browser:Chrome/123.0.0.0,Protocol-Version:1.3,webSocketDebuggerUrl:ws://127.0.0.1:9222/devtools/browser/xxxxxx}能拿到webSocketDebuggerUrl说明 CDP 已就绪代理侧连这个地址即可。想看当前标签页curlhttp://127.0.0.1:9222/json/list四、步骤 3在代理工具里指向端口通用做法各家工具字段名不同但语义一致启用浏览器/工具权限把调试地址填为http://127.0.0.1:9222或cdpUrl之类字段若工具支持「复用已有会话attach」模式优先选它这样你手动登录的状态能被复用保存后重启该工具再用它的状态检查命令确认cdpReady: true。若切换端口如 9223浏览器启动参数和工具的地址要同步改否则连不上。五、常见问题排查问题原因解决DevToolsActivePort报错浏览器复用了无调试参数的旧会话彻底关闭浏览器用带--user-data-dir的命令重启工具报Profile not found配置未生效或格式错复查配置格式重启工具cdpReady: false调试端口不可访问lsof -i :9222查占用确认浏览器调试开关已开关掉代理/防火墙重试curl /json/version端口被占9222 已被别的实例占用换端口如 9223同步改浏览器与工具配置六、小结对接的本质就三句话浏览器侧开调试9222 可达→ 代理侧指向该端口 → 验证 cdpReady 为 true。Chrome 和 Edge 仅启动方式不同其余完全通用。踩坑几乎都出在「复用旧会话」和「端口不通」两点上按上面表格逐条核一遍就能解决。参考资料Chrome DevTools Protocol 官方文档chromedevtools.github.io个人远程调试实践整理
Chrome / Edge 远程调试对接 AI 代理三步开启 CDP 调试端口很多 AI 编码代理、浏览器自动化工具都需要「接管」你本地的 Chrome/Edge 来操作网页。底层统一走Chrome DevTools ProtocolCDP。本文讲清通用三步开调试端口、验证、排错。至于具体代理工具里的私有配置项各家用各家的本文不绑定某一家。一、核心原理Chrome 和 Edge都是 Chromium 内核都内置了远程调试能力。启动浏览器时加上调试参数它就会在本地起一个 HTTP/WebSocket 服务默认 9222 端口外部程序通过这套 CDP 协议就能列出/新建标签页/json/list、/json/new通过webSocketDebuggerUrl建立 WebSocket 控制页面点击、输入、截图、跑 JS复用你已登录的浏览器会话免去重复登录。只要「浏览器侧开了调试端口 代理侧指向该端口」对接就完成了。Chrome 和 Edge 逻辑完全通用只是启动命令和调试入口略有差异。二、步骤 1开启远程调试方式 AGUI 入口最省事Chrome地址栏打开chrome://inspect/#remote-debugging勾选允许远程调试Edge地址栏打开edge://inspect/#remote-debugging。页面显示Server running at: 127.0.0.1:9222即表示端口已开。方式 B命令行启动更可控推荐用独立用户数据目录启动避免复用无调试参数的旧窗口# ChromemacOS 示例/Applications/Google\Chrome.app/Contents/MacOS/Google\Chrome\--remote-debugging-port9222\--user-data-dir/tmp/chrome-debug# EdgemacOS 示例/Applications/Microsoft\Edge.app/Contents/MacOS/Microsoft\Edge\--remote-debugging-port9222\--user-data-dir/tmp/edge-debug--user-data-dir很关键它让本次启动用全新会话不会和已经打开的普通浏览器窗口冲突。三、步骤 2验证端口可用curlhttp://127.0.0.1:9222/json/version正常返回类似{Browser:Chrome/123.0.0.0,Protocol-Version:1.3,webSocketDebuggerUrl:ws://127.0.0.1:9222/devtools/browser/xxxxxx}能拿到webSocketDebuggerUrl说明 CDP 已就绪代理侧连这个地址即可。想看当前标签页curlhttp://127.0.0.1:9222/json/list四、步骤 3在代理工具里指向端口通用做法各家工具字段名不同但语义一致启用浏览器/工具权限把调试地址填为http://127.0.0.1:9222或cdpUrl之类字段若工具支持「复用已有会话attach」模式优先选它这样你手动登录的状态能被复用保存后重启该工具再用它的状态检查命令确认cdpReady: true。若切换端口如 9223浏览器启动参数和工具的地址要同步改否则连不上。五、常见问题排查问题原因解决DevToolsActivePort报错浏览器复用了无调试参数的旧会话彻底关闭浏览器用带--user-data-dir的命令重启工具报Profile not found配置未生效或格式错复查配置格式重启工具cdpReady: false调试端口不可访问lsof -i :9222查占用确认浏览器调试开关已开关掉代理/防火墙重试curl /json/version端口被占9222 已被别的实例占用换端口如 9223同步改浏览器与工具配置六、小结对接的本质就三句话浏览器侧开调试9222 可达→ 代理侧指向该端口 → 验证 cdpReady 为 true。Chrome 和 Edge 仅启动方式不同其余完全通用。踩坑几乎都出在「复用旧会话」和「端口不通」两点上按上面表格逐条核一遍就能解决。参考资料Chrome DevTools Protocol 官方文档chromedevtools.github.io个人远程调试实践整理
