当前位置：首页 > article >正文

【软路由】ImmortalWrt 编译指南：从入门到精通

article 2025/3/3 6:08:25

对于喜欢折腾路由器，追求极致性能和定制化的玩家来说，OpenWrt 无疑是一个理想的选择。而在众多 OpenWrt 衍生版本中，ImmortalWrt 以其更活跃的社区、更激进的特性更新和对新硬件的支持而备受关注。本文将带你深入了解 ImmortalWrt，并手把手教你如何编译属于自己的定制固件。

ImmortalWrt：OpenWrt 的一个优秀分支

ImmortalWrt 是一个基于 OpenWrt 的 Linux 发行版，它旨在提供更稳定、更强大、更易用的路由器固件。

ImmortalWrt 与 OpenWrt/LEDE 的区别：

社区活跃度： ImmortalWrt 拥有一个活跃的开发者社区，这意味着你能更快地获得问题的解答和最新的技术支持。
更新频率： ImmortalWrt 的更新频率通常比 OpenWrt 更高，会更早地引入最新的 Linux 内核、驱动程序和软件包。
软件包选择： ImmortalWrt 倾向于提供更多可选的软件包，方便用户根据自己的需求进行定制。
目标定位： ImmortalWrt 在一定程度上更偏向于 “发烧友” 级别的用户，他们更愿意尝试最新的技术和功能。
LEDE 的历史： OpenWrt 曾经分叉为 LEDE 项目，旨在解决 OpenWrt 内部的开发流程问题。后来，LEDE 项目合并回 OpenWrt。 ImmortalWrt 从 LEDE 分支发展而来，因此在某些方面继承了 LEDE 的特性。

总的来说，ImmortalWrt 可以看作是 OpenWrt 的一个更激进、更前沿的版本，它更适合那些喜欢尝试新事物，并希望充分利用路由器性能的用户。

编译 ImmortalWrt：打造你的专属固件

下面是编译 ImmortalWrt 的详细步骤：

1. 准备工作

一台 Linux 系统的电脑： 推荐使用 Debian/Ubuntu 等常见的 Linux 发行版。
足够的硬盘空间： 建议至少预留 50GB 的硬盘空间。
稳定的网络连接： 编译过程需要下载大量的软件包。
安装必要的软件包： 在终端中执行以下命令安装编译所需的软件包：
```
sudo apt update
sudo apt install -y build-essential gcc g++ binutils patch bzip2 flex bison make gettext ncurses-dev zlib1g-dev libssl-dev python3 util-linux bc rsync vim git unzip libncurses5
```
- 注意： 不同的 Linux 发行版，安装软件包的命令可能略有不同。例如，在 CentOS/RHEL 中，你需要使用 yum 命令。

2. 下载 ImmortalWrt 源码

首先，选择一个合适的目录来存放源码，然后使用 git 命令克隆 ImmortalWrt 的代码仓库：

git clone https://github.com/immortalwrt/immortalwrt.git
cd immortalwrt

3. 更新和安装 feeds

./scripts/feeds update -a
./scripts/feeds install -a

4. 配置编译选项

使用 make menuconfig 命令打开配置界面：

make menuconfig

在配置界面中，你可以根据自己的需求选择目标架构、型号、软件包等。以下是一些常用的配置选项：

Target System (目标系统): 选择你的路由器所使用的 CPU 架构，例如 MediaTek Ralink ARM（TR3000）。
Subtarget (子目标): 选择更具体的 CPU 型号。
Target Profile (目标配置): 选择你的路由器型号。如果没有找到你的型号，可以选择一个类似的型号。
Base system (基本系统): 这里可以配置 Busybox、内核等选项。
Kernel modules (内核模块): 这里可以配置各种内核模块，例如文件系统、网络驱动等。
LuCI (图形界面): LuCI 是 OpenWrt 的 Web 管理界面，强烈建议选择。你可以在这里配置 LuCI 的主题和语言。
Utilities (实用工具): 这里可以配置各种实用工具，例如 tcpdump、iperf 等。
Languages (语言): 选择你需要的编程语言支持，例如 Python、Lua 等。

使用方向键移动光标，使用空格键选择/取消选择，使用回车键进入下一级菜单，使用 Esc 键返回上一级菜单。

重要提示：

如果你不确定如何配置，可以使用默认配置。
如果你需要添加额外的软件包，可以在 “Network”、“Kernel modules”、“LuCI” 等菜单中查找。
保存配置后，会生成一个 .config 文件，这个文件包含了你的所有配置信息。

5. 开始编译

执行以下命令开始编译：

make -j$(nproc) V=s

-j$(nproc) 参数表示使用所有 CPU 核心进行编译，可以加快编译速度。
V=s 参数表示显示详细的编译信息，方便你排查错误。

编译过程可能需要几个小时，具体时间取决于你的电脑性能和选择的软件包数量。

6. 查找固件

编译完成后，固件文件通常位于 bin/targets 目录下。你需要根据你的路由器型号找到对应的固件文件。

一般情况下，包含 factory.bin 的固件用于第一次刷机，包含 sysupgrade.bin 的固件用于升级。

7. 刷写固件

刷写固件的方法因路由器型号而异。通常可以通过路由器的 Web 管理界面或使用 U-Boot 等工具进行刷写。请务必参考你路由器的官方文档或相关教程。

重要提示：

刷写固件有风险，请务必谨慎操作。
在刷写固件之前，请务必备份你的路由器配置。
如果刷写固件失败，可能会导致路由器无法启动。

常见问题及处理

编译出错： 仔细查看编译输出的错误信息，通常是缺少必要的软件包或配置错误。根据错误信息安装缺少的软件包或修改配置。
下载软件包失败： 检查你的网络连接是否正常，或者更换一个软件源。
固件无法启动： 可能是固件与你的路由器型号不匹配，或者刷写过程出错。尝试重新刷写固件，或者选择一个更合适的固件。
Web 管理界面无法访问： 检查你的路由器 IP 地址是否正确，或者尝试清除浏览器缓存。
无线网络不稳定： 尝试更换无线信道，或者调整无线功率。
空间不足: 可能是选择的软件过多，精简不必要的软件，或者更换大容量的路由器。

常用包作用解释

网络驱动相关 (Network Drivers):

kmod-e1000e: Intel PRO/1000 (Gigabit) 网卡的内核模块驱动程序。常见于较新的 Intel 千兆网卡。
kmod-tulip: DEC Tulip (21140/21143) 系列网卡的内核模块驱动程序。较老的以太网卡。
kmod-i40e: Intel Ethernet Connection XL710/X722 系列 40GbE 网卡的内核模块驱动程序。用于高速网络环境。
kmod-usb-net-asix-ax88179: ASIX AX88179 USB 网卡芯片的内核模块驱动程序。常见的 USB 千兆网卡。
kmod-amazon-ena: Amazon Elastic Network Adapter (ENA) 的内核模块驱动程序。用于在 AWS 云环境中优化网络性能。
kmod-igbvf: Intel Gigabit Virtual Function (VF) 的内核模块驱动程序。用于 Intel 千兆网卡的 SR-IOV 虚拟化。
kmod-r8126: Realtek RTL8126 网卡的内核模块驱动程序。
kmod-8139too: Realtek RTL8139 系列网卡的内核模块驱动程序。较老的百兆网卡。
kmod-bnx2: Broadcom NetXtreme II 系列网卡的内核模块驱动程序。用于服务器级别的网卡。
kmod-usb-net-rtl8150: Realtek RTL8150 USB 网卡芯片的内核模块驱动程序。较老的 USB 网卡。
kmod-r8168: Realtek RTL8168 系列网卡的内核模块驱动程序。常见的千兆网卡。
kmod-ixgbevf: Intel 10 Gigabit Virtual Function (VF) 的内核模块驱动程序。用于 Intel 万兆网卡的SR-IOV虚拟化。
kmod-forcedeth: NVIDIA nForce 系列芯片组集成网卡的内核模块驱动程序。较老的网卡。
kmod-r8125: Realtek RTL8125 2.5GbE 网卡的内核模块驱动程序。用于2.5G网卡。
kmod-usb-net: 通用的 USB 网络设备驱动程序框架。其他 USB 网卡驱动会依赖它。
kmod-8139cp: Realtek RTL8139C+ 网卡的内核模块驱动程序。
kmod-ixgbe: Intel X520/X540/X550 系列 10 Gigabit 网卡的内核模块驱动程序。用于万兆网卡。
kmod-pcnet32: AMD PCnet32 系列网卡的内核模块驱动程序。非常老的网卡。
kmod-usb-net-asix: ASIX USB 网卡芯片的内核模块驱动程序框架。
kmod-igc: Intel I219/I225 系列网卡的内核模块驱动程序。
kmod-usb-net-rtl8152-vendor: 用于支持特定的基于Realtek RTL8152芯片的USB网卡设备，提供额外的或定制化的驱动支持。
kmod-e1000: Intel PRO/1000 (Gigabit) 网卡的内核模块驱动程序。较老的Intel千兆网卡
kmod-r8101: Realtek RTL8101 系列网卡的内核模块驱动程序。
kmod-igb: Intel Gigabit Ethernet 的内核模块驱动程序。用于Intel千兆网卡
kmod-tg3: Broadcom Tigon3 系列网卡的内核模块驱动程序。用于服务器级别的网卡。
kmod-amd-xgbe: AMD 10GbE 网卡的内核模块驱动程序。
kmod-dwmac-intel: 用于支持基于DesignWare MAC (dwmac) IP核的Intel以太网控制器。
kmod-vmxnet3: VMware Virtual Machine Network eXtended v3 网卡的内核模块驱动程序。用于VMware虚拟机的虚拟网卡驱动。

文件系统相关 (File System):

kmod-fs-f2fs: F2FS (Flash-Friendly File System) 文件系统的内核模块驱动程序。针对闪存存储优化。
kmod-fs-vfat: VFAT (Virtual FAT) 文件系统的内核模块驱动程序。用于支持FAT16/FAT32文件系统，常用于U盘、SD卡等。
mkf2fs: 用于创建 F2FS 文件系统的命令行工具。

其他硬件驱动 (Other Hardware Drivers):

kmod-usb-hid: USB Human Interface Device (HID) 的内核模块驱动程序。用于支持USB键盘、鼠标等HID设备。
kmod-button-hotplug: 用于支持热插拔按钮事件的内核模块。例如，笔记本电脑上的电源按钮、音量按钮等。
kmod-drm-i915: 集成显卡的Direct Rendering Manager (DRM) 驱动，用于支持图形加速和显示功能。
i915-firmware-dmc: Intel i915 系列集成显卡的动态微码 (DMC) 固件。用于优化图形性能和功耗。

磁盘管理和系统引导 (Disk Management and Boot):