OpenWrt 编译步骤与命令详解

请注意,本文编写于 256 天前,最后修改于 62 天前,其中某些信息可能已经过时。

前言

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

首次编译

  • 克隆 OpenWrt 源码

    git clone https://github.com/coolsnowwolf/lede openwrt
    这里以 Lean 大佬的源码仓库为例子,毕竟很多人都在用它。命令末尾加了openwrt是指克隆代码到openwrt目录,目的是为了规范化,因为有时并不是编译这个的源码。
  • 进入源码目录

    cd openwrt
  • 下载 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下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
  • 开始编译

    make -j1 V=s
    -j1:使用单线程编译。新手推荐单线程编译,一是因为玄学问题可能成功率高,二是方便查看错误日志。

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

再次编译

  • 进入源码目录(如果不在此目录)

    cd openwrt

更新

TIPS: 短期内再次编译可忽略更新这个步骤。
  • 更新系统软件包

    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
    多线程编译失败后自动进入单线程编译,失败则输出详细日志。

尾巴

很少有人会告诉你为什么要这样做,而是会要求你必须要这样做。


更多 OpenWrt 相关文章点这里

本博客已开设 Telegram 频道,欢迎小伙伴们订阅关注。

添加新评论

已有 26 条评论

ubuntu18,新建了一个新用户test,su test后变成test@ubuntu:/root$,造成权限不足,请问能不能把test@ubuntu:/root$变成test@ubuntu:~$,大神们看看是什么原因

切换用户的时候要用su - test,这样才能切到新用户的家目录下,不然会停留在root用户的家目录下。如果已经切换了执行cd命令即可切换到当前用户的家目录。多学习下 Linux 基本操作,这些都不是问题。

bluefox bluefox 回复 @P3TERX
1 0

谢谢大神指导。看了你的网站学到了很多编译方面的知识

bluefox bluefox 回复 @bluefox
0 0

在feeds.conf.default中
src-git helloworld https://github.com/fw876/helloworld
src-git helloworld https://github.com/fw876/helloworld.git
这两种添加ssrplus方法有没有什么区别

对于 git 而言https://github.com/fw876/helloworldhttps://github.com/fw876/helloworld.git是相同的,因为 GitHub 做了重定向,所以没区别。

debug哈,开始编译的指令【make j1 V=s】少了一个【-】,应为【-j1】

P3TERX P3TERX 回复 @夜尽曙明
1 0

感谢提醒,已更正。

谢谢您的教程! 我现在开始用github自己编译的openwrt了:)

不过最近开始编译出来的Openwrt运行的时候总是显示" print_req_error: I/O error, dev loop0, sector xxxxx" . 不知道这是什么原因呢?

网上好像有几个人有类似的错误,不过都没有答案.

谢谢啦

OpenWrt 源码问题,你需要向源码的开发者反馈

请问V可以等于别的吗,比如输出较少的信息。我仅仅需要看到他在动知道it's running就好了

去掉V=s即可

感谢分享,就喜欢看这样的文章,说的清晰透彻,懂了都是什么意思就能灵活运用了

hello
请问我用亚aws弄了个虚拟机,在里面编译,跑了一天也没完,是怎么回事?配置太低了吗?

VPS 的 CPU 、磁盘、内存都是共享的,所以编译时间看缘分。

非常感谢分享,已经成功编译了一次,想请教下问,如果已成功编译arch17,我想再编译r3p的固件,需要先进行make dirclean吗?还是直接 make menuconfig 选择对应的路由器,保存config后,直接编译。

P3TERX P3TERX 回复 @紫晶怪兽
0 0

建议再拉取一份源码进行操作

紫晶怪兽 紫晶怪兽 回复 @P3TERX
0 0

谢谢,我现在合并其他ipk是用gitdesktop克隆到本地在用winscp copy到源目录里,每次编译固件时感觉这样比较麻烦,除了action的方法还有其他方法可以简单些吗?我尝试在fees.defaul.conf那个文件里增加,freed update时报错。

不好意思又来请教了,我的机器是jetson nano的开发板,当年树莓派4还没出,为了千兆网卡和usb3.0才买的。结果是一把辛酸泪,适配的软件太少了,都要自己动手,丰衣足食。
现在想用这个板子做家里的旁路由来跑透明代理,但是装了dockerhub上的几个现成的docker,发现都有问题,本体都是正常的,但是ssr都不正常。

蓝精灵 蓝精灵 回复 @蓝精灵
0 0

我尝试自己调试,发现ssr-local和ssr-redir都能运行起来,socks5代理正常 ,但是透明网关不工作。我自己尝试看了代码,发现是ssr-rules脚本配饰iptables的规则似乎有问题,一条条执行命令,发现提示这个错误,iptables v1.8.2 (legacy): Couldn't load match `set':No such file or directory

蓝精灵 蓝精灵 回复 @蓝精灵
0 0

请问,你知道怎么解决这个问题吗?看样子似乎是iptables缺少模块,但是我用lean大的最新代码编译了iptables的ipk,去openwrt里安装,提示已经是最新版本了。而手动搜索发现也没有类似iptables-mod-set这样的组件

蓝精灵 蓝精灵 回复 @蓝精灵
0 0

我发现我真是一语成谶,这板子的系统贼坑,docker容器的iptables似乎是共享宿主机的iptables的/proc/net/ip_tables_matches,老黄的系统不仅内核老(4.9.140),iptables还没有xt_set模块,还要自己编译  ̄﹃ ̄

P3TERX P3TERX 回复 @蓝精灵
0 1

这就没办法帮到你了,没研究过这些。

find dl -size -1024c -exec rm -f {} ;
运行这条命令会显示
rm: cannot remove 'dl': Is a directory
不能删除

输错了。复制粘贴,不要手打。

前几天尝试编译…然后总会有莫名其妙的错误,十分浪费时间。

我刚开始编译也是一直遇到错误。多多尝试,总会编译成功的。