Proxmox VE (UEFI) 安装 OpenWrt x86_64 完整步骤文档
适用环境:Proxmox VE 8/9 + OVMF(UEFI) + OpenWrt x86_64 EFI
实测版本:OpenWrt 24.10 / Proxmox VE 9.1.x
所需文件
OpenWrt EFI 磁盘镜像(不是 ISO):
例如:
20250407-99.1-x86-64-efi.img
注意:
必须包含 “x86-64-efi”
.img 是整盘镜像,不能当 ISO 使用
上传镜像
将 .img 上传到 PVE:
路径建议:
/var/lib/vz/template/iso/
创建虚拟机
VM ID:自定(示例:104)
名称:openwrt
【操作系统】
选择:不使用任何介质
不要选择 ISO
【系统】
机器:q35
BIOS:OVMF (UEFI)
SCSI 控制器:VirtIO SCSI single
勾选:添加 EFI 磁盘
EFI 存储:local-lvm
注意:不要勾选“预置密钥 / Secure Boot”
【磁盘】
跳过磁盘(不要创建 sata0 空盘)
【CPU】
1 核(后期可改)
【内存】
512M 起步,推荐 1~2G
【网络】
模型:VirtIO
桥接:vmbr0(按实际环境)
创建完成后不要启动。
SSH 登录 PVE 宿主机
cd /var/lib/vz/template/iso
确认镜像存在:
ls 20250407-99.1-x86-64-efi.img
导入磁盘
qm importdisk 104 20250407-99.1-x86-64-efi.img local-lvm
说明:
命令无输出是正常的
磁盘会以“未使用磁盘”出现
绑定为启动盘
进入:
VM 104 → 硬件
选“未使用磁盘”
编辑
挂载为:scsi0
引导顺序
VM → 选项 → 引导顺序
只保留:
scsi0
删除:
ide2
net0
EFI 磁盘确认
必须存在:
EFI Disk(4M)
注意:
不能启用 Secure Boot
否则会出现 “Access Denied”
启动 VM 后,正常现象:
OVMF 闪过
OpenWrt 启动
进入 BusyBox Shell
看到:
OpenWrt login:
即表示启动成功。
Proxmox 中扩容磁盘
关机 VM
VM → 硬件 → 硬盘(scsi0) → 磁盘操作 → 扩展
示例:
扩容到 20G 或 50G(填写最终大小)
OpenWrt 内执行扩容脚本
启动 VM,进入 OpenWrt 控制台或 SSH
执行:
sh /etc/uci-defaults/70-rootpt-resize
执行完成后重启:
reboot
验证
df -h
应看到:
/dev/root 20G 或 50G
修改配置文件
vi /etc/config/network
找到:
config interface ‘lan’
修改:
option ipaddr ‘192.168.31.1’ (示例)
重启网络
/etc/init.d/network restart
设置 root 密码(必须)
passwd
否则 SSH 无法登录。
在 Proxmox 中:
删除 CD/DVD 驱动器(.img)
删除“未使用的磁盘”
最终硬件结构应为:
EFI Disk
scsi0(OpenWrt)
net0
至此系统达到稳定形态:
UEFI 启动
overlay 已扩容
可安装 LuCI / Docker / OpenClash
支持快照、备份、迁移
配置旁路由 / 主路由
多网口分配
Docker / Passwall / OpenClash
固定 IP / VLAN / 直通网卡
文档完