网络管理
DroidVM 提供虚拟桥接网络,支持 NAT、DHCP、STP、VLAN 以及 IPv4/IPv6。在主界面切换到 网络 标签进行管理。
虚拟机通过在 虚拟机网络标签 中选择一个已配置的网络来接入。

📷 截图位置:网络列表
创建 / 编辑网络
点击新建或编辑进入网络配置。
运行中不可编辑
正在运行的网络无法编辑(界面会显示横幅并禁用保存)。请先停止使用该网络的虚拟机。
公共配置
| 字段 | 含义 | 可选 |
|---|---|---|
| 名称 | 网络名,唯一 | 必填 |
| 网桥名 | Linux 接口名,≤12 字符,字母开头 | 自动建议 br+8位 |
| 启动时自动启用 | 开机自动拉起网络 | 开关 |
| STP | 生成树协议 | 开关 |
| 网桥类型 | Linux 网桥(默认) / gVisor 网桥 | |
| 外网连接模式 | 二层桥接(L2)/ 三层路由(L3,默认) |
网桥类型怎么选
- Linux 网桥:性能好,支持次要网络等更多功能,但 IPv6 SNAT 等部分能力受限
- gVisor 网桥:用户态网络栈,支持 IPv6 SNAT、IPv6 端口转发,仅支持 L3 模式
L2 · 二层桥接模式
虚拟机直接接入上游二层网络,与宿主处于同一网段。
| 字段 | 含义 |
|---|---|
| 上游接口 | Wi-Fi / 以太网 / 网络共享(tethering) / 具体物理设备 |
| 伪桥接 | Wi-Fi 等无法直接桥接的上游会强制开启并锁定;可桥接的上游可选 |
L3 · 三层路由模式(推荐)
宿主作为路由器,虚拟机通过 NAT 出网。这是最常用、兼容性最好的模式。
| 字段 | 含义 |
|---|---|
| 网桥 MAC | 可随机生成 |
VLAN 卡
L3 模式下通过 VLAN 卡定义子网,每张 VLAN 卡可配置:
| 字段 | 含义 |
|---|---|
| VLAN ID | 0 = Untagged(未标记)域 |
| 主 IPv4 网络 CIDR | 如 10.181.7.1/24(创建时自动挑选不冲突的 192.168.N.1/24) |
| IPv4 SNAT | IPv4 出网 NAT(端口转发依赖此项) |
| DHCPv4 | 启用后设置地址池起止偏移(默认 128 / 192) |
| IPv6 来源 | 静态 CIDR / DHCP-PD(gVisor 不支持 PD) |
| 主 IPv6 网络 CIDR | 如 fd00:7::1/64(静态时) |
| PD 上游接口 / DUID | DHCP-PD 模式下(DUID 留空自动生成) |
| IPv6 SNAT | 仅 gVisor 网桥可用 |
| DHCPv6 | 启用后设置地址池起止偏移 |
| SLAAC | ::/64 无状态地址自动配置 |
| 次要 IPv4/IPv6 网络 | 逗号分隔(仅 Linux 网桥) |
| DNS 服务器 | 逗号分隔(留空跟随系统 DNS) |

📷 截图位置:L3 网络 / VLAN 卡配置
端口转发
端口转发在 虚拟机的网卡配置 中按虚拟机设置(DHCPv4 / DHCPv6 静态分配下)。
格式:每行 [协议] 主机端口:客户机端口
22:22 # tcp+udp,主机 22 → 客户机 22
tcp 8080:80 # 仅 tcp
8000-9000:8000-9000 # 端口范围生效条件
- 端口转发需所属网络启用 SNAT
- IPv6 端口转发还需使用 gVisor 网桥
保存校验与网络信息
保存时会校验:名称 / 网桥名唯一、CIDR 合法、子网不重叠(含跨网络)。保存后若守护进程已知该网络,会同步推送更新。
在 网络信息 页可查看网络运行状态与网络工具日志,用于排查连通性问题。

📷 截图位置:网络信息 / 状态
