Chrome 远程调试：跨机器连接与环境自动化

[!abstract] 核心目标

解决 Chrome 默认仅监听本地回环地址、IPv6/IPv4 协议冲突以及跨域安全限制，实现局域网内其他设备对本机的 Chrome 远程控制。

1. 技术背景与坑点总结

在配置过程中，我们遇到了以下三个核心技术陷阱：

1.1 协议争端 (IPv4 vs IPv6)

• 现象：localhost 能通，但 127.0.0.1 报 Empty reply from server。

• 原因：Windows 内部回环地址优先使用 IPv6 (::1)。即使禁用了网卡的 IPv6，系统内核的 Loopback 依然存在 IPv6。Chrome 启动时常自动绑定在 [::1]:9222，导致常规的 IPv4 转发失效。

1.2 端口转发死循环

• 风险：错误设置 netsh interface portproxy add v4tov4 ... connectaddress=127.0.0.1。

• 结果：如果 Chrome 没能成功绑定在 127.0.0.1，Windows 会尝试将 9222 的流量转给自己，形成无限递归，瞬间耗尽系统端口，产生大量 TIME_WAIT 连接。

1.3 安全拦截 (DNS Rebinding)

• 要求：必须在启动参数中加入 --remote-allow-origins=*。

• 原因：新版 Chrome 会校验 Host 请求头。如果请求来自局域网 IP 而非 localhost，Chrome 会直接切断连接。

---

2. 环境排查指令手册

当连接不通时，请按顺序执行以下命令：

目的	命令	关键观察点
查监听状态	netstat -ano | findstr 9222	看是 [::1]:9222 还是 127.0.0.1:9222
查转发规则	netsh interface portproxy show all	确认是否存在 v4tov6 的桥接规则
查进程参数	wmic process where "name='chrome.exe'" get commandline	确认是否有残留的普通 Chrome 进程
强杀残留	taskkill /f /im chrome.exe	清理掉所有未带调试参数的“幽灵进程”

---

3. 自动化配置脚本 (PowerShell)

[!important] 编码警告

必须使用 带有 BOM 的 UTF-8 (UTF-8 with BOM) 编码保存此脚本，否则中文会乱码且导致语法解析错误。

# 自动检测并请求管理员权限
if (!([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
    Write-Host "正在请求管理员权限..." -ForegroundColor Yellow
    Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs
    exit
}

# 默认值配置
$DEFAULT_CHROME = "C:\Program Files\Google\Chrome\Application\chrome.exe"
$DEFAULT_USER_DATA = "C:\chrome-debug"

Function Get-PathConfig {
    Write-Host "`n--- 路径配置 ---" -ForegroundColor Yellow
    $global:CHROME_PATH = Read-Host "1. Chrome.exe 路径 [默认: $DEFAULT_CHROME]"
    if ([string]::IsNullOrWhiteSpace($global:CHROME_PATH)) { $global:CHROME_PATH = $DEFAULT_CHROME }

    $global:USER_DATA = Read-Host "2. 用户数据文件夹 [默认: $DEFAULT_USER_DATA]"
    if ([string]::IsNullOrWhiteSpace($global:USER_DATA)) { $global:USER_DATA = $DEFAULT_USER_DATA }
}

Clear-Host
Write-Host "=================================================" -ForegroundColor Cyan
Write-Host "   Chrome 远程调试控制台 (全功能版)" -ForegroundColor Cyan
Write-Host "================================================="
Write-Host ""
Write-Host "  [1] 仅一键配置环境 (Proxy/防火墙/快捷方式)" -ForegroundColor Green
Write-Host "  [2] 启动 Chrome - 有界面模式 (GUI)" -ForegroundColor Cyan
Write-Host "  [3] 启动 Chrome - 无头模式 (Headless)" -ForegroundColor Blue
Write-Host "  [4] 彻底清理环境 (卸载所有配置)" -ForegroundColor Red
Write-Host ""

$ACTION = Read-Host "请输入你的选择 (1-4)"

if ($ACTION -match "[1-3]") {
    # 配置环境逻辑
    if ($ACTION -eq '1') { Get-PathConfig } else {
        # 启动模式下使用默认值或简单询问
        $global:CHROME_PATH = $DEFAULT_CHROME
        $global:USER_DATA = $DEFAULT_USER_DATA
    }
    
    Write-Host "`n正在同步网络代理与防火墙状态..." -ForegroundColor Yellow
    netsh interface portproxy delete v4tov4 listenport=9222 listenaddress=0.0.0.0 2>$null | Out-Null
    netsh interface portproxy add v4tov6 listenport=9222 listenaddress=0.0.0.0 connectport=9222 connectaddress=::1 | Out-Null
    netsh advfirewall firewall add rule name="Chrome Debug 9222" dir=in action=allow protocol=TCP localport=9222 2>$null | Out-Null

    # 创建/更新快捷方式
    $WshShell = New-Object -ComObject WScript.Shell
    $ShortcutPath = [System.IO.Path]::Combine([Environment]::GetFolderPath('Desktop'), "Chrome 远程调试.lnk")
    $Shortcut = $WshShell.CreateShortcut($ShortcutPath)
    $Shortcut.TargetPath = $global:CHROME_PATH
    $Shortcut.Arguments = "--remote-debugging-port=9222 --user-data-dir=`"$global:USER_DATA`" --remote-allow-origins=*"
    $Shortcut.Save()

    if ($ACTION -eq '2') {
        Write-Host "`n正在以 GUI 模式启动 Chrome..." -ForegroundColor Green
        Start-Process -FilePath $global:CHROME_PATH -ArgumentList "--remote-debugging-port=9222 --user-data-dir=`"$global:USER_DATA`" --remote-allow-origins=*"
    } elseif ($ACTION -eq '3') {
        Write-Host "`n正在以 Headless 模式启动 Chrome..." -ForegroundColor Green
        Start-Process -FilePath $global:CHROME_PATH -ArgumentList "--headless --remote-debugging-port=9222 --user-data-dir=`"$global:USER_DATA`" --remote-allow-origins=*"
    }
    
    Write-Host "`n[√] 配置已就绪。远程访问地址: http://[本机IP]:9222" -ForegroundColor Green

} elseif ($ACTION -eq '4') {
    Write-Host "`n正在清理系统配置..." -ForegroundColor Yellow
    netsh interface portproxy delete v4tov4 listenport=9222 listenaddress=0.0.0.0 2>$null | Out-Null
    netsh interface portproxy delete v4tov6 listenport=9222 listenaddress=0.0.0.0 2>$null | Out-Null
    netsh advfirewall firewall delete rule name="Chrome Debug 9222" 2>$null | Out-Null
    $ShortcutPath = [System.IO.Path]::Combine([Environment]::GetFolderPath('Desktop'), "Chrome 远程调试.lnk")
    if (Test-Path $ShortcutPath) { Remove-Item $ShortcutPath -Force }
    Write-Host "`n[√] 环境已彻底清理。" -ForegroundColor Green
}

Read-Host "`n操作完成，按回车键退出"

---

4. 日常使用流程

1. 启动：双击桌面的 Chrome 远程调试 快捷方式。

2. 连接：在另一台电脑的浏览器输入 http://[本机IP]:9222 即可看到调试界面。

3. API 验证：在终端执行以下命令确认连接性：

   Bash

   download

   curl http://[本机IP]:9222/json/version
   

5. 安全提示

• 该脚本开启了局域网访问权限。在公共 WiFi 环境下，请务必运行该脚本并选择 [2] 删除配置 以关闭调试端口，防止他人通过调试接口控制你的浏览器。