ImmortalWrt固件编译实战：从源码到路由器的完整流程

你是否曾因找不到适合自己路由器的固件而烦恼？是否想定制专属功能却苦于没有合适的教程？本文将带你从零开始，完成ImmortalWrt固件的编译全过程，让你轻松打造个性化路由器系统。读完本文，你将掌握环境搭建、源码获取、配置定制、编译构建等核心技能，最终成功将固件刷入路由器。

项目简介

ImmortalWrt是一个基于OpenWrt的开源项目变体，专为中国大陆用户优化，提供了更多的软件包、设备支持、默认优化配置和本地化修改。与上游项目相比，ImmortalWrt允许使用（非上游化的）修改/ hacks来提供更好的功能/性能/支持。

默认登录地址：http://192.168.1.1 或 http://immortalwrt.lan，用户名：root，密码：无。

编译环境准备

系统要求

编译ImmortalWrt固件需要GNU/Linux、BSD或macOS系统（要求区分大小写的文件系统）。不支持Cygwin，因为它缺乏区分大小写的文件系统。推荐使用Debian 11系统，CPU基于AMD64架构，至少4GB RAM和25GB可用磁盘空间，并且确保能够访问互联网。

安装依赖工具

Debian/Ubuntu用户可以通过以下两种方法安装编译所需的依赖工具：

方法一：通过APT安装

sudo apt update -y
sudo apt full-upgrade -y
sudo apt install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
  bzip2 ccache clang cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext gcc-multilib \
  g++-multilib git gnutls-dev gperf haveged help2man intltool lib32gcc-s1 libc6-dev-i386 libelf-dev \
  libglib2.0-dev libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses-dev libpython3-dev \
  libreadline-dev libssl-dev libtool libyaml-dev libz-dev lld llvm lrzsz mkisofs msmtp nano \
  ninja-build p7zip p7zip-full patch pkgconf python3 python3-pip python3-ply python3-docutils \
  python3-pyelftools qemu-utils re2c rsync scons squashfs-tools subversion swig texinfo uglifyjs \
  upx-ucl unzip vim wget xmlto xxd zlib1g-dev zstd

方法二：使用自动脚本安装

sudo bash -c 'bash <(curl -s https://build-scripts.immortalwrt.org/init_build_environment.sh)'

注意事项：

• 以非特权用户（非root）身份执行所有操作，无需使用sudo。
• 使用其他架构的CPU编译ImmortalWrt应该也可以，但需要更多的hack - 不提供任何保证。
• PATH中或驱动器上的工作文件夹中不得有空格或非ASCII字符。
• 如果你使用Windows Subsystem for Linux（或WSL），则需要从PATH中删除Windows文件夹，请参阅Build system setup WSL文档。
• 不建议使用macOS作为主机构建操作系统。不提供任何保证。你可以从Build system setup macOS文档中获取提示。
• 有关更多详细信息，请参阅Build system setup文档。

源码获取

克隆仓库

使用以下命令克隆ImmortalWrt源码仓库：

git clone -b <branch> --single-branch --filter=blob:none https://gitcode.com/GitHub_Trending/im/immortalwrt

其中，<branch>是你想要克隆的分支名称，例如master。

进入源码目录

克隆完成后，进入源码目录：

cd immortalwrt

feeds管理

更新feeds

运行以下命令获取feeds.conf / feeds.conf.default中定义的所有最新软件包定义：

./scripts/feeds update -a

安装feeds

运行以下命令将所有获取的软件包安装到package/feeds/中作为符号链接：

./scripts/feeds install -a

配置定制

菜单配置

运行以下命令选择工具链、目标系统和固件包的首选配置：

make menuconfig

这将打开一个基于ncurses的菜单界面，你可以在其中进行详细的配置。主要包括以下几个方面：

• Target System（目标系统）：选择你的路由器对应的芯片架构。
• Subtarget（子目标）：选择具体的子架构。
• Target Profile（目标配置文件）：选择你的路由器型号。
• 软件包选择：根据需要选择要包含在固件中的软件包。

配置保存

完成配置后，保存配置并退出菜单界面。配置文件将保存在.config文件中。

固件编译

开始编译

运行以下命令开始编译固件：

make

编译过程将下载所有源代码，构建交叉编译工具链，然后为目标系统交叉编译GNU/Linux内核和所有选定的应用程序。编译时间取决于你的计算机性能和网络速度，可能需要几个小时到几天不等。

编译输出

编译完成后，生成的固件文件将位于bin/targets/目录下，具体路径根据你选择的目标系统和子目标而定。

固件刷写

将编译生成的固件文件通过路由器的Web界面或TFTP等方式刷入路由器。不同路由器的刷写方法可能有所不同，请参考路由器的官方文档或相关教程。

相关资源

相关仓库

主仓库使用多个子仓库来管理不同类别的软件包。所有软件包都通过名为opkg的OpenWrt包管理器安装。如果你想开发Web界面或将软件包移植到ImmortalWrt，请在下面找到合适的仓库：

• LuCI Web界面：现代化的模块化界面，可通过Web浏览器控制设备。
• ImmortalWrt软件包：社区移植软件包仓库。
• OpenWrt路由：专门专注于（ mesh）路由的软件包。
• OpenWrt视频：专门专注于显示服务器和客户端（Xorg和Wayland）的软件包。

官方文档

• Build system setup
• Build system setup WSL
• Build system setup macOS

总结与展望

通过本文的介绍，你已经了解了ImmortalWrt固件编译的完整流程。从环境搭建到源码获取，从配置定制到编译构建，每一步都至关重要。希望本文能够帮助你成功编译出自己的专属固件，享受个性化路由器带来的便利。

未来，你可以进一步深入学习ImmortalWrt的源码，开发自己的软件包，为ImmortalWrt社区贡献力量。如果你在编译过程中遇到问题，可以参考官方文档或加入支持社区寻求帮助。

最后，如果你觉得本文对你有帮助，请点赞、收藏、关注三连，下期我们将带来更多关于ImmortalWrt高级应用的教程。