一. 准备工作与项目简介

1. 项目简介

1.1 ImmortalWrt 简介

ImmortalWrt 是一个基于著名的开源路由器操作系统 OpenWrt 的分支（Fork）。OpenWrt 的理念是为你的路由器提供一个可完全定制的 Linux 系统，让你能够像管理一台电脑一样管理你的网络设备。

ImmortalWrt 在此基础上进行了优化，它的主要特点是：

• 稳定性优先： 致力于提供一个稳定、可靠的底层系统。

• 本地化增强： 通常集成了更多符合国人使用习惯的软件包和驱动，例如更完善的 LuCI 界面汉化、常用的网络工具等。

1.2 为什么要构建自己的固件？

既然官方或第三方已经提供了现成的 ImmortalWrt 固件，为什么我们还要费力去“构建”一个呢？主要原因有三：

1. 高度定制化（功能取舍）： 你可以根据自己的需求精确选择软件包。如果你不需要某个功能（比如 FTP 服务器或特定的 VPN 协议），就可以在编译时将其移除，从而让固件更小、更纯净。

2. 性能优化（去冗余）： 移除不必要的模块后，固件占用的存储空间（Flash）更少，启动速度和运行内存（RAM）占用也会相应减少，提升路由器整体性能。

3. 保持最新与安全： 官方固件的发布可能存在延迟。通过自己编译，你可以随时跟随 ImmortalWrt 上游代码库，第一时间应用最新的安全补丁和功能更新。

一句话总结：我们构建的不是“另一个”固件，而是**“最适合你路由器和网络环境的那个”**固件。

1.3 AutoBuildImmortalWrt 项目介绍

AutoBuildImmortalWrt 是一个将固件构建过程完全自动化的 GitHub 项目。它的核心是利用 GitHub Actions（一种 CI/CD 自动化服务）来实现“云端编译”。

• 无需本地环境： 整个编译过程都在 GitHub 的服务器上完成。你不需要在本地安装 Linux 系统，也不用担心编译依赖缺失。

• 配置简单： 它预设了合理的构建脚本，你只需修改配置（.config）文件，然后点击按钮就能启动编译。

• 免费高效： 只要你合理利用 GitHub Actions 的免费额度，就能零成本获取高速、稳定的云端编译服务。

2. 环境要求（你需要准备什么？）

开始之前，请确保你已经准备好了以下几样东西：

1. 一个 GitHub 账号： 用于 Fork 和运行 AutoBuildImmortalWrt 项目。

2. 目标路由器： 确保你的路由器型号在 ImmortalWrt 的支持列表中，并且你知道它的 CPU 架构（例如：MT7621、X86-64、IPQ4019 等）。这是编译时选择配置的依据。（AutoBuildImmortalWrt编译支持列表：https://github.com/wukongdaily/AutoBuildImmortalWrt/blob/master/SUPPORT.md）

3. 一台电脑： 用于访问 GitHub、下载编译好的固件，以及通过网页或刷机工具将固件刷入路由器。

准备好这些，我们就可以进入真正的核心步骤，开始构建了！

二. GitHub Actions 自动化构建流程

这里以X86_64平台为例，其他平台的流程都差不多。

2.1 Fork 项目到你的 GitHub 仓库

第一步是获取 AutoBuildImmortalWrt 项目的副本，以便我们进行修改和编译。

1. 访问项目主页： 打开 AutoBuildImmortalWrt 的 GitHub 仓库链接。（https://github.com/wukongdaily/AutoBuildImmortalWrt）

2. 点击 Fork： 在页面的右上角，找到并点击 "Fork" 按钮。

3. 创建 Fork： 确认操作，GitHub 就会将整个项目复制到你的个人账号下。现在，这个仓库就是你的私人编译工厂了！

提示： 首次 Fork 后，建议定期点击项目页面上方的 "Fetch upstream" → "Fetch and merge" 来同步原作者的最新代码，确保你的编译环境是最新的。

2.2 配置build24.sh 文件：固件定制核心

我们找到x86-64 里面的build24.sh 文件。找到# ============= imm仓库内的插件============== 行，可以在这里编辑你想要的插件。其他地方不能动。（插件仓库地址：https://mirrors.sjtug.sjtu.edu.cn/immortalwrt/releases/24.10.2/packages/x86_64/luci/）

修改好后，我们找到Actions ，在侧边栏选择你想要编译的平台，比如我选择的就是x86_64平台。然后点击 Run workflow 。

然后就可以填入你的固件的基本信息。如 固件大小，是否集成Docker等。

选择好后，我们点击Run workflow 就可以开始编译了。

然后等待编译完成（一般5分钟左右）即可拿到我们自己定制化的ImmortalWrt镜像。可以在Releases 处下载。