OpenWrt 固件定制编译
1.修改默认源码的IP地址
我们找到源码的配置文件地址(这里以lede为例) package/base-files/files/bin/config_generate
继续修改主机名
2.修改版本号
我们修改 lede/package/lean/default-settings/files/zzz-default-settings 文件中的 R22.3.1 3 及 OpenWrt 。（注意OpenWrt后面的空格）
3.系统信息内添加编译者信息
我们修改lede/package/lean/autocore/files/arm/index.htm 及 lede/package/lean/autocore/files/x86/index.htm
1 | <tr><td width="33%"><%:Compiler author%></td><td>https://kls.red</td></tr> |
https://www.zhujiwo.cc 部分改成你自己的(不能中文)
继续添加主页天气信息
1 | <tr><td width="10%"><%:weather%></td><td > <iframe width="900" height="120" frameborder="0" scrolling="no" hspace="0" src="//i.tianqi.com/?c=code&a=getcode&id=22&py=jiangxia&icon=1"></iframe> |
代码里面的 py= 后面拼音改成你城市的地区拼音
接下来我们给我们添加的代码添加汉化
我们找到这个配置文件 lede/feeds/luci/modules/luci-base/po/zh-cn/base.po
1 | msgid "Compiler author" |
4.定制个性SSH登陆欢迎信息
我们修改lede/package/basecd-files/files/etc/banner文件，可以到这里定制。http://patorjk.com/software/taag/
这里就看你们自己啦
5.修改默认主题
我们修改 lede/feeds/luci/collections/luci/Makefile 文件更改默认主题
1 | lede/feeds/luci/collections/luci-ssl-nginx/Makefile |
这三个文件都要修改默认主题名字，不然后面编译可能会报错。
恩山论坛上有很多用户编译好的现成固件，自己编译固件最大的优势是可以根据需求更好的自定义，建议没有特别需求的用户还是直接选用现成的固件即可。编译固件也是一种乐趣，整个过程大约1-3小时左右，需要耐心等待。
环境要求
系统版本
Debian 11 或者 Ubuntu LTS
网络要求
最好是境外主机或者能够访问国际网络，大陆网络环境编译失败率较高，配置推荐 2H4G 以上
编译依赖
1
2
3
4
5
6
7
8
9
10
11
12
13# 升级
sudo apt update -y
sudo apt full-upgrade -y
# 安装依赖
sudo apt install -y ack antlr3 aria2 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache cmake cpio curl device-tree-compiler fastjar flex gawk gettext gcc-multilib g++-multilib \
git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libglib2.0-dev libgmp3-dev libltdl-dev \
libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libreadline-dev libssl-dev libtool lrzsz \
mkisofs msmtp nano ninja-build p7zip p7zip-full patch pkgconf python2.7 python3 python3-pip libpython3-dev qemu-utils \
rsync scons squashfs-tools subversion swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev
# 清理
sudo apt autoremove --purge
sudo apt clean
开始编译
新建一个用户，用于编译固件
1
2
3
4
5
6
7
8
9useradd -m openwrt # 新建一个名为 openwrt 的用户
# 修改用户默认的 Shell
apt install -y sudo
usermod -s /bin/bash openwrt
# 切换用户
su openwrt
cd ~拉取源码，这里用的是 Lean 大佬的 LEDE 分支源码
1
2git clone https://github.com/coolsnowwolf/lede
cd lede添加软件源，L大源码里默认有四个软件源里面包含了大部分常用插件，如果要添加其他没有的插件则需要自行添加软件源至
1
feeds.conf.default
1
2
3
4# 添加 small-package源 https://github.com/kenzok8/small-package
sed -i '$a src-git smpackage https://github.com/kenzok8/small-package' feeds.conf.default
# 对于强迫症的同学（有报错信息、或Lean源码编译出错的情况），请尝试删除冲突的插件
rm -rf feeds/smpackage/{base-files,dnsmasq,firewall*,fullconenat,libnftnl,nftables,ppp,opkg,ucl,upx,vsftpd*,miniupnpd-iptables,wireless-regdb}1
2
3
4
5
6
7
8
# 不推荐，好像有问题
# 删除L大的argon主题（)
rm -rf feeds/luci/themes/luci-theme-argon
rm -rf feeds/luci/applications/luci-app-argon-config
# 替换成smpackage的argon
cp feeds/smpackage/luci-theme-argon feeds/luci/themes/luci-theme-argon -r
cp feeds/smpackage/luci-app-argon-config feeds/luci/applications/luci-app-argon-config -r文件，当然也可以单独添加某个插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16vim feeds.conf.default
# 添加软件源（打开下方仓库链接可以查看包含的插件列表，一般选前两个源就行）
src-git kenzo https://github.com/kenzok8/openwrt-packages
src-git small https://github.com/kenzok8/small
src-git haibo https://github.com/haiibo/openwrt-packages
src-git liuran001 https://github.com/liuran001/openwrt-packages
# 单独添加（在更新并安装插件之前执行）
## 插件
git clone https://github.com/esirplayground/luci-app-poweroff.git package/luci-app-poweroff
# 更新并安装插件
./scripts/feeds clean
./scripts/feeds update -a
./scripts/feeds install -a
自定义配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15# 修改默认IP为 192.168.6.1
# LEDE: package/base-files/luci2/bin/config_generate
sed -i 's/192.168.1.1/192.168.6.1/g' package/base-files/files/bin/config_generate
# 修改默认主机名
# OpenWrt package/base-files/files/bin/config_generate
sed -i "s/set system\.@system\[-1\]\.hostname='OpenWrt'/set system\.@system\[-1\]\.hostname='N5105'/" package/base-files/files/bin/config_generate
# sed -i '/uci commit system/i\uci set system.@system[-1].hostname='N5105'' package/base-files/files/bin/config_generate
# 加入编译者信息
# LEDE: package/lean/default-settings/files/zzz-default-settings
sed -i "s/OpenWrt /YuKiFuHaNe build $(TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt /g" package/lean/default-settings/files/zzz-default-settings
# 修改默认主题
sed -i "s/luci-theme-bootstrap/luci-theme-argon-mod/g" feeds/luci/collections/luci/Makefile加入编译者OpenWrt
方法1：修改
include/version.mk（推荐）编辑
include/version.mk文件：1
2
3
4
5
6
7
8# 在文件末尾添加
# 思路
# VERSION_BUILD := $(shell TZ=UTC-8 date "+%Y.%m.%d")
# VERSION_DIST := YuKiFuHaNe build $(VERSION_BUILD) @ OpenWrt
VERSION_DIST:=$(call qstrip,$(CONFIG_VERSION_DIST))
VERSION_DIST:=$(if $(VERSION_DIST),$(VERSION_DIST),YuKiFuHaNe build $(shell TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt)
VERSION_DIST_SANITIZED:=$(call sanitize,$(VERSION_DIST))1
2_BUILD_DATE:=$(shell TZ=Asia/Shanghai date "+%Y.%m.%d")
VERSION_DIST:=$(if $(VERSION_DIST),$(VERSION_DIST),YuKiFuHaNe build $(_BUILD_DATE) @ OpenWrt)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20# 能ping通，但网页无法访问检查是否有开下面选项
LuCI --->
Collections --->
[*] luci
Modules --->
[*] luci-mod-admin-full
[*] luci-base
[*] luci-compat
[*] luci-mod-network
[*] luci-mod-status
[*] luci-mod-system
Network --->
Web Servers --->
[*] uhttpd
[*] uhttpd-mod-ubus
Base system --->
[*] busybox # 确保包含
[*] procd # 确保包含在OpenWrt官方检查中package_verison更严格，不能有“-“和”_“
1
2
3
4
5# 检查所有包的版本号定义
find feeds/smpackage -name "Makefile" -exec grep -H "PKG_VERSION:=" {} \;
# 检查有问题的版本号模式
find feeds/smpackage -name "Makefile" -exec grep -H "PKG_VERSION.*[_-]" {} \;允许的字符：
- 数字
0-9 - 英文点号
. - 连字符/减号
-(但有限制) - 小写字母
a-z(通常用于预发布版本如1.0_beta)
- 数字
不允许的字符：
- 下划线
-❌ (始终不允许) - 空格 ❌
- 特殊符号(
@,#,$等) ❌
- 下划线
特殊注意事项：
使用连字符
-时：- 只能用于连接主版本号和附加信息(如
1.0-rc1) - 不能放在开头或结尾
- 不能连续使用(如
1.0--2023)
- 只能用于连接主版本号和附加信息(如
日期建议放在
PKG_RELEASE而非PKG_VERSION
1
2
3
4
5
6
7
8
9
10
11# 方案1：标准版本 + 构建日期作为release
PKG_VERSION:=1.0.1
PKG_RELEASE:=20230405
# 方案2：带连字符的预发布版本
PKG_VERSION:=1.0.1_beta
PKG_RELEASE:=1
# 方案3：完全标准版
PKG_VERSION:=1.0.1
PKG_RELEASE:=1或者直接修改现有的版本变量：
1
VERSION_DIST := YuKiFuHaNe build $(shell TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt
方法2：修改
package/base-files/files/bin/config_generate在文件末尾的 uci 设置部分添加：
1
2# 在文件末尾的 uci batch 命令中添加
uci set system.@system[0].description='YuKiFuHaNe build $(shell TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt'完整示例：
1
2
3
4
5uci -q batch <<-EOF
set system.@system[0].hostname='OpenWrt'
set system.@system[0].timezone='UTC'
set system.@system[0].description='YuKiFuHaNe build $(shell TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt'
EOF方法3：创建自定义补丁文件
创建
package/base-files/patches/100-add-build-info.patch：1
2
3
4
5
6
7
8--- a/files/bin/config_generate
+++ b/files/bin/config_generate
@@ -XX,6 +XX,7 @@
set system.@system[0].hostname='OpenWrt'
set system.@system[0].timezone='UTC'
set system.@system[0].log_size='64'
+ set system.@system[0].description='YuKiFuHaNe build $(shell TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt'
EOF方法4：修改 banner 文件
编辑
package/base-files/files/etc/banner：1
2
3
4
5
6
7
8_______ ________ __
| |.-----.-----.-----.| | | |.----.| |_
| - || _ | -__| || | | || _|| _|
|_______|| __|_____|__|__||________||__| |____|
|__| W I R E L E S S F R E E D O M
-----------------------------------------------------
YuKiFuHaNe build %C @ OpenWrt, %V
-----------------------------------------------------方法5：在编译命令中指定
1
make CONFIG_VERSION_DIST="YuKiFuHaNe build $(date "+%Y.%m.%d") @ OpenWrt"
1
2
3修改主题argon-mod中登录页面编译者为可点击
sed -i "s/<%= ver.distversion %>/<a href=\"https:\/\/github.com\/YuKiFuHaNe\" target=\"_blank\">YuKiFuHaNe<\/a> build $(TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt/g" feeds/luci/themes/luci-theme-argon-mod/luasrc/view/themes/argon/footer.htm
sed -i "s|<a class=\"luci-link\" href=\"{{ version.disturl }}\" target=\"_blank\">{{ version.distname }} {{ version.distversion }}-{{ version.distrevision }}</a>|<a href=\"https://github.com/YuKiFuHaNe\" target=\"_blank\">YuKiFuHaNe</a> build $(TZ=UTC-8 date \"+%Y.%m.%d\") @ OpenWrt|g" package/luci-theme-argon/ucode/template/themes/argon/footer.ut1
2
3
4# 电脑登陆页面
sed -i "s/<%= ver.distversion %>/<a href=\"https:\/\/github.com\/YuKiFuHaNe\" target=\"_blank\">YuKiFuHaNe<\/a> build $(TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt/g" feeds/smpackage/luci-theme-argon/luasrc/view/themes/argon/footer.htm
# 手机登陆页面
sed -i "s/<%= ver.distversion %>/<a href=\"https:\/\/github.com\/YuKiFuHaNe\" target=\"_blank\">YuKiFuHaNe<\/a> build $(TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt/g" feeds/smpackage/luci-theme-argon/luasrc/view/themes/argon/footer_login.htm执行
1
make menuconfig
命令进入编译菜单
菜单选项简要说明：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30# 选择 CPU 类型
Target System (x86) --> # 软路由选择 x86，硬路由根据型号厂家自行选择
Subtarget (x86_64) --> # CPU 子选项
Target Profile (Generic x86/64) --> # 厂家具体型号
# 设置镜像编译的格式（squashfs，ext4）
Target Images --> # 默认 squashfs
# 添加较多插件时，为了避免空间不足，建议修改下面两项默认大小（x86/64）
Target Images --> (16) Kernel partition size (in MB) # 默认是16，建议修改为256
Target Images --> (400) Root filesystem partition size (in MB) # 默认是400，建议修改为1024
# 开启 IPv6 支持
Extra packages --> ipv6helper（选定这个后，下面几项会自动选择）
Network --> odhcp6c
Network --> odhcpd-ipv6only
LuCI --> Protocols --> luci-proto-ipv6
LuCI --> Protocols --> luci-proto-ppp
# 开启适用于 VMware 的 VMware Tools
Utilities --> open-vm-tools
Utilities --> open-vm-tools-fuse
# 选择插件
LuCI --> Applications # 根据需要选择，* 代表编入固件，M 表示编译成模块或者IPK包，为空表示不编译
# 选择主题
LuCI --> Themes # 选择喜欢的主题，可以选多个
# 其他选项一般不需要调整，如感兴趣可以自行了解插件中文说明对照表：https://www.right.com.cn/forum/thread-3682029-1-1.html
配置完成后使用编译菜单底部的
Save保存，然后退出菜单Exit，开始下载软件包1
2
3
4
5
6
7# 预下载编译所需的软件包
make download -j8
# 检查文件完整性
find dl -size -1024c -exec ls -l {} \;
# 检查文件完整性命令可以列出下载不完整的文件，小于1k的文件属于下载不完整，如果存在则用下面的命令删除，然后重新下载编译所需的软件包，再次检查
# 确认所有文件完整可大大提高编译成功率，避免浪费时间
find dl -size -1024c -exec rm -f {} \;最后编译固件，编译完成后输出路径是
1
bin/targets
，默认密码是
1
password
1
2# 编译固件（-j 后面是线程数，首次编译推荐用单线程）
make V=s -j1
二次编译
拉取最新 OpenWrt 源码和更新 feeds 源中的软件包源码
1
2
3
4cd lede
git pull
./scripts/feeds update -a
./scripts/feeds install -a清除旧的编译产物和目录（可选）
1
2
3
4
5
6
7make clean
# 源码有大规模更新或者内核更新后执行，以保证编译质量
# 此操作会删除 /bin 和 /build_dir 目录中的文件
make dirclean
# 更换架构编译前必须执行
# 此操作会删除 /bin 和 /build_dir 目录的中的文件（make clean），以及 /staging_dir、/toolchain、/tmp 和 /logs 中的文件同首次编译，多线程编译失败后自动进入单线程编译，失败则输出详细日志
1
2
3
4
5
6
7
8
9
10
11make defconfig
make download -j8
find dl -size -1024c -exec ls -l {} \;
make -j$(nproc) || make -j1 || make -j1 V=s
# 如果需要重新配置
rm -rf ./tmp && rm -rf .config # 清除临时文件和编译配置文件
make menuconfig
make download -j8
find dl -size -1024c -exec ls -l {} \;
make -j$(nproc) || make -j1 || make -j1 V=s
参考文档
diy-mini.sh
1 | #!/bin/bash |
diy-script.sh
1 | #!/bin/bash |
WARNING: your configuration is out of sync. Please run make menuconfig, oldconfig or defconfig!
2
3
make oldconfig
修改默认密码
首先要在装好的openwrt系统上设置一个你想要的密码，设置完后查看输入这个命令查看密码文件：
1 | cat /etc/shadow |
然后会输出密码文件信息：
1 | root:$1$HSk7yPlb$6cPCTE8gYv2AxBvGdwCgS/:17949:0:99999:7::: |
把上面那段文字的第一行“root:XXXXXXXX”复制到openwrt源代码的这个文件里面替换后，然后开始编译：
package/base-files/files/etc/shadow
coolsnowwolf/lede/blob/master/package/lean/default-settings/files/zzz-default-settings
33行
1 | sed -i 's/root::0:0:99999:7:::/root:$1$V4UetPzk$CYXluq4wUazHjmCDBCqXF.:0:0:99999:7:::/g' /etc/shadow |
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 YuKiFuHaNeの博客！
相关推荐
2024-06-28
OpenWrt 定制编译（二）：环境搭建到固件产出
1.编译环境1.1 系统要求系统环境是 Linux 或者 drawin，虚拟机或者物理机都行，例如 wsl 和 vm。系统选择桌面版或者服务器版，有无 GUI（图形化界面）都可以，不影响编译。我推荐使用 Ubuntu LTS x64 和 Debian 11。编译不要使用 root 用户！会导致编译失败。 1.2 硬件要求cpu 当然是越强越好，内存 4G 起步，硬盘 64G 起步。 1.3 必须软件包在 ubantu 的桌面，打开右键菜单，在菜单中选择在终端打开。如果是无 GUI 的 Linux，SSH 连接或者后台直接输入命令也是可以的。 按序输入以下命令。 更新软件包列表。 1sudo apt update 更新软件包。 1sudo apt full-upgrade -y 安装软件包。 123456sudo apt install -y ack antlr3 aria2 asciidoc autoconf automake autopoint binutils bison build-essential \bzip2 ccache cmake cpio curl devi...
2023-11-07
Lede 源码编译 OpenWrt 软路由固件
前言常见软路由器系统举例 pfSense： 优点：强大的功能，支持高级网络配置、VPN、负载均衡等。 缺点：学习曲线较陡峭。 适用场景：中小企业、需要高级网络功能的用户。 例子：将pfSense用于中小型办公室，实现安全的互联网访问和VPN连接。 OpenWRT： 优点：轻量级，支持广泛的硬件，有丰富的插件和定制选项。 缺点：某些高级功能需要额外的配置。 适用场景：家庭用户、技术爱好者。 例子：在家中使用OpenWRT将老旧路由器转变为强大的路由器，扩展网络功能。 DD-WRT： 优点：易于安装，支持大量硬件，有许多高级功能。 缺点：某些高级功能可能对新手不太友好。 适用场景：家庭用户、需要更多网络控制的用户。 例子：使用DD-WRT为家庭网络设置访客网络和家长控制。 IPFire： 优点：专注于安全性，有强大的防火墙和入侵检测功能。 缺点：界面可能较为简单。 适用场景：需要高级网络安全的用户。 例子：在小型企业网络中使用IPFire加强网络安全性。 恩山论坛上有很多用户编译好的现成固件，自己编译固件最大的优势是可以根据需求更好的自定义，建议没有特别需求的用户还...
2024-03-08
使用 GitHub Actions 云编译 OpenWrt 固件
前言Github Actions 是 Microsoft 收购 GitHub 后推出的 CI/CD 服务，它提供了性能配置非常不错的虚拟服务器环境（E5 2vCPU/7G RAM），基于它可以进行构建、测试、打包、部署项目。对于公开仓库可免费无时间限制的使用，且单次使用时间长达 6 个小时，这对于编译 OpenWrt 来说是非常充足的。不过 GitHub Actions 有一定的使用门槛，首先要了解如何编写 workflow 文件。不过不用担心，博主已经编写好了相关的 workflow 文件模版，只需要按照教程的步骤来操作即可。 方案特点 免费 一键快速编译 定时自动编译 客制化编译 并发编译（可同时进行20个编译任务） 无需搭建编译环境（在线make menuconfig生成配置文件) 无需消耗自己的计算机与服务器的计算资源（性感E5在线编译） 无需担心磁盘空间不足（近60G磁盘空间） 无需使用清理文件（内核更新不怕 boom ） 编译速度快（编译时间1-2小时） 编译成功率提升200%（万兆自由网络环境） 全新环境（杜绝编译环境不干净导致编译失败...
2025-01-23
OpenWrt 编译中的 Go 1.22 问题处理
1、设置拉取源（二选一） 12sed -i '1i src-git kenzo https://github.com/kenzok8/openwrt-packages' feeds.conf.defaultsed -i '2i src-git small https://github.com/kenzok8/small' feeds.conf.default 或者 1sed -i '1i src-git smpackage https://github.com/kenzok8/small-package' feeds.conf.default 2、常规feends更新（不要运行install -a） 1./scripts/feeds update -a 如果是拉取small-package的，可以试着删除下面插件 1rm -rf feeds/smpackage/{base-files,dnsmasq,firewall*,fullconenat,libnftnl,nftables,ppp,o...
