137 lines
5.9 KiB
Markdown
137 lines
5.9 KiB
Markdown
# OpenWrt-Actions & One-key AutoUpdate
|
|
|
|
|
|
|
|
|
|
AutoBuild-Actions 稳定版/模板地址: [AutoBuild-Actions-Template](https://github.com/Hyy2001X/AutoBuild-Actions-Template)
|
|
|
|
自用修改版软件包地址: [AutoBuild-Packages](https://github.com/Hyy2001X/AutoBuild-Packages)
|
|
|
|
支持的 OpenWrt 源码: `coolsnowwolf/lede`、`immortalwrt/immortalwrt`、`openwrt/openwrt`、`lienol/openwrt`
|
|
|
|
❗**为了你的账号安全, 请不要使用 SSH 连接 Github Action**, `.config`配置等操作请在本地完成
|
|
|
|
## 一、定制固件(可选)
|
|
|
|
1. 进入你的`AutoBuild-Actions`仓库, **下方所有操作都将在你的`AutoBuild-Actions`仓库下进行**
|
|
|
|
建议使用`Github Desktop`和`Notepad++`进行操作 [[Github Desktop](https://desktop.github.com/)] [[Notepad++](https://notepad-plus-plus.org/downloads/)]
|
|
|
|
**提示**: 文中的 **TARGET_PROFILE** 均为你要编译的设备的设备名称, 例如: `d-team_newifi-d2`、`asus_rt-acrh17`
|
|
|
|
从本地获取: 在源码目录执行`egrep -o "CONFIG_TARGET.*DEVICE.*=y" .config | sed -r 's/.*DEVICE_(.*)=y/\1/'`
|
|
|
|
或执行`grep 'TARGET_PROFILE' .config`, 请先执行`make menuconfig`进行配置
|
|
|
|
2. 编译`/Configs`目录下的配置文件, 若该设备的配置文件不存在则需要把本地的`.config`文件重命名为 **TARGET_PROFILE** 值并上传
|
|
|
|
3. 编辑`/.github/workflows/*.yml`文件, 修改`第 7 行`为易于识别的设备名称
|
|
|
|
4. 编辑`/.github/workflows/*.yml`文件, 修改`第 32 行`为 **TARGET_PROFILE** 值
|
|
|
|
5. 按照需求且编辑`/Scripts/AutoBuild_DiyScript.sh`文件即可, `/Scripts`下的其他文件可以都不用修改
|
|
|
|
**单独的软件包列表** 按照现有语法和提示编辑`/Scripts/AutoBuild_ExtraPackages.sh`
|
|
|
|
**/Scripts/AutoBuild_DiyScript.sh: Diy_Core() 函数中的变量解释:**
|
|
```
|
|
Author 作者名称,若留空将自动获取为 Github 用户名
|
|
|
|
Banner_Title Banner 标题,与作者名称一同在 Shell 展示
|
|
|
|
* Default_LAN_IP 固件 IP 地址
|
|
|
|
Short_Firmware_Date 启用简短的固件日期 true: [20210601]; false: [202106012359]
|
|
|
|
* Load_Common_Config 位于 /Configs/Common 的通用配置文件, 将被追加到当前设备的配置文件中
|
|
|
|
* Load_CustomPackages_List 启用后, 将运行 /Scripts/AutoBuild_ExtraPackages.sh 脚本
|
|
|
|
Checkout_Virtual_Images 额外上传已检测到的 x86 虚拟磁盘镜像
|
|
|
|
Firmware_Format 自定义固件格式, 多个格式请用空格隔开
|
|
|
|
REGEX_Skip_Checkout 固件目录无用文件屏蔽正则表达式
|
|
|
|
* INCLUDE_AutoBuild_Features 自动添加 AutoBuild 固件特性, 例如: 一键更新、部分优化
|
|
|
|
* INCLUDE_DRM_I915 自动启用 x86 设备的 Intel Graphics 显卡驱动
|
|
|
|
INCLUDE_Argon 自动添加 luci-theme-argon 主题和主题控制器
|
|
|
|
INCLUDE_Obsolete_PKG_Compatible 完善原生 OpenWrt-19.07、21.02 支持 (测试特性)
|
|
|
|
注: 禁用部分功能请将变量值修改为 false, 开启则为 true
|
|
|
|
带 * 符号的选项表示仅在 coolsnowwolf/lede 源码测试通过
|
|
```
|
|
|
|
## 二、编译固件(必选)
|
|
|
|
**手动编译** 点击上方`Actions`, 在左栏选择要编译的设备,点击右方`Run workflow`再点击绿色按钮即可开始编译
|
|
|
|
**一键编译** 删除`第 26-27 行`的注释并保存, 触发点亮右上角的 **Star** 按钮即可一键编译
|
|
|
|
**定时编译** 删除`第 23-24 行`的注释, 然后按需修改时间并提交修改 [Corn 使用方法](https://www.runoob.com/w3cnote/linux-crontab-tasks.html)
|
|
|
|
**自定义固件 IP 地址** 该功能仅在**手动编译**生效, 点击`Run workflow`后即可输入 IP 地址
|
|
|
|
## 部署云端日志(可选)
|
|
|
|
1. 下载本仓库中的 [Update_Logs.json](https://github.com/Hyy2001X/AutoBuild-Actions/releases/download/AutoUpdate/Update_Logs.json) 到本地
|
|
|
|
2. 以**JSON 格式**编辑`Update_Logs.json`
|
|
|
|
3. 上传修改后的`Update_Logs.json`到你仓库的`Release`
|
|
|
|
## 使用一键更新固件脚本
|
|
|
|
首先需要打开`TTYD 终端`或者使用`SSH`, 按需输入下方指令:
|
|
|
|
更新固件: `autoupdate`或`bash /bin/AutoUpdate.sh`
|
|
|
|
使用镜像加速更新固件: `autoupdate -P`
|
|
|
|
更新固件(不保留配置): `autoupdate -n`
|
|
|
|
强制刷入固件: `autoupdate -F`
|
|
|
|
"我不管, 我就是要更新!": `autoupdate -f`
|
|
|
|
更新脚本: `autoupdate -x`
|
|
|
|
列出相关信息: `autoupdate --list`
|
|
|
|
查看所有可用参数: `autoupdate --help`
|
|
|
|
**注意: **部分参数可一起使用, 例如: `autoupdate -n -P G -F --skip --path /mnt/sda1`
|
|
|
|
## 使用 tools 固件工具箱
|
|
|
|
打开`TTYD 终端`或者使用`SSH`, 执行指令`tools`或`bash /bin/AutoBuild_Tools.sh`即可启动固件工具箱
|
|
|
|
当前支持以下功能:
|
|
|
|
- USB 扩展内部空间
|
|
- Samba 相关设置
|
|
- 打印端口占用详细列表
|
|
- 打印所有硬盘信息
|
|
- 网络检查 (基础网络 | Google 连接检测)
|
|
- AutoBuild 固件环境修复
|
|
- 系统信息监控
|
|
- 打印在线设备列表
|
|
|
|
## 鸣谢
|
|
|
|
- [Lean's Openwrt Source code](https://github.com/coolsnowwolf/lede)
|
|
|
|
- [P3TERX's Blog](https://p3terx.com/archives/build-openwrt-with-github-actions.html)
|
|
|
|
- [ImmortalWrt's Source code](https://github.com/immortalwrt)
|
|
|
|
- [eSir 's workflow template](https://github.com/esirplayground/AutoBuild-OpenWrt/blob/master/.github/workflows/Build_OP_x86_64.yml)
|
|
|
|
- [[openwrt-autoupdate](https://github.com/mab-wien/openwrt-autoupdate)] [[Actions-OpenWrt](https://github.com/P3TERX/Actions-OpenWrt)]
|
|
|
|
- 测试与建议: [CurssedCoffin](https://github.com/CurssedCoffin) [Licsber](https://github.com/Licsber) [sirliu](https://github.com/sirliu) [神雕](https://github.com/teasiu) [yehaku](https://www.right.com.cn/forum/space-uid-28062.html) [缘空空](https://github.com/NaiHeKK) [281677160](https://github.com/281677160)
|