【必读】AutoBuildImmortalWrt 项目定位说明

[wukongdaily]

项目定位

AutoBuildImmortalWrt 的定位是一个 面向普通用户的构建工具，而不是固件发布项目，也不是开发者使用的完整编译框架。

本项目的目标，是让普通用户可以通过 云端 ImageBuilder 自动化流程，在不搭建本地编译环境的情况下，生成属于自己的固件。

很多用户的实际需求只是：

• 基于官方系统
• 集成少量常用软件包
• 按需加入一些第三方插件

对于这类需求来说，完整编译整个系统源码往往过于复杂，而 ImageBuilder 本身是一个更合适的工具。本项目的作用，就是简化这一过程。

---

设计原则

AutoBuildImmortalWrt 在设计上遵循以下几个原则：

1. 不修改上游源码

   固件构建基于官方 ImmortalWrt / OpenWrt ImageBuilder，尽量保持与上游版本的一致性和稳定性。

2. 由用户自行构建固件

   本仓库提供的是 自动化构建流程，而不是预编译固件。
   用户通过 fork 仓库并使用 GitHub Actions 自行生成固件。

3. 不长期维护 Release 固件

   本项目原则上不提供长期维护的固件发布版本，以避免仓库演变为固件分发平台。

4. 第三方软件来源透明

   部分软件包可能来自第三方仓库。本项目会尽可能标注其来源。
   这些组件可能包含开源或闭源软件，用户需要根据自身需求自行判断是否使用。

---

项目存在的意义

官方的 OpenWrt/Immortalwrt Firmware Selector 提供了一个方便的在线固件生成工具，但出于公共服务稳定性和安全性的考虑，它在定制能力上做了一些限制，例如：

• rootfs 大小受到限制
• 只能使用官方仓库的软件包
• 难以集成仓库之外的第三方软件

对于希望集成较大软件包（例如 Docker）或使用第三方插件的用户来说，这些限制会影响定制能力。

AutoBuildImmortalWrt 的目标，是在保持 ImageBuilder 构建方式 的前提下，提供一种更灵活的自动化构建方式，同时仍然保持相对简单的使用体验。

---

项目边界

本项目主要关注：

• 为普通用户提供简化的固件构建方式
• 提供基于 GitHub Actions 的自动化 ImageBuilder 流程
• 尽量保持与上游项目的兼容性

本项目 不以以下目标为目的：

• 替代官方固件发布
• 维护一个自定义固件发行版
• 修改 OpenWrt / ImmortalWrt 的核心系统

---

简而言之：

AutoBuildImmortalWrt 是一个帮助用户自动生成固件的工具，而不是一个固件项目。