OpenWrt编译与部署实战指南 - 基于 Actions-OpenWrt

本教程将深入探索GitHub上的开源项目 MrH723/Actions-OpenWrt，旨在帮助开发者和爱好者理解其核心结构，掌握如何通过官方提供的脚本和配置快速搭建和自定义OpenWrt固件。

1. 项目目录结构及介绍

.
├── .github                  # GitHub Actions相关的配置文件夹
│   ├── workflows            # 工作流定义文件，用于自动化构建等
│   └── secrets              # 私有环境变量加密存储（非直接展示）
├── scripts                  # 脚本文件夹，包含编译前后的辅助脚本
│   ├── clean.sh             # 清理编译环境的脚本
│   └── download.sh          # 下载源码的脚本
├── config                   # 配置文件夹，存放各种自定义配置
│   ├── packages.lua         # 添加或移除软件包的定制列表
│   └── targets.mk           # 目标设备及其配置
├── patches                  # 补丁文件夹，用于对源码的修改
└── README.md                # 项目的主要说明文档

介绍：

• .github: 包含了GitHub Actions的自动化工作流程，使得从代码更新到自动编译成为可能。
• scripts: 提供了一系列实用脚本来简化编译过程，如清理旧编译产物和下载必要的源码。
• config: 用户可以根据需求调整软件包和编译目标，实现高度定制化。
• patches: 包含了针对特定功能或修复的代码补丁，增强了系统的兼容性和功能。

2. 项目启动文件介绍

在本项目中，没有传统意义上的“启动文件”，但关键的自动化“启动”逻辑体现在.github/workflows/main.yml中。这个YAML文件是GitHub Actions的工作流程定义，它控制着整个编译、测试等流程的自动执行：

name: Build OpenWrt

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout code
      uses: actions/checkout@v2
    ...
    - name: Compile OpenWrt
      run: ./scripts/download.sh && ./scripts/build.sh
    ...

重点介绍：

• 此文件触发条件包括push和pull request事件到master分支，确保代码变动时自动触发构建。
• 实际编译操作由脚本download.sh和build.sh执行，它们负责下载源码和执行编译过程。

3. 项目的配置文件介绍

config/packages.lua

• 这个文件是定制软件包的关键，允许用户添加或删除OpenWrt构建过程中要包含的软件包。

config/targets.mk

• 定义了目标硬件平台和编译配置，确保编译出适用于指定硬件的固件映像。

配置这些文件可以让最终的OpenWrt映像符合个性化需求，例如增加对额外服务的支持或适配特定路由器型号。

---

此指南旨在提供一个快速入门的框架，实际使用时，深入了解每一步骤和文件的具体作用，将使您的自定义固件开发之旅更加顺畅。