OpenWrt 固件编译教程

奶爸程序员 2025-01-17 原文

一、编译环境准备

编译平台阿里云 Ubuntu 20.04.5 LTS

安装编译环境依赖

sudo apt-get -y install build-essential asciidoc binutils bzip2 gawk gettext git libncurses5-dev libz-dev patch python3 python2.7 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 wget curl swig rsync

更新本地软件包

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

不推荐使用 root 用户进行编译，所以先使用 root 权限创建一个用户，以创建 gaven 用户为例

# 添加用户
adduser gaven

为新用户设置密码，根据个人情况，这里设置“123456”

passwd 123456

从 root 用户切换使用新用户

su gaven

从此刻开始，以非 root 用户执行编译过程的所有操作。

二、首次编译步骤

重要的事情说三遍，不要使用root用户！！！

拉取代码，这里拉取的代码是LEDE

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

添加自定义源（可选项），这里只是告诉一种方式和方法

注：以下是自己正在使用的软件源，这里你也可以换成自己喜欢的软件源

# 进入openwrt目录
cd ~/openwrt

# 添加自定义源
cat >> feeds.conf.default <<EOF
src-git kenzo https://github.com/kenzok8/openwrt-packages
src-git passwall https://github.com/xiaorouji/openwrt-passwall
EOF

更新下载软件仓库的源码到本地，并安装自定义源包含的软件包

./scripts/feeds update -a

这个过程可能会因为国内网路的原因会失败，多试几次，尽量保证别出现错误。如果有些代码源确实无法实现下载更新操作，原因是因为github的DNS系统解析不了，这里可以通过一些方式查询githhub的地址，进行手动配置

查询github的IP地址

GitHub: Let's build from here · GitHub 通过此网站便可以查询到。

配置/etc/hosts ，在结尾处写上。
140.82.114.3 github.com
140.82.114.3 www.github.com

然后执行

ping github.com 是否能够ping通，能够ping通，说明可以进行代码更新了。

测试结果示例

继续执行更新操作，是否能够成功？

./scripts/feeds update -a

进行拉取代取的安装操作

./scripts/feeds install -a

单独添加软件包（可选项）

如果需要单独添加软件，请拉取源码到 package 目录之下。示例如下：

# 添加 OpenAppFilter 应用过滤插件
git clone https://github.com/destan19/OpenAppFilter package/OpenAppFilter

设置默认主题（可选项）

注：此操作请在编译前执行，设置 argon 为默认主题，以此为例举一反三

# 删除自定义源默认的 argon 主题
rm -rf package/lean/luci-theme-argon

# 部分第三方源自带 argon 主题，上面命令删除不掉的请运行下面命令
find ./ -name luci-theme-argon | xargs rm -rf;

# 针对 LEDE 项目拉取 argon 原作者的源码
git clone -b 18.06 https://github.com/jerrykuku/luci-theme-argon.git package/lean/luci-theme-argon

# 替换默认主题为 luci-theme-argon
sed -i 's/luci-theme-bootstrap/luci-theme-argon/' feeds/luci/collections/luci/Makefile

设置路由器默认的 LAN IP（可选项）

注：此操作请在编译前执行

# 设置默认IP为 192.168.199.1
sed -i 's/192.168.1.1/192.168.199.1/g' package/base-files/files/bin/config_generate

仅制作.config文件，无需本地编译固件（可选项）

根据自己的定制需求，调整系统组件

make menuconfig

通过以下命令行获得 seed.config 配置文件，然后使用 GitHub Actions 云编译。

# 若在调整OpenWrt系统组件的过程有多次保存操作，则建议先删除.config.old文件再继续操作
rm -f .config.old

# 根据编译环境生成默认配置
make defconfig

# 对比默认配置的差异部分生成配置文件（可以理解为增量）
./scripts/diffconfig.sh > seed.config

若需要编译固件

根据自己的定制需求，调整系统组件

make menuconfig

下载编译所需的软件包

make download -j8 V=s

编译 OpenWrt 固件

# -j1：单线程编译
make -j1 V=s

单线程编译可提高编译成功率，但过程非常漫长，也完全取决于机器的性能。编译完成后固件输出路径： /openwrt/bin/targets/ 之下。

三、二次编译步骤

不要使用 root 用户！

更新本地编译环境

# 更新软件列表、升级软件包
sudo sh -c "apt update && apt upgrade -y"

# 拉取最新源码
cd ~/openwrt && git pull

# 更新下载安装订阅源包含的软件包
cd ~/openwrt
./scripts/feeds update -a && ./scripts/feeds install -a

清理旧文件

# 删除/bin和/build_dir目录中的文件
make clean

如果要更换架构，例如要从 x86_64 换到 MediaTek Ralink MIPS 建议执行以下命令深度清理 /bin 和 /build_dir 目录的中的文件 (make clean) 以及 /staging_dir、/toolchain、/tmp 和 /logs 中的文件。

make dirclean

如果需要对组件重新调整，则建议先删除旧配置

rm -rf ./tmp && rm -rf .config

根据自己的定制需求，再次调整 OpenWrt 系统组件

make menuconfig