X-OpenWrt/README.md

5.2 KiB

Actions for Building OpenWrt / AutoUpdate

GitHub Stars GitHub Forks

测试通过的设备: d-team_newifi-d2xiaoyu_xy-c5x86_64(img、img.gz)

测试通过的源码: coolsnowwolf/lede:masterimmortalwrt/immortalwrtopenwrt/openwrt

部署环境(STEP 1):

  1. 首先需要获取 Github Token: 点击这里 获取,

    Note项填写一个名称,Select scopes全部打勾,完成后点击下方Generate token

  2. 复制页面中生成的 Token,并保存到本地,Token 只会显示一次!

  3. Fork 我的AutoBuild-Actions仓库,然后进入你的AutoBuild-Actions仓库进行之后的设置

  4. 点击上方菜单中的Settings,依次点击Secrets-New repository secret

    其中Name项随意填写,然后将你的 Token 粘贴到Value项,完成后点击Add secert

定制固件(STEP 2):

  1. 进入你的AutoBuild-Actions仓库,下方所有操作都将在你的AutoBuild-Actions仓库下进行

  2. 把本地的 .config 文件重命名为你的设备名称并上传到/Configs目录

  3. 编辑.github/workflows/*.yml文件,修改第 9 和 29 行为你的设备名称

    更换源码与分支 修改第 30 行 REPO_URL:为源码仓库地址,第 31 行为分支 (可选)

  4. 按照需求编辑Scripts/AutoBuild_DiyScript.sh文件的 Firmware-Diy() 函数

    注意: 定制固件建议只修改 AutoBuild_DiyScript.sh 文件,而不是修改 AutoBuild_Function.sh

    软件包列表 编辑CustomPackages目录下对应设备名称的文件,按照现有语法为特定设备添加软件包 (可选)

AutoBuild_DiyScript.sh: Diy_Core() 函数中的变量解释:

   Author 作者名称,若该项留空将自动设置为你的 Github 用户名

   Default_Device 设备的官方名称,例如 d-team_newifi-d2、x86_64
   
   Short_Firmware_Date 固件日期样式,当设置为 true: [20210501] false: [202105012300]
   
   Default_IP_Address 固件 LAN IP 地址,默认为: [192.168.1.1] false: [不做任何修改]

   INCLUDE_AutoUpdate 启用后,将自动添加 Scripts/AutoUpdate.sh 和 luci-app-autoupdate 到固件

   INCLUDE_AutoBuild_Tools 添加 AutoBuild 工具箱: AutoBuild_Tools.sh 到固件

   INCLUDE_DRM_I915 自动启用 Intel Graphics 驱动 (测试特性)

   INCLUDE_Theme_Argon 自动添加适用于当前源码的 luci-theme-argon 主题

   INCLUDE_Obsolete_PKG_Compatible 优化原生 OpenWrt-19.07、21.02 支持 (测试特性)
   
   注: 若要启用某项功能,请将该值修改为 true,禁用某项功能则修改为 false 或留空

其他指令: 编辑Scripts/AutoBuild_DiyScript.sh,参照下方语法:

   [使用 git clone 拉取文件]  AddPackage git 存放位置 软件包名 仓库地址 分支

   [使用 svn co 拉取文件]  AddPackage svn 存放位置 软件包名 仓库地址/branches/分支/路径

   [替换 /CustomFiles 文件到源码] Replace_File 文件(夹)名称 目标路径 新名称[可选]
   
   [查找文件/文件夹] PKG_Finder f/d(文件/文件夹) 文件(夹)名称 查找路径

编译固件(STEP 3):

一键编译 先删除第 26-27 行的注释并保存,单(双)击重新点亮右上角的 Star 即可一键编译

定时编译 先删除第 23-24 行的注释,然后按需修改相关参数并保存,使用方法

手动编译 点击上方Actions,选择你要编译的设备名称,点击右方Run workflow,点击绿色按钮即可开始编译

临时修改 IP 地址 该功能仅在手动编译时生效,点击Run workflow后即可输入 IP 地址(优先级高于 Diy_Core 函数)

SSH 连接 使用方法参见 P3TERX's Blog

使用固件更新脚本:

首先需要打开TTYD 终端或者在浏览器输入IP 地址:7681,按需输入下方指令:

检查并更新固件(保留配置),输入: AutoUpdatebash /bin/AutoUpdate.sh

更新固件(不保留配置): AutoUpdate -n

查看更多使用方法: AutoUpdate -help

注意: 该功能需要在 Diy-Core() 函数中设置INCLUDE_AutoUpdatetrue

使用固件工具箱:

打开TTYD 终端,输入Toolstools,请自行摸索,功能持续开发中...

注意: 该功能需要在 Diy-Core() 函数中设置INCLUDE_AutoBuild_Toolstrue

鸣谢