1292 字

6 分钟

OpenWrt固件编译

2025-11-19

运维

网络

/

教程

介绍#

OpenWrt 是一个基于 Linux 的路由器操作系统，专门为嵌入式设备（路由器、NAS、小型网关设备等）设计。

本篇教程基于immortalwrt，immortalwrt 是基于 openwrt 开发的优化版本，是专门针对中国大陆环境优化的版本。国内用户基本都使用这个版本。

项目地址：https://github.com/immortalwrt/immortalwrt

immortalwrt 在线构建#

官方提供的网页在线构建叫ImageBuilder，不是编译源码，而是借助官方的服务器资源，使用预编译好的SDK，快速选择包然后生成固件。优点是构建很快，缺点是自定义程度不是很高，但是常用的配置都可以自定义，例如提前安装插件，配置网口信息和防火墙什么的。

官方在线编译地址：https://firmware-selector.immortalwrt.org

必备软件#

1
openssh-sftp-server curl luci-theme-argon luci-i18n-homeproxy-zh-cn luci-i18n-ttyd-zh-cn luci-i18n-diskman-zh-cn luci-i18n-filemanager-zh-cn luci-i18n-package-manager-zh-cn luci-i18n-firewall-zh-cn

当你安装一个插件包时，他会自动下载所需的软件和依赖，所以只需添加对应插件的汉化包即可。

ImmortalWrt软件包查询（注意替换实际的版本和设备架构）：

带luci：https://downloads.immortalwrt.org/releases/25.12.2/packages/x86_64/luci/index.json

不带luci：https://downloads.immortalwrt.org/releases/25.12.2/packages/x86_64/packages/index.json

初始化构建脚本#

要修改的地方请去掉注释

1
# 首次启动初始化脚本
2
# 路径：/rom/etc/uci-defaults/
3
# 取消注释即可启用
4

5
# Wi-Fi 名称和密码
6
# wlan_name="ImmortalWrt"
7
# wlan_password="12345678"
8

9
# 后台及 SSH 管理员密码
10
# root_password="admin"
11

12
# LAN 地址（25.12+ 必须使用 CIDR 格式）
13
# lan_ip_address="192.168.2.1/24"
14

15
# PPPoE 宽带账号和密码
16
# pppoe_username=""
17
# pppoe_password=""
18

19
# 记录执行日志
20
exec >/tmp/setup.log 2>&1
21

22
# 设置管理员密码
23
if [ -n "$root_password" ]; then
24
  (echo "$root_password"; sleep 1; echo "$root_password") | passwd > /dev/null
25
fi
26

27
# 设置 LAN 地址
28
if [ -n "$lan_ip_address" ]; then
29
  uci set network.lan.ipaddr="$lan_ip_address"
30
  uci commit network
31
fi
32

33
# 设置 Wi-Fi
34
if [ -n "$wlan_name" -a -n "$wlan_password" -a ${#wlan_password} -ge 8 ]; then
35
  uci set wireless.@wifi-device[0].disabled='0'
36
  uci set wireless.@wifi-iface[0].disabled='0'
37
  uci set wireless.@wifi-iface[0].encryption='psk2'
38
  uci set wireless.@wifi-iface[0].ssid="$wlan_name"
39
  uci set wireless.@wifi-iface[0].key="$wlan_password"
40
  uci commit wireless
41
fi
42

43
# 设置 PPPoE 拨号
44
if [ -n "$pppoe_username" -a "$pppoe_password" ]; then
45
  uci set network.wan.proto=pppoe
46
  uci set network.wan.username="$pppoe_username"
47
  uci set network.wan.password="$pppoe_password"
48
  uci commit network
49
fi
50

51
echo "All done!"

构建完成后下载对应的固件包刷入系统即可。

immortalwrt 基于源码编译#

使用干净的Debian 12或者ubuntu 22.04系统，国外网络通畅，有50G以上的空闲存储空间。

1：安装依赖#

1
sudo apt update -y
2
sudo apt full-upgrade -y
3
sudo apt install -y \
4
  ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
5
  bzip2 ccache clang cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext \
6
  gcc-multilib g++-multilib git gperf haveged help2man intltool libc6-dev-i386 libelf-dev \
7
  libglib2.0-dev libgmp-dev libltdl-dev libmpc-dev libmpfr-dev libncurses-dev libpython3-dev \
8
  libreadline-dev libssl-dev libtool libyaml-dev lld llvm lrzsz genisoimage \
9
  ninja-build p7zip-full patch pkgconf python3 python3-pip python3-ply python3-docutils \
10
  python3-pyelftools qemu-utils re2c rsync scons squashfs-tools subversion swig texinfo \
11
  uglifyjs unzip wget nano xmlto xxd zlib1g-dev upx zstd

2：下载对应tags的源码（以`v25.12.2`为例）#

后续步骤建议切换为普通用户，不要用root用户编译。

1
git clone -b v25.12.2 --single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt

3：进入项目目录#

1
cd immortalwrt

4：获取最新软件包清单#

1
./scripts/feeds update -a

5：安装软件包符号链接#

1
./scripts/feeds install -a

6：配置固件信息#

1
make menuconfig

这一步很重要，前三个选项分别是目标系统 - 子架构 - 目标机型。根据你的实际设备来选。

然后第四个选项Target Images是修改固件配置的，其中Root filesystem partition size是根文件系统分区大小建议修改，根据你设备的存储空间来选择，这里的值就是最大存储空间。

其他配置都是可选的，其中luci选项中可以预安装一些插件包。

7：修改LAN口IP地址等等信息#

可以在这里查看默认值：https://github.com/immortalwrt/immortalwrt/blob/master/package/base-files/files/bin/config_generate

1
nano package/base-files/files/bin/config_generate

8：编译固件#

单线程编译

1
make -j1 V=s

或者多线程编译

1
make -j$(nproc --ignore=1)

编译出来的固件在bin目录下

9：重新编译说明#

如果需要重新编译则执行make distclean清理一些残留和工具链等等，然后再从第四步重新开始。

VirtualBox虚拟机运行immortalwrt#

1：选择x86/64型号，编译后，下载COMBINED (EXT4)格式的镜像，并解压到下载目录

2：在文件目录下打开 PowerShell

将镜像转换成VDI格式

1
& "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" convertfromraw `
2
    "immortalwrt-25.12.2-x86-64-generic-ext4-combined.img" `
3
    "immortalwrt.vdi" `
4
    --format VDI

3: 系统内修改网络配置的命令：

1
vi /etc/config/network

1
/etc/init.d/network restart

4：浏览器进入LAN口IP地址，密码是脚本中设置的密码。

X86主机设备将镜像写入到硬盘#

先将镜像烧录到U盘，然后使用U盘启动进入到openwrt系统，然后使用DD命令写入镜像，就可以拔掉U盘运行openwrt系统了。

查看U盘和目标硬盘#

1
lsblk -f

例如 U 盘是 /dev/sdb 硬盘是 /dev/sda

如果目标硬盘有被挂载则需要卸载，例如之前装了系统之类的#

1
umount /dev/sda1
2
umount /dev/sda2
3
umount /dev/sda3

检查是否卸载成功#

1
mount | grep sda

如果返回为空就代表卸载成功了

写入镜像（注意替换实际的U盘和硬盘）#

1
dd if=/dev/sdb of=/dev/sda bs=4M conv=fsync

如果没报错，并且看到了两行数字就代表成功了

强制刷新缓存#

1
sync

命令解释：#

if=/dev/sdb ：输入源，U 盘设备

of=/dev/sda ：输出目标，硬盘/闪存设备

bs=4M ：每次写入 4M，提高速度

conv=fsync ：写完后刷新缓存，确保数据落盘

sync ：再次确保所有数据写入完成

OpenWrt固件编译

https://blog.emohe.cn/posts/openwrt固件编译/

作者

阿涛の小破站

发布于

2025-11-19

许可协议

CC BY-NC-SA 4.0

给你的电脑增加一个自定义右键菜单

香橙派开发板折腾日记

VirtualBox虚拟机运行immortalwrt

5

X86主机设备将镜像写入到硬盘

介绍#