使用 GitHub Actions 云编译 OpenWrt

共计 5296 个字符，预计需要花费 14 分钟才能阅读完成。

提醒：本文最后更新于2021-11-01 13:20，文中所关联的信息可能已发生改变，请知悉！

前言

Github Ac­tions 是 GitHub 推出的持续集成 (Con­tin­u­ous in­te­gra­tion，简称 CI) 服务，它提供了配置非常不错的虚拟服务器环境（E5 2vCPU/​7G RAM），基于它可以进行构建、测试、打包、部署项目。对于公共仓库可免费无时间限制的使用（指累积时间），不过要使用它首先需要知道如何编写 workflow 文件。但这篇文章并不是教你如何枯燥的去编写 work­flow 文件，而是教你如何去使用博主已经编写好的 Open­Wrt 编译方案。

教程更新

• 2020-02-01 新图文教程
• 2019-12-10 新增 macOS 编译方案使用说明
• 2019-12-06 添加 tmate 网页终端链接说明
• 2019-12-05 优化基础使用教程，添加 @lietxia 大佬的图文教程链接
• 2019-12-04 新增云menuconfig使用方法
• 2019-12-03 新增并发编译使用方法
• 2019-11-30 新增自定义源码编译使用方法
• 2019-11-14 全网独家首发

方案特点

• 免费
• 一键快速编译
• 定时自动编译
• 客制化编译
• 并发编译（可同时进行20+5个编译任务）
• 无需搭建编译环境（在线make menuconfig生成配置文件)
• 无需消耗自己的计算机与服务器的计算资源（性感E5在线编译）
• 无需担心磁盘空间不足（近60G磁盘空间）
• 无需使用清理文件（内核更新不怕 boom ）
• 编译速度快（编译时间1-2小时）
• 编译成功率提升200%（万兆自由网络环境）
• 全新环境（杜绝编译环境不干净导致编译失败）

本解决方案是一个开放平台，任何人都可以基于此打造自己专属的编译方案。

项目地址

https://github.com/P3TERX/Actions-OpenWrt

支持项目请随手点个 star，让更多的人发现、使用并受益。

准备工作

• 注册 GitHub 账号
• 搭建编译环境，用于生成.config文件。(可选)

TIPS: 关于编译环境的搭建，推荐去看我之前写的相关文章，Win­dows 10 可以使用 WSL ，ma­cOS、Linux 可以使用 Docker 。

基础使用

首先你必须要熟悉整个 Open­Wrt 的编译过程，这会让你非常容易的理解如何使用 GitHub Ac­tions 进行编译，即使你没有成功过。因为实际上本地编译近 90% 失败的原因是因为网络问题导致的，中国大陆特色，咱也不敢多说。而使用 GitHub Ac­tions 编译成功率至少提升 200% ，为什么这样说呢？因为 Ac­tions 服务器由 Mi­crosoft Azure 提供，在自由的美利坚，拥有万兆带宽。

首次编译

• 在自己搭建编译环境中使用 Lean’s OpenWrt 源码生成.config文件。（或使用后面进阶玩法中的云menuconfig，直接 SSH 到 Actions 进行操作）

TIPS: 方案默认引用 Lean 的源码，因为他的 README 影响了我开始学习编译，也就有了这个项目，而且他的源码非常的优秀。有其它需求可自行修改 work­flow 文件，方法后面的进阶使用中有说明。

• 进入 P3TERX/Actions-OpenWrt 项目页面，点击页面中的 Use this template （使用这个模版）按钮。

• 填写仓库名称，然后点击Create repository from template（从模版创建储存库）按钮。

• 经过几秒钟的等待，页面会跳转到新建的仓库，内容和我的项目是相同的。然后点击Create new file（创建新文件）按钮。

• 文件名填写为.config，把生成的.config 文件的内容复制粘贴到下面的文本框中。

• 翻到页面最下方，点击Commit new file（提交新文件）按钮即可。后续编译工作会自动开始，你可以在 Actions 页面进行查看。

• 在等待编译完成的过程中，你可以进入这个页面点击右上角的star，这是对博主最大的支持，而且还可以加快编译速度哦（雾
• 最后经过一两个小时的等待，不出意外你就可以在 Actions 页面看到已经打包好的固件目录压缩包。

TIPS: 如需 ipk 文件可以在进阶使用章节找到方法。因为大多数人只需要固件，而且总是有萌新问固件在哪，所以现在默认只上传固件。

再次编译

默认情况下触发编译有两种方式：

1. 发布 release
2. 修改.config文件

他们分别对应以下使用场景：

• 在编译配置没有修改的情况下，若源码有更新，那么在 releases 页面发布一个 release 将直接使用最新源码进行编译。
• 如果你想修改配置，则生成船新的.config文件 push 到仓库来触发编译的工作流程。

其它触发方式你可以在后面的进阶使用中看到。

进阶使用

自定义环境变量与功能

env:
  REPO_URL: https://github.com/coolsnowwolf/lede
  REPO_BRANCH: master
  CONFIG_FILE: .config
  DIY_SH: diy.sh
  SSH_ACTIONS: false
  UPLOAD_BIN_DIR: false
  UPLOAD_FIRMWARE: true
  TZ: Asia/Shanghai

git clone https://github.com/P3TERX/xxx package/xxx

./scripts/feeds update -a
./scripts/feeds install -a

#  schedule:
#    - cron: 0 8 * * 5

#  watch:
#    types: [started]

jobs:
  build:
    runs-on: ubuntu-latest
    if: github.event.repository.owner.id == github.event.sender.id

REPO_URL: https://github.com/coolsnowwolf/lede
REPO_BRANCH: master

REPO_URL: https://github.com/openwrt/openwrt
REPO_BRANCH: openwrt-19.07