iOS WebKit Debugging --- 安装、配置与端口调用全流程

教程

发布日期: 2026-02-12

文章字数: {{articleLength}}

阅读时长: {{parseInt(articleLength / 800)}} 分

阅读次数: {{read_count}}

圣心语

本博客所有文章除特別声明外，均采用 CC BY 4.0许可协议。转载请注明来源圣心语的小站!

苹果 Safari 浏览器调试 ios_webkit_debug_proxy remotedebug-ios-webkit-adapter Chrome-DevTools

# iOS WebKit Debugging --- 安装、配置与端口调用全流程（适用于 Windows / macOS，通过 ios_webkit_debug_proxy + remotedebug-ios-webkit-adapter 调试 iOS Safari） ## 目录 1. 背景与原理 2. 环境要求 3. 安装 ios_webkit_debug_proxy 4. 安装 remotedebug-ios-webkit-adapter 5. 启动服务与端口说明 6. 在 Chrome DevTools 中调试 iOS Safari 7. 你的实际运行日志示例 8. 常见问题排查 9. 附录：systemd 自启动配置（Linux 用户） ## 背景与原理 Safari 调试通常只能在 macOS + Safari 开发者模式下进行。通过两个组件，我们可以在 Windows 或 Linux 上调试 iOS Safari： ----------------------------------------------------------------------- 组件作用 ----------------------------------- ----------------------------------- ios_webkit_debug_proxy 连接 iOS 设备，将 WebKit 调试接口暴露为 JSON/WS（默认端口:9222）。 remotedebug-ios-webkit-adapter 将 WebKit 协议转成 Chrome DevTools 可识别协议（默认端口:9000）。 ----------------------------------------------------------------------- 系统架构（文本版）： iOS Safari ↓ WebKit Protocol ios_webkit_debug_proxy (9222) ↓ Chrome DevTools Protocol Adapter remotedebug-ios-webkit-adapter (9000) ↓ Chrome DevTools（可在 Windows 上使用） ## 环境要求 - Windows：需要 iTunes（提供 iOS USB 驱动） - macOS：建议安装 Xcode - Node.js 环境 - USB 数据线 - iOS 设备信任电脑 - iOS Safari 打开 Web Inspector（设置 → Safari → 高级 → Web 检查器） ## 安装 ios_webkit_debug_proxy ### Windows（Scoop） scoop install ios-webkit-debug-proxy ### Windows（Chocolatey） choco install ios-webkit-debug-proxy ### macOS（Homebrew） brew install ios-webkit-debug-proxy ## 安装 remotedebug-ios-webkit-adapter npm install -g remotedebug-ios-webkit-adapter ## 启动服务与端口说明 ### Step 1 --- 启动 ios_webkit_debug_proxy ios_webkit_debug_proxy --config null:9222 -d 访问： http://localhost:9222/ ### Step 2 --- 启动 remotedebug-ios-webkit-adapter remotedebug_ios_webkit_adapter --port=9000 --ios-debug-proxy=localhost:9222 访问： http://localhost:9000 返回： {"msg":"Hello from RemoteDebug iOS WebKit Adapter"} ## 在 Chrome DevTools 中调试 iOS Safari 打开： chrome://inspect/#devices 添加： localhost:9000 即可看到 iOS Safari 远程页面并调试。 ## 你的运行日志示例 ### localhost:9000 输出 {"msg":"Hello from RemoteDebug iOS WebKit Adapter"} ### localhost:9222 输出示例 [ {"devtoolsFrontendUrl": "...page/1", "title": "DeFi_百度百科", "url": "...", "webSocketDebuggerUrl": "ws://localhost:9222/devtools/page/1"}, {"devtoolsFrontendUrl": "...page/2", "title": "FortuneSheep", "url": "保密", "webSocketDebuggerUrl": "ws://localhost:9222/devtools/page/2"} ] ### 代理运行状态 Listing devices on :9221 remotedebug-ios-webkit-adapter is listening on port 9000 Connected :9222 ## 常见问题排查 **DevTools 空白？** - 升级 ios_webkit_debug_proxy - 升级 remotedebug-ios-webkit-adapter ## 附录：systemd 自启动示例（Linux） ### ios-wdp.service [Unit] Description=iOS WebKit Debug Proxy After=network.target [Service] ExecStart=/usr/bin/ios_webkit_debug_proxy --config null:9222 -d Restart=always [Install] WantedBy=multi-user.target ### remotedebug.service [Unit] Description=RemoteDebug iOS WebKit Adapter After=network.target ios-wdp.service [Service] ExecStart=/usr/local/bin/remotedebug_ios_webkit_adapter --port=9000 --ios-debug-proxy=localhost:9222 Restart=always [Install] WantedBy=multi-user.target

iOS WebKit Debugging --- 安装、配置与端口调用全流程

你的赏识是我前进的动力