-
GitHub 账号
-
GitHub Actions 基本使用技能
若要高度定制固件,需要掌握一定的Liunx、OpenWrt、Actions等相关知识,途径:自行搜索学习
点击展开/关闭
2. fork radebit/lede-build.git
只上传到artifact,可以跳过此步。
进入GitHub Settings(点头像) → Developer settings → Personal access tokens → Generate new token,Note随意填,Expiration建议选No expiration
,Select scopes里勾选repo
、workflow
,点Generate token,复制下长串token。
进入你fork的项目shared-lede下,点Settings → Secrets → Actions → New repository secret,Name填RELEASE_FIRMWARE
,Value填复制的token,点Add secret。
什么也不修改,按默认配置,可以跳过此步。
每个机型关联四个文件,主要修改四个文件,在preset-models目录中。
[数字]clone.sh
此脚本用来拉取固件源码和扩展插件源码,新增插件源时,建议先在本地测试下是否缺依赖。
常用的克隆命令如下(克隆理解为下载即可):
git clone 链接
git clone -b 分支名 链接
[数字]modify.sh
此脚本用于固件初始化设置,修改登录IP、主机名、WiFi名称等。
此脚本用到最多的命令是sed,详细用法参见链接,这里只简单说明。
比如,下面这条命令就是用来修改管理IP的:
sed -i 's/192.168.1.1/192.168.31.1/g' package/base-files/files/bin/config_generate
192.168.1.1
是源码中默认的lan口登录IP,也即初始的;192.168.31.1
是新的,用来替换初始文本的。
可以看出命令的构成是这样的:
sed -i 's/原字符串/新字符串/g' 文件路径
这就可以用来替换掉源码中的特定位置,-i指直接改动文件,s指替换,g指全局。
原字符串记为str1,新字符串记为str2,自定义设置改动str2位置即可,如果你改动了str1,那么命令在源码中就匹配不到东西了,替换也就无效了。
🎈🎈🎈 引用
各基础命令的用法可参考该链接,个人觉得写得很详细,非常适合新手看。当然该作者仓库内还有其他详细的教程,有兴趣的自行查阅。
[数字].config
该文件对应本地编译执行make menuconfig后生成的.config文件。
该文件主要包含luci应用,流程中会自动转为完整的.config。
增减插件修改这个文件即可,以argon主题为例,格式如下:
CONFIG_PACKAGE_luci-theme-argon=y
选中编译进固件的是这种
CONFIG_PACKAGE_luci-theme-argon=m
选中仅编译ipk插件是这种
# CONFIG_PACKAGE_luci-theme-argon is not set
未选中是这种
release_content.yml
此文本仅作release记录,其中的IP、密码与固件并无关联,怎么改都可以,不修改也可以。
选择你的固件编译
这个workflow,再点击Run workflow
,按需填内容,运行即可。
各选项说明如下:
超频到1100Mhz:
默认不勾选。仅适用于5.10内核,除红米AX6S外,其余机型默认皆为5.10内核。
使用5.15内核:
默认不勾选。因lean lede源码中package/lean/mtk-eip93编译会报错,小米4A千兆版和小米3Gv2勿用。
红米AX6S只有5.15内核,不必勾选。
选择机型:
默认为小米4A千兆版。点开下拉框,可以选择不同的机型。
上传到release:
默认勾选。推荐,空间无限,单文件不能超过2GB,有内容记录。 release区见下图:
上传到artifact:
默认不勾选。不推荐,无内容记录。 artifact区见下图:
版本描述:
可作一些简单记录,会在release中显示。
Actions流程顺利完成后,去release(或者artifact)下载你的固件,allfiles.zip是所有文件的打包。
配置目录 | 流程名 | 源码 |
---|---|---|
preset-lede | build lede | coolsnowwolf/lede |
preset-lienol-openwrt | build lienol openwrt | Lienol/openwrt master |
preset-openwrt | build openwrt 23.05 | openwrt/openwrt openwrt-23.05 |
preset-immortalwrt | build immortalwrt 21.02 | immortalwrt/immortalwrt openwrt-21.02 |
preset-x-wrt | build x-wrt | x-wrt/x-wrt master |
机型 | 配置目录下的关联文件 |
---|---|
小米4 | 1.config 1.clone.sh 1.modify.sh |
小米3G | |
小米3Pro | |
小米CR6606 | |
小米CR6608 | |
小米CR6609 | |
红米AC2100 | |
小米AC2100 | |
红米AX6S | |
斐讯K2P | 2.config 1.clone.sh 1.modify.sh |
小米3Gv2 | |
小米4A千兆版 | |
小米4A千兆版v2 | |
小米4A百兆版 | |
小米4C | |
小米WiFi R3 | |
小米WiFi nano | |
小米WiFi mini | |
GL.iNet mt300n v2 | |
GL.iNet microuter n300 |
1.直接在Actions中运行固件编译
就能编译出固件,但默认插件数量较少,对插件有增、减需要的,到[数字].config
中自行选择。若在[数字]clone.sh
中添加了插件源,在[数字].config
要作对应修改,建议先在本地make menuconfig测试。
2.超频方案默认不启用,方案来自该帖子。
3.小米4A千兆版和小米3Gv2需修改分区才能在breed直刷,参考该帖子,本项目中已修改好。
4.小米4A千兆版和小米3Gv2闪存小,若编译插件太多,包体积超出16064K,则不会生成sysupgrade.bin。
可以去官方插件库参考各插件大小,下方也列出了几个较大插件的最近版本的体积:
UnblockNeteaseMusic-Go_0.2.13 --- 2.05MB
luci-app-openclash_0.44.16 --- 2.14MB
luci-app-vssr_1.23 --- 2.87MB
xray-core_1.5.3 --- 5.63MB
5.流程文档参考KFERMercer/OpenWrt-CI
感谢 JetBrains 为本项目提供IDE工具支持!