OpenWrt 编译步骤
前言
本文转载自 P3TERX 大佬的文章: https://p3terx.com/archives/openwrt-compilation-steps-and-commands.html
这里稍作修改作为记录。
首次编译
克隆 OpenWrt 源码
git clone https://github.com/coolsnowwolf/lede.git openwrt
这里以 Lean 大佬的源码仓库为例子,毕竟很多人都在用它。命令末尾加了
openwrt
是指克隆代码到openwrt
目录,目的是为了规范化,因为有时并不是编译这个的源码。
进入源码目录
cd openwrt
如果要下载额外的软件包,先进入
package
目录git clone
避免 feeds 较大修改后更新无效
./scripts/feeds clean
下载 feeds 源中的软件包源码
./scripts/feeds update -a
feeds 是扩展的软件包,独立于 OpenWrt 源码之外,所以需要单独进行拉取和更新。
安装 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 {} \;
此命令可以列出下载不完整的文件(根据我多次编译的经验得出小于1k的文件属于下载不完整),如果存在这样的文件可以使用
find dl -size -1024c -exec rm -f {} \;
命令将它们删除,然后重新执行make download
下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
开始编译
WSL 编译时需要先执行此命令
source /etc/environment
make -j1 V=s
-j1
: 使用单线程编译。新手推荐单线程编译,一是因为玄学问题可能成功率高,二是方便查看错误日志。
V=s
: 输出详细日志,用于编译失败时找出错误。而且满屏代码在跑能装逼,一跑就是几个小时,装逼更持久。
再次编译
进入源码目录(如果不在此目录)
cd openwrt
如果要下载额外的软件包,先进入
package
目录git clone
更新
TIPS:短期内再次编译可忽略更新这个步骤。
更新系统软件包
sudo sh -c "apt update && apt upgrade -y"
主要作用是更新在编译环境搭建时所安装的编译组件
拉取 OpenWrt 源码更新
git pull
避免 feeds 较大修改后更新无效
./scripts/feeds clean
更新 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
下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
开始编译
WSL 编译时需要先执行此命令
source /etc/environment
make -j$(nproc) || make -j$(nproc) || make -j1 || make -j1 V=s
两次多线程编译失败后自动进入单线程编译,失败则输出详细日志。
调整 OpenWrt 系统组件
Target Images —> 去掉 Build VMware image files (VMDK)
Target Images —> GZip images
Target Images —> Kernel partition size (in MB) 改为 256
Target Images —> Root filesystem partition size (in MB) 改为 512
Extra packages —> ipv6helper # 支持 IPV6
LuCI —> Themes —> luci-theme-argon
LuCI —> Applications —> 取消 luci-app-dockerman
LuCI —> Applications —> luci-app-frpc
LuCI —> Applications —> luci-app-netdata
LuCI —> Applications —> luci-app-passxxxx
LuCI —> Applications —> luci-app-passxxxx —> Configuration # 除 Vxxxy 与 Shxxxxxxxks Rust Client 之外全部勾选
LuCI —> Applications —> luci-app-sqm
LuCI —> Applications —> luci-app-ttyd
LuCI —> Applications —> luci-app-turboacc —> 全部勾选
LuCI —> Applications —> luci-app-wrtbwmon