Chrome远程调试管理器
chrome-dev-tool-setup.ps1 是一个PowerShell助手,它在启用了DevTools协议的情况下启动Google Chrome,并在请求时通过WireGuard接口公开调试器端口。它管理整个生命周期:
- 启动Chrome时,使用隔离的用户配置文件和请求的
--remote-debugging-port. - 可选择创建
netsh interface portproxy将您的WireGuard地址转发到的规则127.0.0.1. - 添加仅允许您指定的远程IP的限制性Windows防火墙规则。
- 监控Chrome浏览器,并在退出时删除所有内容(进程、代理、防火墙、临时配置文件)。
需求
- 使用PowerShell 5.1+的Windows 10/11(默认的Windows PowerShell工作)。
- 管理员权限(需要
netsh以及防火墙操作)。 - 谷歌Chrome浏览器安装在
C:\Program Files\Google\Chrome\Application\chrome.exe或C:\Program Files (x86)\Google\Chrome\Application\chrome.exe. - 如果您计划使用远程模式,请配置WireGuard接口。
用法
运行PowerShell 作为管理员,切换到存储库目录,然后执行:
powershell -NoProfile -ExecutionPolicy Bypass -File .\chrome-dev-tool-setup.ps1脚本将提示:
- 模式
- Local:仅启动Chrome时,DevTools处于监听状态 127.0.0.1: . - Remote:还配置端口代理和防火墙规则,以便远程主机可以通过您的WireGuard IP访问Chrome。
- DevTools端口 (默认值
9229). - 侦听地址 和 允许的远程IP (仅远程模式)。
如果检测到冲突(例如,Chrome已在端口上运行、现有端口代理条目或防火墙规则),脚本现在会暂停并询问是否:
- 继续并删除冲突的资源。
- 请选择其他端口并重试。
- 在不接触任何当前会话的情况下中止。
选择 N (中止)立即停止脚本,而无需关闭现有的Chrome窗口或篡改网络规则。
在启动过程中,您将看到四个步骤(启动Chrome、配置代理、添加防火墙规则、验证)。调试完成后,按 Ctrl+C;脚本将优雅地关闭所有内容。
无头操作
通过提供参数可以绕过所有提示:
powershell -NoProfile -ExecutionPolicy Bypass -File .\chrome-dev-tool-setup.ps1 `
-Mode Remote `
-Port 9229 `
-ListenAddress 172.30.10.54 ` # Your VPN/WireGuard address
-RemoteIP 172.30.10.53 # Remote dev/client IP allowed through the firewall默认值已与项目描述中列出的手动步骤匹配。
创建桌面快捷方式/按钮
您可以放置桌面快捷方式(或将其固定到任务栏),这样只需单击一下即可进行Chrome远程调试。
- 创建快捷方式
1. 右键单击桌面→ New → 捷径. 1. 当询问项目位置时,粘贴:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "K:\chrome-remote-profile\chrome-dev-tool-setup.ps1"1. 点击 下一步,给它起个名字 Chrome Remote Debugging,并完成。
- 强制捷径以高架方式运行
1. 右键单击快捷方式→ 属性. 1. 在 捷径 选项卡,单击 高级…. 1. 检查 以管理员身份运行 并确认。
- 可选抛光剂
- 点击 更改图标… 选择Chrome图标(chrome.exe)所以捷径很容易发现。 - 将快捷方式拖动到任务栏或“开始”菜单以固定它,或通过指定键盘快捷方式 快捷键. - 您可以浏览 chrome.exe 如果你想要Chrome图标。
现在,双击快捷方式(并接受UAC提示)将启动具有正确工作目录的脚本。
故障排除提示
- 未检测到Chrome进程:确保没有组策略阻止对Chrome命令行的访问。该脚本回退到WMI,但防病毒工具仍然会干扰。
- 配置文件目录不会删除:Chrome可能仍在运行;等待几秒钟,然后重新运行脚本——清理逻辑会重试删除三次。
- 端口已在使用/现有代理:系统将提示您删除冲突、选择另一个端口或中止而不进行更改。
可以随意调整默认端口、侦听地址或内部的远程IP chrome-dev-tool-setup.ps1 如果你的环境发生了变化。
