# 雷电模拟器9 USB / 串口 穿透指南（AI 可直接照做）

> 目标：在**任意一台新装的雷电模拟器（LDPlayer 9）**上，把宿主机上的 **USB 设备**和**串口(COM)** 穿透进安卓客机，并做到**开机全自动、无需手动操作**。
>
> 适用对象：读这份文档的 AI 助手 或 工程师。按「第 5 节 执行清单」从上到下做即可。

---

## 0. TL;DR（最小结论）

1. 雷电的虚拟机引擎是 **VirtualBox 6.1.50 的定制版**，装在 `C:\Program Files\ldplayer9box\`（**不是**系统里那个 `C:\Program Files\Oracle\VirtualBox\`）。
2. USB 想进客机，必须同时满足 4 件事：**① `.vbox` 用 6.1.50 的「新格式」USB 段 → ② 装 Extension Pack（提供 EHCI/xHCI）→ ③ 装匹配版本的 VBoxUSB 主机驱动 → ④ `.vbox` 设为只读（防止雷电启动时按模板重写配置）**。
3. 想让 Webcam/串口**不卡**，还要**关掉 Windows 的嵌套虚拟化**（Hyper-V / VBS / `hypervisorlaunchtype`），否则 VirtualBox 跑在 Hyper-V 之上，USB 等时时序会被严重劣化。
4. **USB Hub（集线器）不能透传**，只能透传 Hub 后面的**具体设备**（用各自的 VID:PID）。
5. 串口设备节点 `/dev/ttyS*` 开机是 root 私有，普通 App 打不开 → 用监听脚本自动 `chmod 666`。

---

## 1. 名词与路径

| 名称 | 路径 / 值 | 说明 |
|---|---|---|
| 雷电启动程序 | `D:\LDPlayer9\dnplayer.exe` | 主程序 |
| 虚拟机引擎 | `C:\Program Files\ldplayer9box\` | VirtualBox 6.1.50 定制版，含 `VBoxManage.exe` |
| 虚拟机配置 | `D:\LDPlayer9\vms\leidian0\leidian.vbox` | 每个实例一个；**必须保持只读** |
| 引擎物理进程 | `Ld9BoxHeadless` | watcher 靠它判断"虚拟机已启动" |
| adb | `D:\LDPlayer9\adb.exe` | 客机 adb 端口默认 `127.0.0.1:5555` |
| 资源包 | `D:\LDPlayer9\usb-kit\` | 扩展包 + VBoxUSB 驱动（移植用） |
| 设备清单 | `D:\LDPlayer9\usb-targets.txt` | 每行一个 `VID:PID` |
| 管理脚本 | `D:\LDPlayer9\ld-usb.ps1` | `list/add/remove/reload/status/install` |
| 自动监听脚本 | `D:\LDPlayer9\usb-watch.ps1` | 由计划任务 `LdUsbWatcher` 运行 |
| 运行日志 | `D:\LDPlayer9\usb-watch.log` | 排查用 |

---

## 2. 原理（为什么必须这么配）

### 2.1 为什么老格式的 USB 配置无效
VirtualBox 5.x 的写法：
```xml
<USBController enabled="true" ohci="true" ehci="false" xhci="false">
  <USBFilter><VendorId>0x0BDA</VendorId><ProductId>0x5844</ProductId></USBFilter>
</USBController>
```
在 6.1.50 里会被**静默忽略**（`showvminfo` 永远显示 `OHCI USB: disabled`）。6.1.50 只认**新格式**（见 4.3）。

### 2.2 为什么必须装 Extension Pack
USB 2.0(EHCI)/USB 3.0(xHCI) 控制器由 **Oracle VM VirtualBox Extension Pack** 提供。没装时启动会报
`Implementation of the USB 2.0 controller not found!`，高速设备（摄像头基本都是 High-speed）无法工作。

### 2.3 为什么必须装 VBoxUSB 主机驱动
虚拟机能"抢走"宿主设备，靠的是 `VBoxUSBMon.sys`（过滤驱动，把设备从 Windows 抢过来）和 `VBoxUSB.sys`（在抢来的设备上建 `USB\VID_80EE&PID_CAFE\...` 节点）。
- 雷电目录**默认不带**这两个驱动文件；
- 且**版本必须与引擎一致（6.1.50）**——系统里若存在 Oracle VirtualBox 7.x 的同名驱动，会版本不匹配。
- 用雷电自带的 `USBInstall.exe` 安装即可（见 4.4）。

### 2.4 为什么 `.vbox` 要设只读
雷电启动时会**按自己的模板重写** `.vbox`，会抹掉你手改的串口和 USB 配置。
**保持文件只读**后，雷电写不进去，就按磁盘上的内容启动 —— 这是配置能保留的关键机制。

### 2.5 为什么要关嵌套虚拟化（性能关键）
若 Windows 开着 **Hyper-V / VBS(虚拟化安全) / 内存完整性(HVCI)**，VirtualBox 会运行在 **Hyper-V 之上（嵌套虚拟化）**。
此时 **USB 等时(isochronous)传输的微帧时序被严重劣化** → 摄像头"只显示半张画面 / 极卡"。
**判据**：`(Get-CimInstance Win32_ComputerSystem).HypervisorPresent` 必须为 **False**。
注意：**只关"内存完整性"不够**，VBS 核心会强制拉起 hypervisor，必须同时置 `EnableVirtualizationBasedSecurity=0` 且 `bcdedit /set hypervisorlaunchtype off`。

### 2.6 为什么串口每次要 chmod
穿透的串口在客机里是 `/dev/ttyS1`（`0x2f8`=COM2）、`/dev/ttyS0`（`0x3f8`=COM1）。开机时 Android 的 `ueventd` 把它设成 **root 私有**，普通 UID 的 App 打不开 → 需 `chmod 666`。用 watcher 自动做。

---

## 3. 已知限制（先知道，别踩坑）

| 限制 | 说明 |
|---|---|
| **Hub 不能透传** | 集线器（如 `1A40:0101` = Generic USB Hub）无法透传；要透传的是 **Hub 后面的具体设备**。监听脚本会**自动跳过 Hub**（否则重启 Hub 会连带复位下游设备）。 |
| **同序列号冲突** | 两台设备若序列号相同（如两颗摄像头都是 `200901010001`），VBox 抢占节点 `USB\VID_80EE&PID_CAFE\<序列号>` 会撞 ID → **同时只能生效一台**。 |
| **UVC 摄像头带宽瓶颈** | VirtualBox 的 USB2.0 等时模拟带宽有限。高分辨率/未压缩(YUY2)码流会出现"半屏+卡顿"。**解决：App 里改用 MJPEG 或降分辨率/帧率；并只透传一台摄像头。** |
| **`.vbox` 只读** | 任何时候都不要去掉只读属性。 |
| **换电脑** | 只复制 `D:\LDPlayer9` **不够**（见第 6 节）。 |

---

## 4. 手工操作参考（细节）

### 4.1 环境检查
```powershell
# 引擎版本
& "C:\Program Files\ldplayer9box\VBoxManage.exe" --version
# 是否仍在嵌套虚拟化（必须 False）
(Get-CimInstance Win32_ComputerSystem).HypervisorPresent
```

### 4.2 安装 Extension Pack（若未装）
```powershell
& "C:\Program Files\ldplayer9box\VBoxManage.exe" extpack install --replace "D:\LDPlayer9\usb-kit\Oracle_VM_VirtualBox_Extension_Pack-6.1.50.vbox-extpack"
& "C:\Program Files\ldplayer9box\VBoxManage.exe" list extpacks
```

### 4.3 安装 VBoxUSB 主机驱动（管理员）
```powershell
# 首选：用雷电自带安装器
& "C:\Program Files\ldplayer9box\USBInstall.exe"
# 或手动安装 D:\LDPlayer9\usb-kit\drivers\filter 与 \device 下的 inf
```

### 4.4 `.vbox` 里应呈现的 USB / UART 段（6.1.50 新格式）
```xml
<USB>
  <Controllers>
    <Controller name="OHCI" type="OHCI"/>
    <Controller name="EHCI" type="EHCI"/>
  </Controllers>
  <DeviceFilters>
    <DeviceFilter name="usb_0bda_5844" active="true" vendorId="0bda" productId="5844"/>
    <DeviceFilter name="usb_XXXX_YYYY" active="true" vendorId="XXXX" productId="YYYY"/>
  </DeviceFilters>
</USB>

<UART>
  <Port slot="0" enabled="false" IOBase="0x3f8" IRQ="4" path="..." hostMode="RawFile"/>
  <Port slot="1" enabled="true"  IOBase="0x2f8" IRQ="3" path="COM3" hostMode="HostDevice"/>
</UART>
```
- `slot="1"` + `IOBase="0x2f8"` = COM2 → 客机里是 **`/dev/ttyS1`**。
- `path="COM3"` 是**宿主机的 COM 号**，换机器时务必按实际修改（FT232 等设备换机后 COM 号常常变）。
- 改完后**恢复只读**：`attrib +R "D:\LDPlayer9\vms\leidian0\leidian.vbox"`。

### 4.5 关闭嵌套虚拟化（管理员，需重启）
```powershell
# 1) 关 VBS 核心 / Credential Guard / 内存完整性
reg add "HKLM\SYSTEM\CurrentControlSet\Control\DeviceGuard" /v EnableVirtualizationBasedSecurity /t REG_DWORD /d 0 /f
reg add "HKLM\SYSTEM\CurrentControlSet\Control\DeviceGuard\Scenarios\CredentialGuard" /v Enabled /t REG_DWORD /d 0 /f
reg add "HKLM\SYSTEM\CurrentControlSet\Control\DeviceGuard\Scenarios\HypervisorEnforcedCodeIntegrity" /v Enabled /t REG_DWORD /d 0 /f
# 2) 关闭 hypervisor 启动
bcdedit /set hypervisorlaunchtype off
# 3) 重启后验证
(Get-CimInstance Win32_ComputerSystem).HypervisorPresent   # 期望 False
```
> 若仍为 True：还有 **Hyper-V / 虚拟机平台 / WSL2** 在拉起 hypervisor，需要 `dism /online /disable-feature /featurename:Microsoft-Hyper-V-All /norestart`（WSL2 也要一并处理）。
> **副作用**：WSL2 / Hyper-V 虚拟机将无法启动；恢复用 `bcdedit /set hypervisorlaunchtype auto` + 重新打开内存完整性。

### 4.6 宿主侧抖动优化（可选，提升稳定性）
- 摄像头直插机箱**后置原生 USB 口**（不要过 Hub）。
- `powercfg /setactive SCHEME_MIN`（高性能电源计划）。
- 把 `Ld9BoxHeadless` 进程优先级设为 `High`（watcher 已自动做）。

### 4.7 串口权限的"彻底"做法（可选）
以 root 在客机执行，把规则写进 `ueventd.rc`（若 LDPlayer 的 `/system` 改动不能跨重启持久，则用 watcher 自动化即可）：
```bash
adb -s emulator-5554 shell "su -c \"mount -o rw,remount /system; echo '/dev/ttyS1 0666 system system' >> /system/ueventd.rc\""
```
验证：`adb -s emulator-5554 shell ls -l /dev/ttyS1` → 应为 `crw-rw-rw-`。

---

## 5. 执行清单（AI 照这个顺序做）

> **Step 0｜查现状**
> ```powershell
> (Get-CimInstance Win32_ComputerSystem).HypervisorPresent          # 期望 False，否则先做 Step 1
> & "C:\Program Files\ldplayer9box\VBoxManage.exe" list extpacks    # 期望有 6.1.50 扩展包
> & "D:\LDPlayer9\ld-usb.ps1" status                                # 查看驱动/服务/任务是否就绪
> ```

> **Step 1｜关闭嵌套虚拟化**（见 4.5）→ **重启电脑** → 再确认 `HypervisorPresent = False`。

> **Step 2｜装齐引擎侧依赖**：Extension Pack（4.2） + VBoxUSB 驱动（4.3）。
> 新建电脑可用一条命令：
> ```powershell
> powershell -ExecutionPolicy Bypass -File "D:\LDPlayer9\ld-usb.ps1" install   # 需管理员
> ```

> **Step 3｜配置设备清单**
> ```powershell
> cd D:\LDPlayer9
> powershell -ExecutionPolicy Bypass -File .\ld-usb.ps1 add 0bda:5844 摄像头
> powershell -ExecutionPolicy Bypass -File .\ld-usb.ps1 remove 1a40:0101     # Hub 不要加
> powershell -ExecutionPolicy Bypass -File .\ld-usb.ps1 list
> ```
> VID:PID 查法：设备管理器 → 设备 → 属性 → 详细信息 → **硬件 ID**（看 `USB\VID_xxxx&PID_xxxx`）。
> **不要填 Hub**；**不要填带 `&MI_xx` 的子接口**（填它的父设备）。

> **Step 4｜写入配置并生效**
> ```powershell
> powershell -ExecutionPolicy Bypass -File .\ld-usb.ps1 reload       # 改 .vbox(filters+UART) 并自动恢复只读，重启雷电
> ```
> 如手改 `.vbox`：务必按 4.4 的新格式，改完 `attrib +R`。

> **Step 5｜启动自动化**（重启电脑后本应自动生效；如被清掉则重建）
> ```powershell
> powershell -ExecutionPolicy Bypass -File "D:\LDPlayer9\ld-usb.ps1" install   # 会重注册计划任务 LdUsbWatcher
> Get-ScheduledTask -TaskName LdUsbWatcher
> ```
> watcher 的作用：检测到 `Ld9BoxHeadless` 启动时 →
> ①重启清单里的 USB 设备让 VBox 抢占（自动跳过 Hub）→ ②把引擎进程优先级提到 High → ③等客机启动完成后自动 `chmod 666 /dev/ttyS*`。

> **Step 6｜验证**
> ```powershell
> cd D:\LDPlayer9
> powershell -ExecutionPolicy Bypass -File .\ld-usb.ps1 status
> & "C:\Program Files\ldplayer9box\VBoxManage.exe" list usbhost          # 目标应显示 Current State: Captured
> & .\adb.exe -s emulator-5554 shell lsusb                                # 客机应能看到该设备
> & .\adb.exe -s emulator-5554 shell ls -l /dev/ttyS1                     # 应为 crw-rw-rw-
> Get-Content .\usb-watch.log -Tail 20                                    # 看 watcher 是否按预期执行
> ```

---

## 6. 移植到另一台新电脑（重要）

**只复制 `D:\LDPlayer9` 不够**，因为依赖分布在目录之外：

| 依赖 | 位置 | 在 D:\LDPlayer9 里？ |
|---|---|---|
| Extension Pack | `C:\Program Files\ldplayer9box\ExtensionPacks\` | ❌（已备份进 usb-kit） |
| VBoxUSB 驱动 | `C:\Windows\System32\drivers\` + 驱动库 + `VBoxUSB` 服务 | ❌（已备份进 usb-kit） |
| ±计划任务 LdUsbWatcher | Windows 任务库 | ❌（由 install 重建） |
| 虚拟机配置 | `D:\LDPlayer9\vms\leidian0\leidian.vbox` | ✅ |

**新机步骤：**
1. 先**正常安装同版本雷电**（9.5.x，引擎为 VBox 6.1.50，安装目录 `C:\Program Files\ldplayer9box`）。
2. 把老机的 `D:\LDPlayer9`（至少 `vms\` 与 `usb-kit\` + 三个脚本）拷过去。
3. **管理员**运行一次：`powershell -ExecutionPolicy Bypass -File "D:\LDPlayer9\ld-usb.ps1" install`
4. **按实际修改串口 COM 号**（`.vbox` 里 `path="COM3"`）。
5. 执行第 5 节的 **Step 1（关嵌套虚拟化）→ 重启**。
6. 正常启动雷电，按 Step 6 验证。

> 若新机雷电版本不同（引擎不是 6.1.50），`usb-kit` 里的扩展包/驱动要换成对应版本。

---

## 7. 排错速查表

| 症状 | 原因 | 处理 |
|---|---|---|
| 客机 `lsusb` 看不到设备 | USB 段用了老格式 / 没装扩展包 / 驱动没装 / 设备未抢占 | 检查 4.4 新格式；装 extpack+驱动；看 `list usbhost` 是否 `Captured` |
| `OHCI USB: disabled` | `.vbox` 仍是老格式 | 改成 4.4 的新格式 |
| 启动报 `USB 2.0 controller not found` | 未装 Extension Pack | 装 4.2 |
| 重启雷电后串口/USB 配置消失 | `.vbox` 没设只读 | `attrib +R` |
| 设备显示 `Captured` 但客机没有 | 同序列号冲突 / 需强制重启设备 | 只保留一台；watcher 会自动 `pnputil /restart-device` |
| 摄像头"只显示半张 / 极卡" | 嵌套虚拟化未关 / 码流带宽过大 | 做 Step 1；App 改 MJPEG 或降分辨率帧率；只透传一台 |
| Hub 加了却无效 | Hub 不支持透传 | 删除该行，改加 Hub 下面的具体设备 |
| 每次开机都要手动 `chmod 666` | `/dev/ttyS*` 开机 root 私有 | watcher 已自动化；或写 `ueventd.rc`（4.7） |
| `adb device offline` | 未连接 | `D:\LDPlayer9\adb.exe connect 127.0.0.1:5555` |

---

## 8. 完整回退方案

- 恢复配置：用备份 `D:\LDPlayer9\vms\leidian0\leidian.vbox.bak` 覆盖回去（注意保持只读）。
- 卸载扩展包：`VBoxManage extpack uninstall "Oracle VM VirtualBox Extension Pack"`。
- 恢复嵌套虚拟化：`bcdedit /set hypervisorlaunchtype auto` + 重新打开"内存完整性" → 重启。
- 停用自动化：任务计划程序里停用 `LdUsbWatcher`。

---

## 9. 关键命令速抄

```powershell
# 管理设备清单
powershell -ExecutionPolicy Bypass -File D:\LDPlayer9\ld-usb.ps1 list
powershell -ExecutionPolicy Bypass -File D:\LDPlayer9\ld-usb.ps1 add  <VID:PID> [名称]
powershell -ExecutionPolicy Bypass -File D:\LDPlayer9\ld-usb.ps1 remove <VID:PID>
powershell -ExecutionPolicy Bypass -File D:\LDPlayer9\ld-usb.ps1 reload      # 应用配置并重启雷电
powershell -ExecutionPolicy Bypass -File D:\LDPlayer9\ld-usb.ps1 status      # 检查就绪状态
powershell -ExecutionPolicy Bypass -File D:\LDPlayer9\ld-usb.ps1 install     # 新电脑初始化(需管理员)

# 引擎侧
& "C:\Program Files\ldplayer9box\VBoxManage.exe" list usbhost
& "C:\Program Files\ldplayer9box\VBoxManage.exe" list extpacks

# 客机侧
& D:\LDPlayer9\adb.exe connect 127.0.0.1:5555
& D:\LDPlayer9\adb.exe -s emulator-5554 shell lsusb
& D:\LDPlayer9\adb.exe -s emulator-5554 shell ls -l /dev/ttyS1

# 自动化日志
Get-Content D:\LDPlayer9\usb-watch.log -Tail 30
```

目标：在任意一台新装的雷电模拟器（LDPlayer 9）上，把宿主机上的 USB 设备和串口(COM) 穿透进安卓客机，并做到开机全自动、无需手动操作。

雷电模拟器9 USB / 串口 穿透指南（AI 可直接照做）

把宿主机上的 USB 设备和串口(COM) 穿透进安卓客机，并做到开机全自动、无需手动操作。

开发

人工智能

雷电模拟器9USB/串口穿透完整指南：基于VirtualBox 6.1.50定制引擎，需装ExtensionPack和匹配的VBoxUSB驱动，保持.vbox只读，关闭Hyper-V嵌套虚拟化，配合自动监听脚本实现开机全自动设备透传。

代码解释

虚拟化

虚拟机

Android

Windows

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

雷电模拟器9 USB / 串口 穿透指南（AI 可直接照做）-腾讯云开发者社区-腾讯云

雷电模拟器9 USB / 串口穿透指南（AI 可直接照做）

雷电模拟器9 USB / 串口穿透指南（AI 可直接照做）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

雷电模拟器9 USB / 串口 穿透指南（AI 可直接照做）

雷电模拟器9 USB / 串口 穿透指南（AI 可直接照做）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

雷电模拟器9 USB / 串口穿透指南（AI 可直接照做）

雷电模拟器9 USB / 串口穿透指南（AI 可直接照做）