OpenWrt 编译备忘

2019年11月6日 3812点热度 0人点赞 0条评论

前言


编译 Open­Wrt 的过程就像是复读机,除了选择系统组件外,几乎每次编译都是复制粘贴相同的命令。而理解每一条命令的作用、什么时候该去执行,这样才能更好的去解决编译中遇到的问题,更顺利的编译出固件。
这里使用LEAN的OpenWrt的固件进行编译说明。作者的Github地址:https://github.com/coolsnowwolf/lede

准备工作

一、装好 Ubuntu 64bit,推荐 Ubuntu 18 LTS x64。

注意:

1. 不要用 root 用户 git 和编译
2. 国内用户编译前最好准备好梯子
3. 默认登陆IP 192.168.1.1, 密码 password

二、安装必备组件

命令行输入

sudo apt-get update

然后输入

sudo apt-get -y install build-essential asciidoc binutils bzip2 gawk gettext git libncurses5-dev libz-dev patch python3.5 unzip zlib1g-dev lib32gcc1 libc6-dev-i386 subversion flex uglifyjs git-core gcc-multilib p7zip p7zip-full msmtp libssl-dev texinfo libglib2.0-dev xmlto qemu-utils upx libelf-dev autoconf automake libtool autopoint device-tree-compiler g++-multilib antlr3 gperf

开始编译

首次编译

下载 Open­Wrt 源码(这里使用的是 Lean 的源码)

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

进入源码目录

cd lede

拉取 feeds 源码

./scripts/feeds update -a

feeds 是扩展的软件包,独立于 Open­Wrt 源码之外,所以需要单独进行拉取和更新。

安装 feeds 中的软件包

./scripts/feeds install -a

调整 Open­Wrt 系统组件

make menuconfig

首次编译建议只选择架构,其它都不要动,这样编译成功率会更高。如果不打算调整组件则输入make defconfig,它会检测编译环境并生成默认的编译配置文件。

预下载编译所需的软件包

make download V=s -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

V=s:输出详细日志,用于编译失败时找出错误。
-j1:使用单线程编译(首次编译单线程成功率更高),其实不写也行,会自动选择线程

再次编译

更新系统软件包

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

主要作用是更新在编译环境搭建时所安装的编译组件,短期内再次编译可忽略更新这个步骤。

拉取 Open­Wrt 源码更新

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中的文件。

清除 Open­Wrt 源码以外的文件(可选)

make distclean

除非是做开发,并打算 push 到 GitHub 这样的远程仓库,否则几乎用不到。此操作相当于make dirclean外加删除/dl/feeds目录和.config文件。

清除编译缓存

rm -rf tmp

删除配置文件(可选)

rm -f .config

可以理解为恢复默认配置,建议切换架构编译前执行。

调整 Open­Wrt 系统组件

make menuconfig

如果不打算调整组件则输入make defconfig,它会检测编译环境并根据更新自动调整编译配置文件。

预下载编译所需的软件包

make download V=s -j8

开始编译

make V=s -j$(nproc)

-j$(nproc):自动获取CPU线程数,采用多线程编译。成功编译后的再次编译且没有进行make clean操作时使用。

进阶说明

修改源码编译自定义路由器系统

修改主机名、设定时区、IP地址

打开/package/base-files/files/bin/config_generate文件,修改如下

generate_static_system() {
uci -q batch <<-EOF
delete system.@system[0]
add system system
set system.@system[-1].hostname='LEDE'#修改主机名
set system.@system[-1].timezone='Asia/Shanghai'#修改默认时区
lan) ipad=${ipaddr:-"192.168.1.1"} ;;#修改默认IP

修改SSH/TELNET显示信息
打开修改 /package/base-files/files/etc/banner 文件

安装OpenWrt系统

1、全新安装
制作PE启动U盘,并将固件镜像、写盘工具一并放入U盘,在路由上使用U盘启动,在PE系统中通过写盘工具将固件镜像写到软路由。也可以通过写盘软件直接把固件写到U盘,通过U盘启动OpenWrt系统。

PE盘推荐“微PE”,写盘工具推荐"DiskImage"、“Rufus”

2、DD命令快速重装
将固件镜像重命名为op.img,上传到/tmp/upload/,输入下面的命令。该命令会让原系统所有配置丢失,如果只是升级固件,在web后台保留配置升级即可。

dd if=/tmp/upload/op.img of=/dev/sda

每次重装都可以通过PE上写盘,但这样比软繁琐,如果已有一个OpenWrt系统,需要重新刷机就可以用这个方法。

信仰飘扬

行尽天涯 静默山水间