编译 OpenWrt 固件 - Lean大源码

官方源：https://openwrt.org/
Lean 源：https://github.com/coolsnowwolf/lede
Lienol 源：https://github.com/Lienol/openwrt
immortalwrt 源：https://github.com/immortalwrt/immortalwrt

以下教程使用Lean源

环境搭建

安装 Ubuntu 20.04 LTS x64

下载镜像 使用虚拟机安装20.04
不要用 root 用户进行编译

源码下载

• 下载源代码并进入目录

git clone https://github.com/coolsnowwolf/lede openwrt
cd lede

命令末尾加了openwrt是指克隆代码到openwrt目录，目的是为了规范化，因为有时并不是编译这个的源码。

添加部分插件源

以下方式二选一

• 添加 feeds 方式：打开 feeds.conf.default文件添加

src-git helloworld https://github.com/fw876/helloworld

除了 helloword 还可以选择其他插件
# openwrt 常用软件包，包含passwall、ssr plus
src-git kenzo https://github.com/kenzok8/openwrt-packages
src-git small https://github.com/kenzok8/small # passwall 基本依赖

• 下载仓库方式：
  直接clone到package/lean/目录下

git clone https://github.com/fw876/helloworld.git package/lean/luci-app-helloworld

两种方式区别：下载仓库方式只用来编译，添加 feeds 方式还会把链接放到路由器的 "软件包" "软件源" 里。

首次编译

更新并安装 feed

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

调整 Open­Wrt 系统组件

make menuconfig

预下载编译所需的软件包

make download -j8

-j8是指使用8个线程下载，理论上是数字越大下载越快，但似乎有个上限，实测5线程以上其实速度相差不了多少，在网络好的情况下，基本在5分钟以内能下载完。

检查文件完整性

find dl -size -1024c -exec ls -l {} \;

检查文件完整性命令可以列出下载不完整的文件，小于1k的文件属于下载不完整，如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除，然后重新执行make download下载并反复检查，确认所有文件完整可大大提高编译成功率，避免浪费时间。

开始编译

make V=s -j1

编译完成后输出路径：bin/targets

再次编译

更新

• 更新系统软件包

sudo sh -c "apt update && apt upgrade -y"

主要作用是更新在编译环境搭建时所安装的编译组件

• 拉取 Open­Wrt 源码更新

git pull

• 更新 feeds 源中的软件包源码并安装 feeds 中的软件包

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

文件清理

• 清除旧的编译产物（可选）

make clean

在源码有大规模更新或者内核更新后执行，以保证编译质量。此操作会删除/bin和/build_dir目录中的文件。

• 清除旧的编译产物、交叉编译工具及工具链等目录（可选）

make dirclean

更换架构编译前必须执行。此操作会删除/bin和/build_dir目录的中的文件(make clean)以及/staging_dir、/toolchain、/tmp和/logs中的文件。

• 还原 Open­Wrt 源码到初始状态（可选）

git clean -xdf

如果把源码改坏了，或者长时间没有进行编译时使用。

• 清除临时文件

rm -rf tmp

删除执行make menuconfig后产生的一些临时文件，包括一些软件包的检索信息，删除后会重新加载package目录下的软件包。若不删除会导致一些新加入的软件包不显示。

• 删除编译配置文件

rm -f .config

在不删除的情况下如果取消选择某些组件它的依赖组件不会自动取消，所以对于需要调整组件的情况下建议删除。

编译

• 同首次编译

make menuconfig
make download -j8 V=s
find dl -size -1024c -exec ls -l {} \;
make -j$(nproc) || make -j1 || make -j1 V=s

多线程编译失败后自动进入单线程编译，失败则输出详细日志。

其他

.config文件处理

• 创建差异文件:

./scripts/diffconfig.sh > diff.config

• 使用差异文件,扩展为完整的配置

cp diff.config .config
make defconfig

GitHub 在线编译

参考：
https://p3terx.com/archives/build-openwrt-with-github-actions.html
https://github.com/esirplayground/AutoBuild-OpenWrt

说明：

1. 默认情况下触发编译工作流程有两种方式，发布 release 和修改 .config 文件，所以无论是点发布还是修改 .config 都会自动开始编译。当发现仓库源码有更新时，在 releases 页面发布一个版本就会触发编译的工作流程，使用最新源码进行编译最新固件了。
2. 本方法实际上就是将前面的步骤在本地电脑进行，到最后一步编译命令 make V=s 时交给了 GitHub 自动操作，适合网络问题多的情况，后续更新编译也方便。可以看参考文章自定义更多内容。

参考资料
https://p3terx.com/archives/openwrt-compilation-steps-and-commands.html
https://post.smzdm.com/p/ad27vkgn/
https://www.mianao.info/2020/05/05/%E7%BC%96%E8%AF%91%E6%9B%B4%E6%96%B0OpenWrt-PassWall%E5%92%8CSSR-plus%E6%8F%92%E4%BB%B6
https://www.right.com.cn/forum/thread-4039245-1-1.html