前言

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

教程更新

关注 GitHub Actions Channel 获得最新情报

• 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小时）
• 全新环境（杜绝编译环境不干净导致编译失败）

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

项目地址

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

喜欢的小伙伴请点击star哦~

准备工作

• 注册 GitHub 账号并开启 GitHub Actions 使用权限
• 搭建编译环境，用于生成.config文件。(可选)

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

基础使用

默认配置编译

难度： ⭐

门槛： 基础计算机技能

使用L大钦定的配置进行编译，默认是 x86_64 平台。如果你刚好在使用软路由又懒得折腾，那么这是最好的选择。紧跟L大的步伐，随时随地进行编译。

TIPS: 默认引用L大的源码，有其它需求可自行修改 workflow 文件，方法后面的进阶使用中有说明。

• fork 这个仓库
• 在 releases 页面发布一个 release 编译工作就会自动开始，在 Actions 页面可以查看编译进度。
• 进入这个页面，点击右上角的star按钮可加快编译速度和成功率（大雾
• 编译完成点击 Actions 页面右上角的Artifacts按钮下载固件。

基础客制化编译

难度： ⭐️⭐️⭐️

门槛：

• Linux 与 Git 基础知识
• 一次纯手工编译 OpenWrt 成功的经历

如果你不满足于默认的配置或者想编译其它平台的固件，那么就开始你的客制化之旅吧。

• fork 这个仓库
• 在自己搭建编译环境中使用 Lean's OpenWrt 源码生成.config文件。（或使用后面进阶玩法中的云menuconfig，直接 SSH 到 Actions 进行操作）
• 把生成好的.config文件本地仓库根目录，然后 push 到 GitHub 远程仓库编译工作就会自动开始，在 Actions 页面可以查看编译进度。
• 进入这个页面，点击右上角的star按钮可加快编译速度和成功率（大雾
• 编译完成点击 Actions 页面右上角的Artifacts按钮下载固件。

如果不明白我在说什么，那么推荐去看 @lietxia 大佬写的图文并茂的教程。

再次编译

难度： ⭐️⭐️⭐️⭐️

门槛：

• Linux 与 Git 基础知识
• 一次纯手工编译 OpenWrt 成功的经历
• 小学语文、英语90分

当看见源码有更新，在 releases 页面发布一个 release 直接将直接使用最新源码进行编译。

TIPS: 如果你嫌发 release 麻烦，那么可以根据后面的进阶玩法开启真·一键编译。

此时如果你想修改配置，那么还是生成.config文件并 push 到仓库触发编译的工作流程。

进阶使用

难度： ⭐️⭐️⭐️⭐️️⭐️

门槛： ∞

DIY 脚本

仓库内有一个diy.sh文件，你可以把对源码修改的指令写到这个文件中，比如修改默认IP、主机名、主题、添加/删除软件包等操作。但不仅限于这些操作，发挥你强大的想象力，可做出更强大的功能。

TIPS: 脚本工作目录在源码目录，内附一个修改默认 IP 的例子供参考使用。

添加软件包

在 DIY 脚本中加入对指定软件包的远程仓库的克隆指令。就像下面这样：

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

这样做的好处是每一次编译都会拉取最新的源码。

TIPS: 生成.config文件时记得选中相应的软件。如果添加的软件包与 OpenWrt 中已有的软件包同名的情况，则需要把源码中的同名软件包删除，否则会优先编译 OpenWrt 中的软件包。这同样可以利用到的 DIY 脚本。

Custom files（自定义文件）

俗称“files 大法”，在仓库根目录下新建files目录，把文件放入即可。

定时自动编译

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

真·一键编译

点击自己仓库页面上的 Star 开始编译，为了防止被滥用，这个功能默认没有开启。开启后如果被恶意点击轻则封号，严重可能会导致中美关系恶化、原子弹爆炸、第三次世界大战等后果。（大雾

#  watch:
#    types: [started]

自定义源码编译

此方案默认引用的是L大的源码，如果你觉得不好用或者有编译其它源码的需求可以进行替换，自由是本解决方案最大的特点。

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

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

并发编译

基于 GitHub Actions 可同时运行多个工作流程的特性，最多可以同时进行至少20个编译任务。也可以单独选择其中一个进行编译，这充分的利用到了 GitHub Actions 为每个账户免费提供的20个 Ubuntu 虚拟服务器环境。此外你还可以额外再使用5个 macOS 虚拟服务器环境进行编译，开启方法在后面有说明。

...
    paths:
      - '.config'
...
        CONFIG_FILE: '.config'
        DIY_SH: 'diy.sh'
...

云 menuconfig（SSH 连接到 Actions）

通过 tmate 连接到 GitHub Actions 虚拟服务器环境，可直接进行make menuconfig操作生成编译配置，或者任意的客制化操作。也就是说，你不需要再自己搭建编译环境了。这可能改变之前所有使用 GitHub Actions 的编译 OpenWrt 方式。

#    - name: SSH connection to Actions
#      uses: p3terx/debugger-action@master

To connect to this session copy-n-paste the following into a terminal or browser:

ssh Y26QeagDtsPXp2mT6me5cnMRd@nyc1.tmate.io

https://tmate.io/t/Y26QeagDtsPXp2mT6me5cnMRd

macOS 虚拟机编译

GitHub Actions 的 macOS 虚拟机性能要高于 Ubuntu 虚拟机，所以使用它编译 OpenWrt 理论上速度会更快。博主经过几天时间的研究已经总结出了 macOS 下的 OpenWrt 编译环境的搭建方法，并编写出了适用于 macOS 虚拟环境的 OpenWrt 编译方案的 workflow 文件。

on: 
  public
#  release:
#    types: [published]
#  push:
#    branches: 
#      - master
#    paths:
#      - '.config'
#  schedule:
#    - cron: 0 8 * * 5
#  watch:
#    types: [started]

尾巴

希望大家不要滥用免费的开发资源，需要时再编译，让开发者来充分利用才能产生更多更好的软件，这样大家才能受益。

相关 TG 群组：GitHub Actions Group

欢迎订阅我的 TG 频道，接收最新的文章推送和有趣的内容。加入 TG 群组，和小伙伴们一同交流、学习、成♂长。

本文作者：P3TERX

本文链接：https://p3terx.com/archives/build-openwrt-with-github-actions.html

版权声明：本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。非商业转载及引用请注明出处（作者、原文链接），商业转载请联系作者获得授权。