SuperAPI AI 工具集

openwrt-image-build

部署与运维

查看项目

更新于 10-15 21:48

技能介绍

用途:用官方 OpenWrt Image Builder(IB)构建定制镜像,适用于官方 Table of Hardware 在列、IB 有对应 PROFILE 的设备;Amlogic 盒子 eMMC 重打包、运行时 UCI 配置等场景不在本技能范围,需移交其他技能。

主要能力:下载并缓存 IB(24.10+ 为 .tar.zst,旧版 .tar.xz);用 make info 实证 PROFILE;把包分 common/tier/arch 三层拼接为 PACKAGES,支持 PACKAGES="-pkg" 从默认集移除;用 FILES= 注入覆盖层,语义为覆盖式合并而非整包替换,会先删同名符号链接,保留权限位,并对带 #!/bin/sh /etc/rc.common shebang 的 /etc/init.d/* 自动 enable;产物收集并生成 sha256。

使用方式:先做前置检查(x86_64 Linux、≥5GB 磁盘、curl/tar/make/sha256sum/zstd、下载域可达),下载解压 IB 后执行 make info 确认 PROFILE,再运行 make image PROFILE="..." PACKAGES="..." FILES="$(pwd)/files",可选 BIN_DIR、EXTRA_IMAGE_NAME、DISABLED_SERVICES、ROOTFS_PARTSIZE。建议先 make manifest 预演包清单。

限制:构建成功不等于硬件可用,未经真机刷写验证只能标注 Build Verification Only;不要手放 /etc/rc.d 链接,不要编造 PROFILE,不要假设喂入 rootfs.tar.gz 即可出镜像(IB 输入是 repositories.conf 的 ipk)。基线为 OpenWrt 25.12.5,后续版本语义以官方源为准。