OpenWrt 编译步骤与命令详解教程

前言

编译 OpenWrt 的过程就像是复读机，除了选择系统组件外，几乎每次编译都是复制粘贴相同的命令。而理解每一条命令的作用、什么时候该去执行，这样才能更好的去解决编译中遇到的问题，更顺利的编译出固件。

首次编译

克隆OpenWrt源码：
- Lean大的源码：
git clone https://github.com/coolsnowwolf/lede openwrt
- Lienol的源码：
git https://github.com/Lienol/openwrt openwrt

二位大佬的源码各有优缺点，lean大的更偏向于原版，lienol的UI细节做了优化。拉取源码，二选一
进入源码目录：

cd openwrt
下载feeds源中的软件包源码：

./scripts/feeds update -a
feeds 是扩展的软件包，独立于 OpenWrt 源码之外，所以需要单独进行拉取和更新。

由于国内网络政策的原因，两位大佬的源码中均不包含魔法上网的插件地址，这里补充：
- ```
src-git opentopd  https://github.com/sirpdboy/sirpdboy-package
```
- ```
src-git helloworld https://github.com/fw876/helloworld
```
- ```
src-git passwall https://github.com/xiaorouji/openwrt-passwall
```
- ```
src-git OpenClash https://github.com/vernesong/OpenClash
```
- ```
src-git lienol https://github.com/Lienol/openwrt-package
```
  以上几个feeds源地址，添加到openwrt源码文件夹下的feeds.conf.default文件中即可。
安装feeds中的软件包：

./scripts/feeds install -a
调整OpenWrt系统组件：

make menuconfig

这个命令运行后，会弹出一个图形交互界面，我们个性化编译自己的固件，就是在这里调整各个插件是否编译进固件中。如果不调整组件，则输入make defconfig，它会检测编译环境并生成默认的编译配置文件
预下载编译所需的软件包
```
make download -j8 V=s
```
-j8是指使用8个线程下载，理论上是数字越大下载越快，但似乎有个上限，实测5线程以上其实速度相差不了多少，在网络好的情况下，基本在5分钟以内能下载完。
检查文件完整性
```
find dl -size -1024c -exec ls -l {} \;
```
此命令可以列出下载不完整的文件（可多次运行上一步的预下载命令），如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除，然后重新执行make download下载并反复检查，确认所有文件完整可大大提高编译成功率，避免浪费时间。
开始编译
```
make -j1 V=s
```
-j1：使用单线程编译。新手推荐单线程编译，一是因为玄学问题可能成功率高，二是方便查看错误日志。

V=s：输出详细日志，用于编译失败时找出错误。而且满屏代码在跑能装逼，一跑就是几个小时，装逼更持久。

如果你使用WSL或WSL2进行编译：

由于wsl的PATH路径中包含带有空格的Windows路径，有可能会导致编译失败，请在将make -j1 V=s或make -j$(($(nproc) + 1)) V=s改为

首次编译：
```
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin make -j1 V=s 
```
二次编译：
```
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin make -j$(($(nproc) + 1)) V=s
```
编译后获取img文件：

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

二次编译：

更新

进入到源码目录（如果不在此目录）

cd openwrt
更新系统软件包
```
sudo sh -c "apt update && apt upgrade -y"
```
主要作用是更新在编译环境搭建时所安装的编译组件
拉取 OpenWrt 源码更新
```
git pull
```
更新 feeds 源中的软件包源码
```
./scripts/feeds update -a
```
安装 feeds 中的软件包
```
./scripts/feeds install -a
```

文件清理：

清除旧的编译产物（可选）
```
make clean
```
在源码有大规模更新或者内核更新后执行，以保证编译质量。此操作会删除/bin和/build_dir目录中的文件。
清除旧的编译产物、交叉编译工具及工具链等目录（可选）
```
make dirclean
```
更换架构编译前必须执行。此操作会删除/bin和/build_dir目录的中的文件(make clean)以及/staging_dir、/toolchain、/tmp和/logs中的文件。
清除 OpenWrt 源码以外的文件（可选）
```
make distclean
```
除非是做开发，并打算 push 到 GitHub 这样的远程仓库，否则几乎用不到。此操作相当于make dirclean外加删除/dl、/feeds目录和.config文件。
还原 OpenWrt 源码到初始状态（可选）
```
git clean -xdf
```
如果把源码改坏了，或者长时间没有进行编译时使用。
清除临时文件
```
rm -rf tmp
```
删除执行make menuconfig后产生的一些临时文件，包括一些软件包的检索信息，删除后会重新加载package目录下的软件包。若不删除会导致一些新加入的软件包不显示。
删除编译配置文件
```
rm -f .config
```
在不删除的情况下如果取消选择某些组件它的依赖组件不会自动取消，所以对于需要调整组件的情况下建议删除。

编译：

调整 OpenWrt 系统组件
```
make menuconfig
```
如果不打算调整组件则输入make defconfig，它会检测编译环境并根据更新自动调整编译配置文件。
预下载编译所需的软件包
```
make download -j8 V=s
```
检查文件完整性
```
find dl -size -1024c -exec ls -l {} \;
```
此命令可以列出下载不完整的文件（根据我多次编译的经验得出小于1k的文件属于下载不完整），如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除，然后重新执行make download下载并反复检查，确认所有文件完整可大大提高编译成功率，避免浪费时间。
开始编译
```
make -j$(nproc) || make -j1 || make -j1 V=s
```
多线程编译失败后自动进入单线程编译，失败则输出详细日志。

menuconfig

如何选到你的设备，例如R2S、X86_64、ACRH17这些设备怎么选到?选好设备后，接下来几个你可能刚需的设置点：

Extra Packages > autocore、autosamba、automount、ipv6helper
无论软硬路由都可勾选了，没坏处。
Network > Firewall > ip6tables > ip6tables-extra、ip6tables-mod-nat
都勾了。
LuCI > Themes >
一般不建议勾选bootstrap之外的主题。
LuCI > Applications >
MTK MIPS架构的几个K2P、新三什么的必选mtwifi否则没无线信号,如果没看到mtwifi选项那就无所谓了，可能大雕调整了mtwifi的位置并且默认选上了，你不用操心了。
其他的软路由无需操心wifi驱动。
- 硬路由一般爬墙插件类只勾选ssrplus : ssr client + xray (xray兼容v2ray、trojan、ss，硬路由勾选ssrp下面这两个就够用了，再多K2P一定超空间出不来固件)
- 其他的爬墙插件则不建议为硬路由勾选。还有一些adbyby plus什么的几把玩意就别为硬路由勾选了,软路由也没必要勾选，去广告本来就不可避免有误伤。
- 软路由就无脑ssrp全勾+passwall全勾+openclash全勾+其他你知道的用过的一些什么各种文件服务器、VPN服务端、qos、TTYD、CPU频率调节、uu加速器……眼熟的都可以选，不熟的别选。

前言

首次编译

二次编译：

更新

文件清理：

编译：

menuconfig

Jackeroo 钻石