ImmortalWrt 在线构建服务使用说明

简介

ImmortalWrt 在线构建服务由 aparcar 开发的 Attendedsysupgrade Server（ASU）实现，其本质为云端运行的 Image Builder。 ASU 通过一系列 API 实现自定义固件映像及预安装软件包，可以让用户轻松升级现有或自定义全新 ImmortalWrt 固件，而无需配置任何构建环境。

客户端

ImmortalWrt 固件选择器

地址：https://firmware-selector.immortalwrt.org 基于纯 JavaScript 实现的简单 Web 界面，目前由 mwarning 开发。它支持搜索设备名称，并展示对应的固件下载链接以及通过 ASU API 请求自定义固件。

luci-app-attendedsysupgrade

软件包 luci-app-attendedsysupgrade 位于 LuCI 系统 -> 值守式系统更新。它会请求一个包含当前软件包的新固件并进行刷写。只需勾选“保留当前配置”，无需任何额外配置即可直接升级到新固件。

auc

软件包 auc 是 luci-app-attendedsysupgrade 的命令行版，升级流程与 LuCI 版一致。

服务端

服务端会监听客户端请求，如果请求有效，则生成对应的固件。它利用 Image Builder 构建固件，并进行缓存。如果构建请求命中缓存，则会直接返回结果，不会重复构建。

官方服务器

~~https://sysupgrade.immortalwrt.org~~ （域名已弃用）
https://sysupgrade.kyarucloud.moe

[!NOTE] 单个构建有效期为七天，七天后会清理对应的文件及缓存条目。

[!WARNING] 单个 IP 每分钟内只能发起两次构建请求，否则将被封禁一小时。

使用说明

ImmortalWrt 固件选择器

[!NOTE] 有关软件包名的填写，请参阅 ImmortalWrt Image Builder 使用说明 确定软件包 一栏。

[!IMPORTANT] 1. 在稳定版本中，默认携带了部分 LuCI 插件。在自定义构建时，也需要将其更名为 luci-i18n-<app>-zh-cn。 2. 如果不确定该选择什么版本，保持为默认即可；如非必要，尽量避免使用 SNAPSHOT （主线）版本。

luci-app-attendedsysupgrade

您可以在 配置 选项卡内更新构建服务器地址，以及开启高级模式等。

在高级模式下，请求更新时可以自定义需要集成的软件包。

[!IMPORTANT] 如安装了 ImmortalWrt 软件源中没有的软件包，需要在此去除，否则将无法通过服务端验证。

auc

$ auc -h
auc/0.3.2-1
auc: Attended sysUpgrade CLI client
Usage: auc [-b <branch>] [-B <ver>] [-c] [-f] [-h] [-r] [-y]
 -b <branch>    指定分支/版本
 -c     获取最新版本号
 -f     强制执行
 -h     打印帮助
 -n     模拟执行
 -r     只检查稳定版更新
 -F <fstype>    覆盖文件系统类型
 -y     无需确认

[!NOTE] 目前 auc 实现存在一些 bug，非必要不推荐使用。

参考

openwrt/asu

1715173329 / blog