手把手基于PVE9.1安装 ImmortalWrt 24.10.6（国内版Openwrt）

原创 于 2026-05-08 00:35:12 发布 · 2.1k 阅读 · 11 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#嵌入式硬件 #智能家居
该文章已生成可运行项目，

PVE安装ImmortalWrt博客封面生成.png

一、前言

目前多数PVE部署软路由的教程，对新版PVE9.1以及UEFI格式镜像适配性较差，新手操作时容易遇到引导失败、黑屏、网络异常等各类问题。

本文基于个人真机实测，整理出一套适配 PVE9.1 + ImmortalWrt 24.10.6 ext4-EFI 官方镜像 的部署流程。步骤精简实用，适配家用单网口旁路由、多网口主路由场景，零基础可直接照搬操作落地。

二、简单聊聊 ImmortalWrt

ImmortalWrt（天灵固件）是国内主流的开源OpenWrt衍生固件，相比原版OpenWrt和各类第三方编译固件，更适配国内家用网络环境，核心优势如下：

  • 本土化完善：默认中文界面，内置国内软件源，无需额外汉化和网络配置，到手即用；

  • 纯净稳定无捆绑：官方原版干净无预装臃肿插件，无后台后门，支持按需安装插件，长期挂机稳定性高；

  • 虚拟化兼容性好：针对x86架构深度优化，完美适配PVE虚拟化、UEFI启动、2.5G网口，网络转发性能优异；

  • 长期维护迭代：社区活跃，版本持续更新，bug少，日常使用问题少、解决方案成熟。

三、环境与镜像说明

  • 运行环境：Proxmox VE 9.1 稳定版

  • 使用镜像：immortalwrt-24.10.6-x86-64-generic-ext4-combined-efi.img.gz

  • 部署场景：家用单网口旁路由 / 多网口主路由

重要提醒：本文适配的 EFI+ext4 新版镜像，不支持SeaBIOS启动模式，必须使用OVMF UEFI引导，启动模式选错会直接出现开机黑屏、引导失败。

四、镜像下载与预处理

4.1 官方下载地址

https://downloads.immortalwrt.org/releases/24.10.6/targets/x86/64/

本次部署固件：immortalwrt-24.10.6-x86-64-generic-ext4-combined-efi.img.gz

Snipaste_2026-05-07_23-12-05.png

4.2 解压要求

PVE仅支持导入 .img 格式文件，禁止直接上传gz压缩包，否则镜像导入必然失败，下载后必须解压：

  • Windows：使用7-Zip解压，获取后缀为 .img 的镜像文件；

  • Linux/Mac：终端执行解压命令 gzip \-d 镜像文件名\.img\.gz。

4.3 上传至PVE

1、登录PVE后台，进入对应节点 →【local存储】→【ISO镜像】；

2、点击上传，选择解压完成的 .img 镜像文件，等待上传完毕；

3、镜像默认存储路径：/var/lib/vz/template/iso/，后续导入命令直接调用该路径即可。

五、新建ImmortalWrt虚拟机（关键配置）

点击PVE右上角「创建虚拟机」，仅修改下文标注参数，未提及选项全部保持默认。

5.1 常规设置

自定义虚拟机名称（建议英文无空格），默认VMID，暂时不勾选创建后不启动。

Snipaste_2026-05-07_22-41-07.png

5.2 操作系统

选择：不使用任何介质（镜像自带完整系统，无需ISO引导）

Snipaste_2026-05-07_22-41-20.png

5.3 系统设置（核心关键）

- BIOS：改为 OVMF (UEFI)（适配EFI镜像，必改参数）

- 机型：改为q35（兼容性更强，网络转发性能更优）

- 显卡：默认

- SCSI控制器：默认VirtIO SCSI single

Snipaste_2026-05-07_22-42-19.png

5.4 磁盘设置

删除系统默认自动创建的scsi0空白磁盘！

ImmortalWrt镜像自带完整系统分区，默认空白磁盘会引发分区冲突、系统启动异常，此页面必须无任何磁盘。

Snipaste_2026-05-07_22-42-41.png

5.5 CPU设置

- 核心：家用2核足够，多插件、多设备组网建议4核

- CPU类型：host（直通主机CPU特性，最大化网络转发性能）

5.6 内存设置

- 内存大小：1G起步，主路由模式、多插件运行建议2G

- 取消勾选内存Ballooning（软路由不兼容该功能，开启会导致内存异常、系统卡顿）

Snipaste_2026-05-07_22-43-54.png

5.7 网络设置

- 网桥：vmbr0（PVE默认网桥）

- 网卡模型：VirtIO（半虚拟化网卡，性能最优）

- 取消勾选PVE防火墙（与软路由自带防火墙冲突，会直接断网）

Snipaste_2026-05-07_22-44-29.png

5.8 最终确认

勾选「创建后不启动虚拟机」，核对全部配置无误后，点击完成。

Snipaste_2026-05-07_22-44-39.png

六、导入镜像到虚拟机磁盘

6.1 打开PVE终端

选中当前PVE节点，点击右上角「Shell」打开命令行终端。

6.2 确认镜像文件

执行命令查看已上传镜像，确认文件名无误：

ls /var/lib/vz/template/iso/

6.3 执行导入命令

通用格式：qm importdisk 虚拟机ID 镜像路径 存储名称

实操示例（VMID=100，默认存储local-lvm）：

qm importdisk 100 /var/lib/vz/template/iso/immortalwrt-24.10.6-x86-64-generic-ext4-combined-efi.img local-lvm

Snipaste_2026-05-07_23-21-10.png

终端输出 Successfully imported disk 即代表镜像导入成功。

七、挂载磁盘与EFI引导配置

7.1 挂载系统磁盘

1、进入虚拟机硬件页面，找到「未使用的磁盘0」并双击编辑；

2、总线选择 VirtIO Block，勾选「SSD仿真」「丢弃」，优化磁盘性能；

3、点击添加，完成系统磁盘挂载。

Snipaste_2026-05-07_23-22-00.png

7.2 添加EFI磁盘（必做）

EFI格式镜像必须搭配独立EFI磁盘，缺少则无法正常引导启动：

1、硬件页面点击「添加」→「EFI磁盘」；

2、存储、大小保持默认，直接添加即可。

7.3 调整启动顺序

1、进入虚拟机「选项」→「引导顺序」；

2、将刚挂载的VirtIO系统磁盘拖动到启动首位；

3、禁用CD-ROM、网络引导等多余启动项，仅保留系统磁盘引导。

Snipaste_2026-05-07_23-22-59.png

7.4 精简硬件

删除声卡、多余USB设备、CD驱动器，减少资源占用，提升虚拟机运行稳定性。

八、初始化设置（解决网段冲突）

ImmortalWrt默认管理IP为 192\.168\.1\.1，与多数家庭主路由网段冲突，开机后必须修改IP，否则无法访问后台。

8.1 进入控制台

启动虚拟机，打开控制台，回车激活命令行。

Snipaste_2026-05-07_23-25-20.png

8.2 修改网络配置

编辑网络配置文件：

vi /etc/config/network

按 i 进入编辑模式，修改LAN口参数，适配个人局域网段。

本次实测配置：主路由IP 192.168.3.1，ImmortalWrt管理IP 192.168.3.7，配置如下：

config interface 'lan'
        option device 'br-lan'
        option proto 'static'
        option ipaddr '192.168.3.7'
        option netmask '255.255.255.0'
        option ip6assign '60'
        option gateway '192.168.3.1'
        option dns '223.5.5.5'

Snipaste_2026-05-07_23-32-03.png

旁路由用户必做：找到 config dhcp \&\#39;lan\&\#39; 段落，新增参数关闭DHCP，避免与主路由冲突：

option ignore '1'

编辑完成按 Esc，输入 :wq 保存并退出，重启网络服务生效：

/etc/init.d/network restart

Snipaste_2026-05-07_23-32-35.png

九、后台登录与上网配置

9.1 登录后台

浏览器输入自定义管理IP：http://192\.168\.3\.7

默认账号：root | 默认密码：password

官方镜像自带中文界面，无需额外汉化配置。

Snipaste_2026-05-07_23-33-31.png

9.2 旁路由配置（单网口首选）

适配绝大多数单网口PVE主机，无需改动原有家庭网络拓扑：

1、进入【网络】→【接口】，确认LAN口网关、DNS正确指向主路由；

2、进入【网络】→【防火墙】→【自定义规则】，添加NAT转发规则，解决旁路由无法上网问题：

iptables -t nat -I POSTROUTING -o br-lan -j MASQUERADE

3、保存后重启防火墙，规则立即生效；

4、全屋网络生效：登录主路由后台，在DHCP设置中，将网关和DNS服务器改为 192\.168\.3\.7 即可。

9.3 主路由配置（多网口专用）

1、关闭虚拟机，新增一块VirtIO网卡作为WAN口，桥接光猫对应物理网口；

2、开机后新建WAN接口，根据宽带类型选择PPPoE拨号或自动DHCP获取IP；

3、将WAN口防火墙区域设置为wan，开启IP伪装和MSS钳制；

4、删除LAN口配置中的 option ignore \&\#39;1\&\#39;，开启DHCP服务，即可实现全屋组网。

十、自启与简单优化

10.1 开机自启

进入虚拟机【选项】→【开机自启动】，勾选启用，启动顺序设为1，实现PVE开机自动运行软路由。

10.2 性能优化

1、CPU调度设置为performance高性能模式，提升运行效率；

2、网卡保持VirtIO模式，关闭PVE自带防火墙，避免网络干扰；

3、磁盘开启SSD仿真和丢弃功能，降低读写延迟，提升长期运行稳定性。

十一、常见问题汇总

1、开机黑屏、无法引导

原因：未使用OVMF UEFI模式、缺少EFI磁盘、BIOS启动模式选错。解决：更换UEFI引导模式，添加EFI磁盘，重新调整系统磁盘为第一启动项。

2、镜像导入失败

原因：上传未解压的压缩包、文件路径/名称错误、存储名称不匹配。解决：解压为纯img文件，核对镜像路径与PVE存储名称后重新导入。

3、能进后台但无法上网（旁路由）

原因：未添加NAT转发规则、LAN口DHCP未关闭、网关/DNS配置错误。解决：添加防火墙转发规则，关闭LAN口DHCP，核对主路由网关参数。

4、修改IP后无法访问后台

原因：网段不匹配、IP地址冲突。解决：进入控制台重新修改同网段未占用IP，重启网络服务即可。

十二、总结

这套部署方案专门适配 PVE9.1 + ImmortalWrt24.10.6 EFI/ext4 官方镜像，规避了新版系统与老旧教程的兼容问题。ext4文件系统读写更稳定，UEFI启动兼容性更强，整体方案简洁高效、故障率低，适合家用长期挂机运行，可满足网络分流、去广告、插件拓展等各类软路由使用需求。

本文章已经生成可运行项目
【软路由】ImmortalWrt 编译指南：从入门到精通
qq_20623849的博客
03-01 1万+
编译 ImmortalWrt 固件是一个充满乐趣和挑战的过程。通过本文的介绍，相信你已经掌握了编译 ImmortalWrt 的基本方法。在实践中，你可能会遇到各种各样的问题，但只要你保持耐心，仔细阅读文档和搜索资料，最终一定能够成功编译出属于自己的定制固件。在编译之前，最好先阅读 ImmortalWrt 的官方文档和相关教程,也可以参考Lede的编译教程在编译过程中，可以参考其他用户的经验和分享。如果你遇到无法解决的问题，可以在 ImmortalWrt 的论坛或社区寻求帮助。
OpenWrt固件推荐以及编译项目
驰兔的博客
03-02 2万+
OpenWrt固件，肯定自己编译的好，推荐几个常关注的。
基于efi启动的squashfs格式的 immortalwrt/或openwrt 软路由系统overlay空间扩容
qq_36961488的博客
05-26 5373
*
在PVE中安装OpenWRT（二）
weixin_46256482的博客
03-17 2545
其中100是OpenWRT的VM ID，镜像目录按照自己的镜像名称修改。在浏览器地址栏输入OpenWRT地址。修复https证书并更新软件源。用户名root，密码root。用户名root，密码root。更新索引并升级安装软件包。修改引导顺序和开机自启。进入PVE的shell。测试一下可以正常联网。
openwrt固件选择推荐二：ImmortalWrt
五道口
12-23 2万+
ImmortalWrt 是一款功能强大、适合深度用户的路由器固件。它丰富的插件和高度的可定制性让人眼前一亮，但也需要用户投入更多时间学习和调试。如果您是技术爱好者，追求路由器的极限性能，ImmortalWrt 无疑是一个值得尝试的选择；
pve系统下从0到1搭建好用的OpenWRT系统
JosenChina的博客
02-18 2万+
OpenWRT是一款及其好用的软路由系统，很多it大拿可以通过该系统玩出各种好玩的花样，由于OpenWRT详细的部署过程以及一些初始化配置过程相对较少，因此本博客会将OpenWRT再pve虚拟平台下的安装部署过程，已经后续的磁盘扩容，主题更换，中文配置等详细的配置过程记录下来，以便小白们通过这一篇博客即可以搭建一套入门级别的好用的OpenWRT。这就证明，我们的ipv6是可达可访问的，下一步就是要设置静态ipv6地址，避免由于运营商修改ipv6地址导致我们后续无法访问该ip，点击新网卡的。
ProxmoxVE（PVE）安装OpenWRT系统（旁路由模式）
sunky7的博客
04-26 2万+
用一台家用电脑组了PVE，用于智能家居、NAS等应用，还有富裕的性能，准备折腾一下软路由，配置旁路由模式。PVE的安装，可见我的其他文章。
探索 ImmortalWRT：一款强大而易用的开源路由器固件
最新发布
gitblog_00015的博客
01-12 7441
是一个基于 OpenWRT 的高度定制化路由器固件项目，旨在提供更加稳定、安全且功能丰富的网络环境。它的目标是让每个用户都能轻松地个性化和优化自己的网络设备，无论你是技术新手还是经验丰富的开发者。 ## 技术分析 - **OpenWRT 基础**：ImmortalWRT 建立在 OpenWRT 之上，这是一个著名的 Linux 发行版，专为嵌入式设备（如家用路由器）设计。OpenWRT 提供了
PVE（Proxmox Virtual Environment）OpenWRT安装使用教程
龙国星海的博客
06-17 2万+
Proxmox VE（Proxmox Virtual Environment，通常简称为 PVE、Proxmox、Proxmox VE）是一个开源的服务器虚拟化环境 Linux 发行版。Proxmox VE 基于 Debian，使用基于 Ubuntu 的定制内核，包含安装程序、网页控制台和命令行工具，并且向第三方工具提供了 REST API。Proxmox VE 支持两类虚拟化技术：基于容器的 LXC（自 4.0 版开始，3.4 版及以前使用 OpenVZ 技术）和硬件抽象层全虚拟化的 KVM1。
超详细,多图 PVE 安装 OpenWRT 教程(个人记录)
热门推荐
会飞的程序猿的博客
05-12 6万+
写这个的目的是因为本人健忘所以做个记录以便日后再折腾时查阅。- 本人笔拙如有选词，错字，语法，标点错误请忽视，大概率不会修改，我自己能看懂就好。- 内容仅适用于本人的使用环境，不同环境请忽视或仅作参考。- 文中出现的内容来自网络和本人浅薄的认知，如果万一有侵犯他人内容请私信。- 纯自己瞎记录, 虽然没啥可能性如果万一以千万分之一的概率得到赏识被转载的话还请注明作者和出处第一次写, 截图比想象中难, 尽量多记录一些以免以后忘掉吧. 下一个记录内容让我再想想...
在 PVE 中安装 OpenWrt （超详细教程）
2301_80985796的博客
08-22 8252
本文介绍了在PVE虚拟环境中安装OpenWrt软路由的完整流程。从官网下载Proxmox软件和OpenWrt固件。使用qm import命令导入磁盘镜像、调整磁盘类型为SATA、设置启动顺序等关键步骤。最后指导用户修改OpenWrt网络配置（包括IP地址、网关和DNS设置），并通过vi编辑器修改配置文件后重启服务。完成配置后可通过Web界面访问OpenWrt管理页面，初始账号密码取决于固件来源
推荐项目：ImmortalWRT
gitblog_00004的博客
03-05 7258
推荐项目：ImmortalWRT 项目链接 如果你正在寻找一个强大的、易于使用的路由器固件，那么 ImmortalWRT 就是你需要的。 什么是 ImmortalWRT？ ImmortalWRT 是一款基于 OpenWRT 的开源路由器固件。它提供了一个稳定的平台，让你可以轻松地管理你的网络设备。此外，ImmortalWRT 还提供了许多高级功能，如防火墙、虚拟私有网络 (VPN) 支持、自定义脚...
小米路由器3G刷OpenWrt或ImmortalWrt的详细步骤
gift925的专栏
04-27 1万+
下载地址是下面：（两个网址2选1即可，上面是原版openwrt，下面是针对openwrt本地化的一个版本，软件库中带了一些魔法插件，但是要你自己点击安装）步骤5：找个U盘，确保是FAT32格式的,把miwifi_ssh.bin和kernel1.bin还有rootfs0.bin都放入U盘根目录，必须根目录。步骤6：断开路由器电源，U盘插入路由器，牙签顶住Reset不要松手，然后接上电源，等待黄灯闪烁，松手。步骤7：等待路由器启动，绿灯长亮，找一台电脑，与路由器LAN口连接，地址配置成DHCP。
PVE中安装openwrt（IMG镜像文件）
No1_Hp的博客
11-06 9236
趁着双十一搞了一个2.5G口的工控机，折腾个openwrt。在折腾的过程中遇到了一些小问题，在这里记录一下，给未来其他的兄弟们打个样！
PVE安装Openwrt 旁路由
qq_34036107的博客
07-09 1万+
PVE 安装Openwrt 并设置旁路由
rax3000m 刷机 uboot + immortalwrt
迷宫中的我
01-07 3万+
rax3000m 生产日期20231027 一台（nand版本的）
教程 | 在PVE中部署OpenWrt旁路由教程（附主题包和镜像）
The God Of BigData 的博客
02-14 4607
旁路由（又称辅助网关）是一种在不改变主路由网络结构的前提下，通过旁路设备实现流量过滤、科学上网、去广告等高级功能的方案。本教程将指导您在Proxmox VE中安装OpenWrt并配置为旁路由。
PVE安装Openwrt
Awesome_py的博客
05-09 1127
本文介绍了在Proxmox VE (PVE) 上安装OpenWrt的步骤。首先，从OpenWrt官网下载适用于x86_64架构的镜像文件，并上传至PVE的指定路径。接着，使用qm importdisk命令将镜像导入为虚拟机磁盘，建议生成qcow2格式以支持快照功能。最后，配置OpenWrt的软件包源，包括核心、基础、Luci界面、路由、电话等模块的下载地址。整个过程涵盖了从镜像下载到虚拟机创建及配置的完整流程，适合在PVE环境中部署OpenWrt的用户参考。
openwrt ipv6上网配置过程
程序员记事本
05-12 3万+
openwrt 系统，具体为immortalWrt软路由系统，折腾了半天，尝试了routeros 7.1,7.2等各种ros版本，始终卡在dhcp ipv6 client界面一直是searching状态，说啥也取不到ipv6地址，最后关掉ros，直接配置openwrt去拨号上网一切问题迎刃而解。 一、添加接口 网络->接口->添加接口，添加第二块网卡。我这里添加的新接口名称叫做lan1,原来那个叫做lan，忘记改名了。 二、设定拨号 在原来的lan接口上面配置pppoe拨号（实际应为wa
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

会当凌绝顶大叔

我为这篇文章脱过发，你脱过吗

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值