目前OpenWrt官方已经推出在线编译固件功能，对于OpenWRT支持的路由器型号，可以直接在 firmware-selector.openwrt.org 下载，还可以自定义预装软件，但如果没有你的机型或者想要深度定制则需要手动编译。

编译准备

Linux环境

请使用普通用户编译，默认不允许 root 用户编译，如果已经用了 root 用户可以执行下面的命令强制编译

1
export FORCE_UNSAFE_CONFIGURE=1

设置代理

编译用到的资源几乎都在墙外，不用代理下载基本上没戏。

修改~/.bashrc，在末尾加入以下代码（根据实际情况做对应修改，此处为 Clash 代理）：

1
2
alias proxy='export https_proxy="http://192.168.2.2:7890";export http_proxy="http://192.168.2.2:7890";export all_proxy="socks5://192.168.2.2:7891";curl ip.sb;'
alias unproxy='unset https_proxy;unset http_proxy;unset all_proxy;curl ip.sb;'

保存退出，重启终端生效

1
2
3
4
# 开启代理
proxy
# 关闭代理
unproxy

通过返回的IP判断是否代理成功

安装依赖
此处为 Ubuntu 22.04 的依赖，用于 OpenWrt master，22.03 和 21.02 分支，实测也可用于 lean 源

1
sudo apt install -y build-essential gawk gcc-multilib flex git gettext libncurses5-dev libssl-dev python3-distutils zlib1g-dev

更多 Linux 发行版及依赖查看openwrt官方文档

下载源码

以openwrt 官方源为例

1
git clone https://github.com/openwrt/openwrt.git

OpenWrt 项目结构（21.02）

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
31
32
.
├── bin # 编译输出路径
│    ├── packages # 所有插件包
│    └── targets # 固件及插件输出路径
├── BSDmakefile
├── build_dir # 编译缓存
├── config
├── Config.in
├── COPYING
├── dl # dl库
├── feeds # feeds 库
├── feeds.conf.default # feeds源配置文件
├── include
├── key-build
├── key-build.pub
├── key-build.ucert
├── key-build.ucert.revoke
├── LICENSES
├── Makefile
├── package # 软件包
│    ├── feeds # feeds 软件的符号链接
│    └── others # 不在 feeds 源中的软件包，目录名任意
├── README.md
├── rules.mk
├── scripts
├── staging_dir # 编译时创建的软链接，指向 bin 目录
├── target
├── tmp # feeds 软件安装目录，删除相当于卸载软件
├── toolchain
├── tools
├──.config # 编译配置文件
└──

menuconfig是OpenWRT项目的图形配置软件，可以方便地进行一些基础的配置，执行以下命令调出

1
make menuconfig

执行后会出现一个图形界面

操作方法：
空格：选择( * 代表编入固件，M 表示编译成模块或者IPK包， 空不编译 )
上下左右键：移动选择条
Enter：进入/确定
<Select>：进入下级菜单
<Exit>：返回上级菜单
<Save>：保存
<Load>：导入配置

基本参数说明

  • Target System 你的路由器的 Soc 架构
  • Subtarget 你的路由器 Soc 的型号
  • Target Profile 你的路由器的型号
  • Target Images 保存目标镜像的格式
  • Advanced configuration options (for developers) 开发者选项，启用后可在Local mirror for source packages配置 dl 库链接
  • Build the OpenWrt SDK 是否编译 SDK
  • Languages 额外的语言环境（Go、Nodejs、PHP、python等）
  • Libraries 依赖库
    • Libraries —>Languages —>
  • LuCI 需要安装的软件包

常用插件列表中英文对照表

插件中文名 Luci App
网络向导 luci-app-quickstart
实时监控 luci-app-netdata
释放内存 luci-app-ramfree
WireGuard 状态 luci-app-wireguard
Web管理 luci-app-webadmin
TTYD 终端 luci-app-ttyd
磁盘管理 luci-app-diskman
高级设置 luci-app-advanced
定时重启 luci-app-autoreboot
Argon 主题设置 luci-app-argon-config
文件传输 luci-app-filetransfer
关机 luci-app-poweroff
应用商店 luci-app-store
阿里云盘 WebDAV luci-app-aliyundrive-webdav
Mentohust 锐捷拨号客户端 luci-app-mentohust
Minieap 锐捷拨号客户端 luci-app-minieap
甜糖星愿自动采集 luci-app-ttnode
Hello World luci-app-vssr
Clash(frainzy1477) luci-app-clash
PassWall luci-app-passwall
Bypass luci-app-bypass
V2ray 服务器 luci-app-v2ray-server
广告屏蔽大师 Plus+ luci-app-adbyby-plus
iKoolProxy 滤广告 luci-app-ikoolproxy
DNS 过滤器 luci-app-dnsfilter
ShadowSocksR Plus+ luci-app-ssr-plus
AdGuard Home luci-app-adguardhome
京东签到服务 luci-app-jd-dailybonus
易有云文件管理器 luci-app-linkease
DDNS.to内网穿透 luci-app-ddnsto
微信推送 luci-app-serverchan
全能推送 luci-app-pushbot
上网时间控制 luci-app-accesscontrol
解锁网易云灰色歌曲 luci-app-unblockmusic
OpenClash luci-app-openclash
阿里DDNS luci-app-aliddns
动态 DNS(支持阿里腾讯) luci-app-ddns
QoS Nftables 版 luci-app-nft-qos
SmartDNS luci-app-smartdns
LXC Containers luci-app-lxc
天翼家庭云/天翼云盘提速 luci-app-familycloud
网络唤醒 luci-app-wol
WatchCat luci-app-watchcat
UU游戏加速器 luci-app-uugamebooster
VPN 绕过 luci-app-vpnbypass
Frps luci-app-frps
Frp 内网穿透 luci-app-frpc
UPnP luci-app-upnp
Nps 内网穿透 luci-app-nps
迅雷快鸟 luci-app-xlnetacc
OpenConnect VPN luci-app-ocserv
OpenVPN(客户端) luci-app-openvpn
uHTTPd luci-app-uhttpd
KMS 服务器 luci-app-vlmcsd
RP PPPoE Server luci-app-rp-pppoe-server
IPTV 帮手 luci-app-iptvhelper
组播代理 luci-app-omcproxy
udpxy luci-app-udpxy
MWAN3 分流助手 luci-app-mwan3helper
AirPlay 2 音频接收器 luci-app-airplay2
Docker CE 容器 luci-app-docker
Docker(Dockerman) luci-app-dockerman
可道云 luci-app-kodexplorer
NFS 管理 luci-app-nfs
微力同步 luci-app-verysync
USB 打印服务器 luci-app-usb-printer
打印服务器(模块) luci-app-p910nd
硬盘休眠 luci-app-hd-idle
网络共享(SMB) luci-app-samba
Aria2 配置 luci-app-aria2
挂载 SMB 网络共享 luci-app-cifs-mount
Rclone luci-app-rclone
miniDLNA luci-app-minidlna
Transmission luci-app-transmission
FTP 服务器 luci-app-vsftpd
PCHiFi 数字转盘遥控 luci-app-music-remote-center
qBittorrent luci-app-qbittorrent
aMule luci-app-amule
BaiduPCS Web luci-app-baidupcs-web
N2N v2 VPN luci-app-n2n_v2
SoftEther VPN 服务器 luci-app-softethervpn
IPSec VPN 服务器 luci-app-ipsec-server
OpenVPN 服务器 luci-app-openvpn-server
PPTP VPN 服务器 luci-app-pptp-server
ZeroTier luci-app-zerotier
IP/MAC绑定 luci-app-arpbind
简单MESH luci-app-easymesh
流量统计 luci-app-bandwidthd
网速测试 luci-app-netspeedtest
SQM QoS luci-app-sqm
IPv6 端口转发 luci-app-socatg
网速控制 luci-app-eqos
应用过滤 luci-app-oaf
服务质量(QoS)
多线多拨 luci-app-syncdial
负载均衡 luci-app-mwan3
Turbo ACC 网络加速
网络带宽监视器 luci-app-nlbwmon
实时流量监测 luci-app-wrtbwmon
IPV6 ipv6helper

更多插件说明：
https://www.right.com.cn/forum/thread-3682029-1-1.html
https://max.book118.com/html/2021/0405/8133116046003071.shtm

示例配置：

基础

  • LuCI —> Collections —> <*>luci (Luci 后台，必备)
  • LuCI —> Modules —> Translations —> <*>Chinese Simplified (zh_Hans) (中文语言)
  • Extra packages—>ipv6helper (IPV6支持)

多拨

  • Kernel modules —> Network Devices —> kmod-macvlan 虚拟网络设备，勾选后即可支持单线多拨，直接新建多个重复拨号接口即可
  • LuCI —> Applications —> <*> luci-app-mwan3 负载均衡
  • LuCI —> Applications —> <*> luci-app-syncdial 多线多拨（可选，lean源）

保存后配置会写入.config文件，里面有源码所有配置，未选择的配置以注释的形式存在，图形界面找不到的配置可以在.config文件里搜索再修改

配置

添加自定义设备

对于硬件支持列表里没有的设备，支持刷机的部分可以自己添加

比如华硕TUF-AX4200Q，目前只有华硕TUF-AX4200的，虽然可以直接刷华硕TUF-AX4200的OpenWRT固件，但是TUF-AX4200Q比TUF-AX4200多一个2.5GLAN口，TUF-AX4200的OpenWRT固件识别不到，我们可以通过修改设备信息使其支持2.5GLAN口

下载通用软件源

  1. 下载 feeds 软件（通过feeds.conf.default文件里配置的地址将软件源码下载到/feeds目录并生成索引文件）
1
./scripts/feeds update -a
  1. 安装下载好的 feeds 软件（创建/feeds目录的软链接到/package/feeds目录，使其能够被 menuconfig 识别
1
./scripts/feeds install -a

替换已有软件

有些软件需要很多依赖，还涉及到源码的修改，比较复杂，这里只作简要说明

对于只在/package目录里的软件，直接替换即可；

对于/feeds目录下的软件，需要先删除/package/feeds目录下对应的软连接，再删除/tmp目录下的缓存，替换软件包，再安装一遍就可以了

添加argon主题

不同源码地位置可能略有不同，不过一般都在/package目录下

1
2
3
4
5
6
## openwrt 源
git clone https://github.com/jerrykuku/luci-theme-argon.git package/luci-theme-argon

## Lean 源
rm -rf package/feeds/luci/luci-theme-argon
git clone -b 18.06 https://github.com/jerrykuku/luci-theme-argon.git package/feeds/luci/luci-theme-argon

添加 ssr-plus

  1. 添加 helloworld 源
1
sed -i '$asrc-git helloworld https://github.com/fw876/helloworld' feeds.conf.default
  1. 更新
1
2
./scripts/feeds update -a
./scripts/feeds install -a
  1. 添加一些依赖，暂时没搞清楚

新版openwrt都默认禁止通过MD5认证的订阅链接了，导致很多老机场订阅不能用，可通过以下方法关闭
修改helloworld/luci-app-ssr-plus/root/usr/share/shadowsocksr/subscribe.lua，删除以下验证代码：

1
2
3
4
-- https://www.v2fly.org/config/protocols/vmess.html#vmess-md5-认证信息-淘汰机制
if info.aid and (tonumber(info.aid) > 0) then
result.server = nil
end

修改 Luci 后台地址

修改文件/package/basefiles/files/bin/config_generate

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
		static)
			local ipad
			case "$1" in
+			lan) ipad=${ipaddr:-"192.168.1.1"} ;;
				*) ipad=${ipaddr:-"192.168.$((addr_offset++)).1"} ;;
			esac

			netm=${netmask:-"255.255.255.0"}

			uci -q batch <<-EOF
				set network.$1.proto='static'
				set network.$1.ipaddr='$ipad'
				set network.$1.netmask='$netm'
			EOF
			[ -e /proc/sys/net/ipv6 ] && uci set network.$1.ip6assign='60'
		;;

修改主机名

修改文件/package/basefiles/files/bin/config_generate

1
2
3
4
5
6
7
8
	uci -q batch <<-EOF
		delete system.@system[0]
		add system system
+		set system.@system[-1].hostname='OpenWrt'
		set system.@system[-1].timezone='UTC'
		set system.@system[-1].ttylogin='0'
		set system.@system[-1].log_size='64'
		set system.@system[-1].urandom_seed='0'

修改版本号

搜索DISTRIB_REVISION

修改 SSH 登陆欢迎信息

修改文件/package/base-files/files/etc/banner
可以在此处定制自己的样式

修改 dts

在/target/linux/ramips/dts/目录下找到自己机型的 dts，修改以下内容

1
2
3
4
5
partition@50000 {
	compatible = "denx,uimage";
	label = "firmware";
	reg = <0x50000 0x1fb0000>;
};

其中1f60000=32M；1fb0000=16M；7b0000=8M

下载dl库

1
make download -j8

::: warning
建议焕源，如果采用默认dl库，很容易因为某个文件出错无限卡，可以通过更换第三方dl库解决，参考教程
:::

下面是可更换的dl库地址：
OpenWrt 官方dl库（下载经常卡在某个地方，两个都一样）

  • https://sources.openwrt.org/ 默认源（墙）
  • http://downloads.openwrt.org.cn/sources/ 国内源

第三方dl库

项目 支持分支 源码包镜像地址
openwrt/openwrt master / openwrt-21.02 / openwrt-19.07 / openwrt-18.06 / lede-17.01 https://openwrt.cc/dl/openwrt/openwrt
coolsnowwolf/lede master https://openwrt.cc/dl/coolsnowwolf/lede
immortalwrt/immortalwrt master / openwrt-21.02 / openwrt-18.06 / openwrt-18.06-k5.4 https://openwrt.cc/dl/immortalwrt/immortalwrt
Lienol/openwrt main / 19.07 / 21.02 https://openwrt.cc/dl/lienol/openwrt

开始编译

执行以下命令编译

1
2
3
4
5
## 单线程编译(-j 后面是线程数，第一次编译推荐用单线程，方便发现并解决错误)
make V=s -j1

## 以最大线程编译
make V=s -j$(nproc)

若使用 WSL 编译，可能会因为Windows路径里带空格导致编译失败，在 make 编译命令前需要加上以下代码

1
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

进阶编译操作

1
2
3
4
5
6
7
8
9
10
11
12
## 单独编译内核
make target/linux/compile V=s      

## 单独编译插件，此处以luci-app-netdata为例              
make package/lean/luci-app-netdata/compile V=s

## 还原为初始状态重新配置编译
rm -rf ./tmp && rm -rf .config
./scripts/feeds clean
./scripts/feeds update -a && ./scripts/feeds install -a
make menuconfig
make V=s -j$(nproc)

编译完成后输出路径：bin/targets

1
2
3
4
5
6
7
8
9
.
├── config.buildinfo # 编译配置文件
├── feeds.buildinfo # feeds 源文件
├── openwrt-ramips-mt7620-aigale_ai-br100-initramfs-kernel.bin # 调试固件包（重启路由自动恢复出厂设置）
├── openwrt-ramips-mt7620-aigale_ai-br100.manifest # 所有插件版本信息
├── openwrt-ramips-mt7620-aigale_ai-br100-squashfs-sysupgrade.bin # 固件包
├── packages # 固件包含的所有插件
├── sha256sums
└── version.buildinfo # 版本信息

在 Windows 资源管理器地址栏输入\\wsl$即可访问 WSL 下的文件

资料

源码汇总

openwrt

  • openwrt 官方源 自带插件很少，但最稳定
  • lede 源 基于官方17.01分支，自带插件很全，但不是最新
  • Lienol 源 基于官方最新分支，自带插件挺多，没有科学，版本也很新，除了多拨创建的虚拟接口需要手动绑定才能正常使用没啥毛病
  • immortalwrt 源 功能很丰富

软件源

软件源使用方法：

  1. 添加软件源
1
sed -i '$asrc-git helloworld https://github.com/fw876/helloworld' feeds.conf.default

解释："helloworld"是软件源的别名，软件会被下载到/feeds/helloworld目录，链接为软件源地址

  1. 执行以下命令下载安装软件
1
2
3
4
5
6
## 全部下载并安装
./scripts/feeds update -a
./scripts/feeds install -a
## 单独下载并安装
./scripts/feeds update helloworld
./scripts/feeds install -a -p helloworld

插件下载

固件下载

疑难杂症

  • 可以登录 SSH，但是登录 luci 后台一直失败（官方源）
    原因：官方 openwrt 采用了 cookie 验证，需要删除旧的 cookie 才能登录