PVE 安装 OpenWrt：官方 25.12 x86 镜像导入 Proxmox VE 与 VMware 虚拟机

PVE 里装官方 OpenWrt 不用找“PVE 专用镜像”，也不用先转成 qcow2：把 OpenWrt x86-64 UEFI 镜像 解压成 .img，用 qm 命令的 import-from 直接导入成虚拟磁盘，BIOS 选 OVMF (UEFI)，EFI 盘不要预置安全启动密钥。第一块虚拟网卡一般就是 OpenWrt 的 LAN，第二块是 WAN。VMware 的做法是先用 qemu-img 把 .img 转成 .vmdk，再作为现有磁盘挂上。

先判断你是哪种情况

下载哪个文件

在 OpenWrt x86-64 UEFI 镜像页 下载 openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img.gz（约 14 MB），下载后核对页面上的 SHA-256，方法见 如何核对下载文件的 SHA-256。

• 这是 UEFI 版，虚拟机必须用 UEFI 启动（PVE 里叫 OVMF）。传统 BIOS 版 ext4-combined.img.gz 和带恢复出厂功能的 squashfs 版本站暂未收录，从文末“官方资料”进入 OpenWrt 官方下载页获取。
• OpenWrt 25.12.6 官方没有发布现成的 .vmdk 或 .qcow2，只有 .img.gz，下面的步骤都从这个文件开始。
• 解压后是约 126 MB 的整盘镜像，里面有 16 MB 引导分区和 104 MB 系统分区。

先规划网卡：哪块是 LAN，哪块是 WAN

OpenWrt x86 的默认规则：系统里的第一块网卡 eth0 是 LAN（地址 192.168.1.1，并开着 DHCP 服务），第二块 eth1 是 WAN（自动获取地址）。在虚拟机里，按顺序添加的第一块虚拟网卡一般会成为 eth0。

• PVE 安装时只会建一个网桥 vmbr0，它接在第一个物理网口上，PVE 自己的管理地址通常也在上面。要让 OpenWrt 拨号或接光猫，先在 PVE 网页的节点 → System → Network 里给第二个物理网口建一个 Linux Bridge（例如 vmbr1），点 Apply Configuration 生效。
• 网卡型号选 VirtIO。OpenWrt 25.12 的 x86 内核已内置 VirtIO 网卡驱动，也带 Intel e1000/e1000e 和 VMware vmxnet3 驱动。

注意OpenWrt 的 LAN 一启动就会在 192.168.1.0/24 上发 DHCP。如果 net0 接的网桥里已经有一台路由器在发地址，两台会互相抢，家里设备可能断网。只是先试一试的话，把 net0 接到一个没有其他 DHCP 的网桥上，或先在控制台里改掉 LAN 地址再接入。

方法一：PVE 命令行一次建好（推荐）

1. 在电脑上下载镜像并核对 SHA-256，然后传到 PVE 主机（Windows 10/11 自带 scp 命令；把 PVE地址 换成你的 PVE 管理地址）：

scp openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img.gz root@PVE地址:/root/

1. 打开 PVE 网页，点左侧的节点 → Shell（或用 SSH 登录 PVE），再核对一次并解压：

cd /root
sha256sum openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img.gz
gzip -d openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img.gz
ls -l openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img

应看到：SHA-256 和本站页面一致；解压后的 .img 大小为 126123520 字节。

1. 查存储名。下面命令列出的名字里，LVM 安装一般是 local-lvm，ZFS 安装一般是 local-zfs：

pvesm status

1. 新建虚拟机并导入磁盘。100 是虚拟机编号（换成没用过的），local-lvm 换成上一步看到的存储名；没有第二个网桥就先删掉最后一行 --net1，并把上一行末尾的 \ 去掉：

qm create 100 --name openwrt --ostype l26 --machine q35 --bios ovmf \
  --cores 1 --memory 512 \
  --efidisk0 local-lvm:1,efitype=4m,pre-enrolled-keys=0 \
  --scsihw virtio-scsi-single \
  --scsi0 local-lvm:0,import-from=/root/openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img \
  --boot order=scsi0 \
  --net0 virtio,bridge=vmbr0 \
  --net1 virtio,bridge=vmbr1

应看到：命令结束后网页左侧出现虚拟机 100 (openwrt)，Hardware 里有 EFI Disk、Hard Disk (scsi0) 和网卡。

1. 启动并打开控制台：

qm start 100

在网页里选中这台虚拟机 → Console，等启动信息滚完后按回车，进入 OpenWrt 命令行（默认不需要密码）。

1. 核对网卡对应关系：在 OpenWrt 控制台运行 ip link，把 eth0、eth1 的 MAC 地址和 PVE 里 Hardware → Network Device (net0/net1) 显示的 MAC 对一下。

应看到：eth0 的 MAC 和 net0 相同。不一样的话，在 PVE 里把两块网卡接的网桥对调即可。

1. 用接在 LAN 网桥上的电脑打开 外部资料（请使用来源按钮访问） root`，初始没有密码，进去后马上在 System → Administration 里设置密码。

提示参数含义——--bios ovmf 用 UEFI 启动；pre-enrolled-keys=0 表示 EFI 盘不预置密钥、不开启安全启动；import-from 在建盘时直接导入 .img；内存 512 MB 与 OpenWrt 官方 QEMU 示例一致，装插件多可以再加。

方法二：网页向导 + 一条导入命令

先按方法一的第 1～2 步把 .img 放到 PVE 的 /root 下，然后：

1. 点右上角 Create VM。General 页填名字，记下 VM ID。
2. OS 页选 Do not use any media。
3. System 页：Machine 可选 q35；BIOS 选 OVMF (UEFI)；勾选 Add EFI Disk 并选 EFI Storage；取消勾选 Pre-Enroll keys（网页里默认是勾上的，勾上会开启安全启动）。
4. Disks 页把默认磁盘删掉（磁盘稍后导入）。
5. CPU、Memory 按需（1 核、512 MB 起）；Network 页 Bridge 选 LAN 用的网桥，Model 选 VirtIO (paravirtualized)。
6. 完成创建后先别启动。在 Hardware 里点 Add → Network Device，再加一块接 WAN 网桥的网卡。
7. 打开节点 Shell，把镜像导入成这台虚拟机的 scsi0 并设为启动盘（100 和 local-lvm 换成你的）：

qm set 100 --scsi0 local-lvm:0,import-from=/root/openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img --boot order=scsi0

应看到：Hardware 里出现 Hard Disk (scsi0)，Options → Boot Order 第一项是 scsi0。

1. 启动后按方法一的第 5～7 步核对网卡并登录。

提示也可以用 qm disk import 100 /root/openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img local-lvm（旧写法 qm importdisk）。它导入后是 Hardware 里的 Unused Disk 0，需要再双击挂上，并到 Options → Boot Order 里勾选它，步骤比 import-from 多。

方法三：VMware Workstation（转成 vmdk）

1. 把 .img.gz 解压成 .img（Windows 可用本站的 7-Zip）。
2. 用 QEMU 自带的 qemu-img 转格式（OpenWrt 官方 Wiki 的做法）：

qemu-img convert -f raw -O vmdk openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img openwrt-25.12.6.vmdk

qemu-img 本站暂未收录：Linux 安装发行版的 qemu-utils 或 qemu-img 软件包，macOS 用 Homebrew 安装 qemu；PVE 主机上自带，可以在 PVE 上转好再拷出来。Windows 版从 QEMU 官网下载页列出的渠道获取。

1. VMware 里点 File → New → Virtual Machine，选 Custom；安装来源选 I will install the operating system later，客户机系统选 Linux，版本选其他 64 位 Linux 内核。
2. 走到磁盘那一步选 Use an existing virtual disk，点 Browse 选刚转好的 .vmdk。
3. 结束前点 Customize Hardware：第一块网卡（Network Adapter）接你访问 OpenWrt 的网络，再添加第二块网卡作 WAN。
4. 创建后先别开机：VM → Settings → Options → Advanced，把 Firmware type 改成 UEFI，不要勾 Secure Boot。
5. 开机，在窗口里看到启动信息后按回车进入命令行，再按方法一的第 6～7 步核对网卡和登录。

注意VMware 官方说明，装好系统后再改固件类型可能导致无法启动，所以在第一次开机前改成 UEFI。本文只写 VMware Workstation；ESXi 的磁盘导入方式不同，不在本文范围。

第一次登录以后

• 默认网页是英文界面，改中文、设密码、拨号等后续设置与实体机相同，见 OpenWrt x86 安装教程 的“第一次开机”部分。
• 系统分区默认只有 104 MB，虚拟磁盘再大也用不上。需要扩容请看 x86 教程里“扩大系统分区”的说明，先在 PVE 里做快照或备份。
• 以后升级：在 LuCI 的 System → Backup / Flash Firmware 里刷新版 .img.gz，步骤见 OpenWrt 升级固件。虚拟机的好处是升级前可以先拍快照，出问题直接回滚。扩过系统分区的，升级前先看 x86 教程“扩大系统分区”里的升级注意事项，整盘镜像会把分区恢复成默认大小。

常见问题

• 启动后停在 UEFI 界面，或提示 Access Denied：多半是开着安全启动（Secure Boot）。OpenWrt 官方镜像的 UEFI 引导程序没有做安全启动签名。命令行建的虚拟机把 efidisk0 设为 pre-enrolled-keys=0；已经建好的，可以按 PVE 官方说明删掉旧 EFI 盘（qm set 100 -delete efidisk0）再加一个不预置密钥的：qm set 100 -efidisk0 local-lvm:1,efitype=4m,pre-enrolled-keys=0。
• 黑屏或提示找不到可启动设备：确认 BIOS 是 OVMF (UEFI) 而不是默认的 SeaBIOS，并在 Options → Boot Order 里勾选了导入的磁盘。本站这个文件是 UEFI 版，SeaBIOS 启动不了。
• `qm` 提示找不到文件或格式不对：import-from 要用解压后的 .img 的完整路径，不能直接用 .img.gz。
• 打不开 192.168.1.1：电脑要接在 net0 所在的网桥上，并设为自动获取地址；用控制台的 ip link 确认 eth0 就是 net0。
• 确实需要 qcow2 文件（例如在其他 KVM 平台上用）：qemu-img convert -f raw -O qcow2 openwrt-25.12.6-x86-64-generic-ext4-combined-efi.img openwrt-25.12.6.qcow2。在 PVE 上没必要，qm 会把 .img 直接写进目标存储。
• VMware 提示磁盘大小异常：OpenWrt 官方 Wiki 提到，这个镜像的大小不是 1 KB 的整数倍，Veeam 等备份工具和 VMware 会对这块虚拟磁盘报错，VMware 也不能按常规方式把它扩大。只当路由器用时一般不影响启动。

资料来源

按 Proxmox VE 官方文档（qm 命令手册、Qemu/KVM 虚拟机章节的 BIOS and UEFI 与磁盘导入部分、网络配置章节）、PVE 网页界面源码中的选项名称、QEMU 官方 qemu-img 文档、Broadcom（VMware）关于用现有 VMDK 新建 Workstation 虚拟机的知识库文章与 Workstation 固件类型说明、OpenWrt 官方 Wiki（OpenWrt in QEMU、OpenWrt on VMware）及 OpenWrt 25.12.6 源码中的 x86 默认网络、内核配置与镜像构建脚本整理，并核对了本站镜像文件的大小和分区表（2026-10-22 查阅）。

提示本页按官方文档整理，本站没有在 PVE 或 VMware 上实际安装测试。网卡顺序、存储名称和界面选项以你的 PVE / VMware 版本为准。