介绍
OpenWrt 是一个 基于 Linux 的路由器操作系统，专门为嵌入式设备（路由器、NAS、小型网关设备等）设计。
本篇教程基于immortalwrt，immortalwrt 是基于 openwrt 开发的优化版本，是专门针对中国大陆环境优化的版本。国内用户基本都使用这个版本。
immortalwrt 在线构建
官方提供的网页在线构建叫ImageBuilder，不是编译源码，而是借助官方的服务器资源，使用预编译好的SDK，快速选择包然后生成固件。优点是构建很快，缺点是自定义程度不是很高，但是常用的配置都可以自定义，例如提前安装插件，配置网口信息和防火墙什么的。
官方在线编译地址：https://firmware-selector.immortalwrt.org
必备软件
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.0/packages/x86_64/luci/index.json
不带luci：https://downloads.immortalwrt.org/releases/25.12.0/packages/x86_64/packages/index.json
初始化构建脚本
要修改的地方请去掉注释
#!/bin/shexec >/tmp/setup.log 2>&1
############################################################ 自 定 义 配 置 区 域###########################################################
### 系统后台密码（为空则不修改）root_password="admin"
### LAN 的 IPv4 地址（也是后台地址，例如 192.168.2.1）lan_ip_address="192.168.2.1"
### LAN 的子网掩码（例如 255.255.255.0）# lan_netmask="255.255.255.0"
### LAN 的 IPv4 网关（可为空）# lan_gateway="192.168.1.1"
### LAN 的 DNS（多个 DNS 可空格分隔，如 "8.8.8.8 1.1.1.1"）# lan_dns="8.8.8.8 223.5.5.5"
### DHCP 是否开启（1=开启，0=关闭）# lan_dhcp_enable="1"
### DHCP 起始地址# lan_dhcp_start="100"
### DHCP 地址池数量# lan_dhcp_limit="150"
### DHCP 租约时间# lan_dhcp_leasetime="12h"
### WiFi 名称 SSID（为空则不修改）# wlan_name="ImmortalWrt"
### WiFi 密码（≥ 8 位才生效）# wlan_password="12345678"
### PPPoE 宽带账号（为空则跳过）# pppoe_username=""
### PPPoE 宽带密码# pppoe_password=""
###########################################################
# ------------ root 密码 ------------if [ -n "$root_password" ]; then (echo "$root_password"; sleep 1; echo "$root_password") | passwd >/dev/nullfi
# ------------ LAN 基础配置 ------------if [ -n "$lan_ip_address" ]; then uci set network.lan.ipaddr="$lan_ip_address"fi
if [ -n "$lan_netmask" ]; then uci set network.lan.netmask="$lan_netmask"fi
if [ -n "$lan_gateway" ]; then uci set network.lan.gateway="$lan_gateway"fi
# DNSif [ -n "$lan_dns" ]; then uci delete network.lan.dns 2>/dev/null for d in $lan_dns; do uci add_list network.lan.dns="$d" donefi
uci commit network
# ------------ DHCP 设置 ------------if [ -n "$lan_dhcp_enable" ]; then uci set dhcp.lan.ignore=$([ "$lan_dhcp_enable" = "1" ] && echo 0 || echo 1)fi
[ -n "$lan_dhcp_start" ] && uci set dhcp.lan.start="$lan_dhcp_start"[ -n "$lan_dhcp_limit" ] && uci set dhcp.lan.limit="$lan_dhcp_limit"[ -n "$lan_dhcp_leasetime" ] && uci set dhcp.lan.leasetime="$lan_dhcp_leasetime"
uci commit dhcp
# ------------ WIFI 配置 ------------if [ -n "$wlan_name" ] && [ -n "$wlan_password" ] && [ ${#wlan_password} -ge 8 ]; then uci set wireless.@wifi-device[0].disabled='0' uci set wireless.@wifi-iface[0].disabled='0' uci set wireless.@wifi-iface[0].encryption='psk2' uci set wireless.@wifi-iface[0].ssid="$wlan_name" uci set wireless.@wifi-iface[0].key="$wlan_password" uci commit wirelessfi
# ------------ PPPoE 宽带拨号 ------------if [ -n "$pppoe_username" ] && [ -n "$pppoe_password" ]; then uci set network.wan.proto=pppoe uci set network.wan.username="$pppoe_username" uci set network.wan.password="$pppoe_password" uci commit networkfi
echo "All done!"构建完成后下载对应的固件包刷入系统即可。
immortalwrt 基于源码编译
使用干净的Debian 12或者ubuntu 22.04系统，国外网络通畅，有50G以上的空闲存储空间。
1：安装依赖
sudo apt update -ysudo apt full-upgrade -ysudo apt install -y \ ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \ bzip2 ccache clang cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext \ gcc-multilib g++-multilib git gperf haveged help2man intltool libc6-dev-i386 libelf-dev \ libglib2.0-dev libgmp-dev libltdl-dev libmpc-dev libmpfr-dev libncurses-dev libpython3-dev \ libreadline-dev libssl-dev libtool libyaml-dev lld llvm lrzsz genisoimage \ ninja-build p7zip-full patch pkgconf python3 python3-pip python3-ply python3-docutils \ python3-pyelftools qemu-utils re2c rsync scons squashfs-tools subversion swig texinfo \ uglifyjs unzip wget nano xmlto xxd zlib1g-dev upx zstd2：下载对应tags的源码（以v24.10.4为例）
后续步骤建议切换为普通用户，不要用root用户编译。
git clone -b v24.10.4 --single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt3：进入项目目录
cd immortalwrt4：获取最新软件包清单
./scripts/feeds update -a5：安装软件包符号链接
./scripts/feeds install -a6：配置固件信息
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
nano package/base-files/files/bin/config_generate8：编译固件
单线程编译
make -j1 V=s或者多线程编译
make -j$(nproc --ignore=1)编译出来的固件在bin目录下
9：重新编译说明
如果需要重新编译 则执行make distclean清理一些残留和工具链等等，然后再从第四步重新开始。
VirtualBox虚拟机运行immortalwrt
1：选择x86/64型号，编译后，下载COMBINED (EXT4)格式的镜像，并解压到下载目录
2：在文件目录下打开 PowerShell
- 将镜像转换成VDI格式
& "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" convertfromraw ` "immortalwrt-24.10.4-f726c678216d-x86-64-generic-ext4-combined.img" ` "immortalwrt.vdi" ` --format VDI3: 系统内修改网络配置的命令：
vi /etc/config/network/etc/init.d/network restart4：浏览器进入LAN口IP地址，密码是脚本中设置的密码。
X86主机设备将镜像写入到硬盘
先将镜像烧录到U盘，然后使用U盘启动进入到openwrt系统，然后使用DD命令写入镜像，就可以拔掉U盘运行openwrt系统了。
查看U盘和目标硬盘
lsblk -f例如 U 盘是
/dev/sdb硬盘是/dev/sda
如果目标硬盘有被挂载则需要卸载，例如之前装了系统之类的
umount /dev/sda1umount /dev/sda2umount /dev/sda3检查是否卸载成功
mount | grep sda如果返回为空就代表卸载成功了
写入镜像（注意替换实际的U盘和硬盘）
dd if=/dev/sdb of=/dev/sda bs=4M conv=fsync如果没报错，并且看到了两行数字就代表成功了
强制刷新缓存
sync命令解释：
if=/dev/sdb ：输入源，U 盘设备
of=/dev/sda ：输出目标，硬盘/闪存设备
bs=4M ：每次写入 4M，提高速度
conv=fsync ：写完后刷新缓存，确保数据落盘
sync ：再次确保所有数据写入完成