adb 端口转发通道

【踩坑实录】adb 端口转发通道

▍现象
虚拟机工程要在客户机系统里做调试：想把开发机的调试工具连进虚拟机里的系统。最初以为要给虚拟机配完整网络，折腾桥接与权限，处处碰壁（沙箱内的网络能力有边界）。

▍定位过程
回到需求本身：不需要完整网络，只需要一条通道——开发机的调试客户端能连到虚拟机内的调试端口。这类点对点需求正是端口转发（hostfwd）的标准场景：虚拟机的用户态网络配一条转发规则，把宿主侧端口映射到客户机端口。工程最终形态（记录原文）：virtio 网卡加用户态网络，转发规则把调试端口（五五五四与五五五五这对经典端口）从宿主侧引进客户机。

▍根因
最初方向错的根源是把调试需求当成了组网需求。用户态网络（不需要 root 权限与系统网络配置）加端口转发，恰好覆盖调试、下载、本地服务访问这类开发场景——方案选型时需求定义错了，工程就绕远路。

▍对策
转发规则的固化：参数进工程基线（虚拟机启动参数里固定携带转发规则，不用每次手敲）；通道验证脚本（起虚拟机、从宿主侧连转发端口、连通性断言——通道坏了立刻知道）；多通道并存（调试通道之外，网络诊断与服务访问各留转发位）。

▍延伸坑位
端口转发的两个邻居坑：一是转发与宿主端口冲突（开发机上同端口服务已占用——转发静默失败，规则里选高位端口段）；二是客户机侧服务未监听（转发通了但目标端口没服务——先在虚拟机内自测服务，再测转发链）。

▍方法论沉淀
网络类需求先分类：点对点访问（转发解决）、完整组网（用户态网络）、对外暴露（另议）——分类对了，方案就是查表题。

虚拟机工程的网络拓扑记录在适配全记录，apps 板块 56 篇欢迎对照。