今天修改了 luci-mod-network 一个js脚本，需要测试兼容性，于是打开 Chrome 输入192.168.1.1

😦😦😦😦😦 WTF?


![Screenshot 2025-06-04 at 22.12.48.png](/static/img/83da3d26d3b1b6fe9bed0530920ac307.Screenshot%202025-06-04%20at%2022.12.48.webp)



```
This site can’t be reached
https://192.168.1.1/ is unreachable.
ERR_ADDRESS_UNREACHABLE
```
- Microsoft Edge ✅
- Safari ✅
- Firefox ✅
- Chrome ❌

这...什么鬼

不是因为Chrome，而是因为新版的MacOS系统，禁止了Chrome接入内网，所以Safari可以，Chrome不可以，不是因为浏览器内核、不是因为Chrome提高了安全防护等级，而是MacOS的系统设置问题。


:::tip{title="解决方案"}
打开MacOS的“系统设置” - “隐私与安全性” - “本地网络” \
让指定的软件可以使用内网，点开 Chrome 右边的开关
:::

![Screenshot 2025-06-04 at 22.08.06.png](/static/img/0e51ea3f909828855ac7aab9f1815544.Screenshot%202025-06-04%20at%2022.08.06.webp)

Chrome : ERR_ADDRESS_UNREACHABLE

# 前言

![Screenshot 2025-06-03 at 09.25.28.png](/static/img/0a084eaae7c6e165453386b77c3a288c.Screenshot%202025-06-03%20at%2009.25.28.webp)
> 不作 就不会屎 \
> 没有调查研究 就没有发言权

至理名言啊～



## 关于 MR9000/MR9000X/MR9000-CN
它们都是同一款路由器，基于Linksys MR8300升级的型号，所以大体是相同的，存在一点点差异。

![mr9000.png](/static/img/5409fa020e7ee08772b852d486a22bfa.mr9000.webp)

# 变砖的原因
淘汰下来的设备，总想着不能浪费，当初也是旗舰机的存在。那就拿来刷个OP给办公室当主路由吧，性能还是不在话下的。 

## 没有 OpenWRT 官方支持的固件
一样的IPQ4019芯片，但找遍全网，就是没有这个机器的固件可刷，Linksys官方的固件功能稍微差一点，比如不能AdGuardHome、不能魔法、不能指定DHCP客户端IP，等等...

还是 op 论坛搜索到了一个讨论这款路由器的帖子，于是打开了新世界的大门，因为某位大神给编译了固件...

继续发挥互联网🛜的优势，找到这位大神的 github ，继而找到他用来发布固件的 URL

### 22.03.4 --> 23.05.0 --> 23.05.5 --> 24.10.1
一路走来，到最新版本的时候变砖了，过程就不说了，其实在23.05版的时候就已经有苗头了，偶发会出现重启以后没反应了，但是断电再开会有50%概率能够启动。但其实在luci界面查看Advanced reboot可以发现问题的：显示第二分区不正常了。

# 找寻元凶
UART连接，发现问题：
```
## Booting kernel from FIT Image at 84000000 ...
Bad FIT kernel image format!
ERROR: can't get kernel image!
```
这... 难道是固件坏了？ 

![mr8300_uart.jpg](/static/img/3ff92dd48d1b2e40b11b7e67043f25ed.mr8300_uart.webp)

拿出模块、杜邦线，按下图接好

![mr9000.jpeg](/static/img/331ab86fe8a9d9a2905965a1b3264671.mr9000.webp)


![341.jpeg](/static/img/289a5e02c01a49f99d512bd8d4054005.341.webp)
重新刷写一遍，ok，可以启动了，太好了！

关机，拔掉杜邦线，装好盖子，开机。
等待... ... ... ... ... 又不启动了，获取不到IP，盖子上的LED也一闪不闪！

完蛋！！！

难道是... 打开ChatGPT、Gemini问了一圈，都说大概率是NAND嘎了。

想想这机子用了十几年了，也确实、大概、可能真的是完蛋了！！！

可是，TFTP刷机的时候也没有报有坏块啊... 😭😭😭😭😭 先洗洗睡吧。

## 救砖
今天，一大早睡不着了，抱着不死心的心态，再次打开OP官网，查查有没有可能，突然想起ChatGPT曾经提起过这机器与MR8300非常接近，那就去看看吧。

### 蛛丝马迹
功夫不负有心人纳～～👍 在 [MR8300](https://openwrt.org/toh/linksys/mr8300#installation_of_23052410_or_snapshot) 的页面终于找到了关键点 👇👇👇

:::warning{title="注意⚠️"}
Installation of 23.05 and 24.10 (also main snapshot) requires a two steps installation. First you'll need to install 22.03 for changing a boot variable. Than you can install 23.05 or 24.10 (or main). Don't try to install or upgrade to 23.05 or 24.10 directly, it will soft-brick your device! Procedure is easy and described below.
:::

:::warning{title="警告⚠️"}
WARNING FOR INSTALLATION

Installation of 23.05/24.10 or snapshot requires two steps.

a previous working OpenWrt 22.03 to run several commands to change a bootloader variable. This is only needed once in the lifetime of the device.
flashing 23.05/24.10 or snapshot.
Don't try to flash directly 23.05/24.10, it won't work.
:::

:::info{title="信息🔔"}
Preliminary. Despite its fair amount of flash memory (256MB), the MR8300 has a **tiny kernel partition** limited to ***3MB***. This is sufficient to boot Linksys OEM and OpenWrt 22.03 (based on kernel 5.10). Meanwhile this is not enough to boot kernels 5.15 (23.05) or 6.6 (24.10). There is a workaround for this situation, and it involves changing a bootloader variable. This is only needed once in the lifetime of the device, and can be done easily via SSH. Once the bootloader has been tweaked, the device can boot everything: Linksys OEM, OpenWrt 22.03, 23.05, 24.10 and snapshot.
:::

同时，在 [论坛](https://forum.openwrt.org/t/openwrt-23-05-0-rc2-second-release-candidate/164308/172) 里也找到了类似的情况：

![Screenshot 2025-06-02 at 20.30.20.png](/static/img/91d4928ae25534b6e94b871631485a8c.Screenshot%202025-06-02%20at%2020.30.20.webp)

### 解决思路
既然 MR9000 基于 MR8300 ，并且它们的硬件配置高度相似，那么极大可能也是这个原因导致的。
那么我们再一次连上UART，看看u-boot进去之后，kernel的大小：
```
(IPQ40xx) # printenv
altkern=5f80000
auto_recovery=yes
baudrate=115200
boot_part=2
boot_part_ready=3
boot_ver=1.4.0
bootcmd=if test $auto_recovery = no; then bootipq; elif test $boot_part = 1; then run bootpart1; else run bootpart2; fi
bootdelay=2
bootpart1=set bootargs $partbootargs && nand read $loadaddr $prikern $kernsize && bootm $loadaddr
bootpart2=set bootargs $partbootargs2 && nand read $loadaddr $altkern $kernsize && bootm $loadaddr
ethact=eth0
ethaddr=00:03:7f:ba:db:ad
flash_type=2
flashimg=tftp $loadaddr $image && nand erase $prikern $imgsize && nand write $loadaddr $prikern $filesize
flashimg2=tftp $loadaddr $image && nand erase $altkern $imgsize && nand write $loadaddr $altkern $filesize
image=lion.img
imgsize=5800000
ipaddr=192.168.1.1
kernsize=300000  # <-- 注意，这就是罪魁祸首
loadaddr=84000000
machid=8010006
netmask=255.255.255.0
partbootargs=init=/sbin/init rootfstype=ubifs ubi.mtd=11,2048 root=ubi0:ubifs rootwait rw
partbootargs2=init=/sbin/init rootfstype=ubifs ubi.mtd=13,2048 root=ubi0:ubifs rootwait rw
prikern=780000
serverip=192.168.1.254
stderr=serial
stdin=serial
stdout=serial
```
元凶`kernsize=300000`既然找到，那么解决它也就易如反掌了：
```
setenv kernsize 500000
saveenv
reset
```

:::tip{title="原因"}
因为23.05开始，kernel都大于3MB了，u-boot极大概率会报错
```
Bad FIT kernel image format!
ERROR: can't get kernel image!
```
:::
果然，reset 自动重启就天下太平了。
# 恢复原厂kernel
## Linksys 原厂固件下载
在 [https://support.linksys.com/](https://support.linksys.com/kb/article/583-en/) 找到 [MR9000 Downloads, Documents, and User Guide](https://support.linksys.com/kb/article/583-en/) 页面：

:::note{title="MR9000 Downloads"}

The hardware version is located beside or beneath the model number and is labeled version, ver. or V. If there is no version number beside the model number on your Linksys product, the device is version 1. If you still have trouble finding your version number, see the complete article to learn more.

Select your hardware version: \
▼ Version 1.0

Firmware

Ver. 1.1.3.210125 \
Latest Date: 4/6/2022 \
[Download](https://downloads.linksys.com/support/assets/firmware/FW_MR9000_1.1.3.210125_prod.img) 48.5 MB \
Release Notes
:::
下载下来的固件名是：FW_MR9000_1.1.3.210125_prod.img 保存好备用。

## 刷回原厂
无论是 UART 进入 u-boot ，还是ssh到 OpenWRT，都要先启动到alt_kernel/alt_rootfs，这样确保刷回去的原厂固件在kernel和roofs。

:::info{title="u-boot"}
printenv \
setenv boot_part 2 \
saveenv \
reset
:::

:::info{title="ssh root@openwrt"}
fw_printenv \
fw_setenv boot_part 2 \
reboot
:::

:::info{title="luci-app-advenced-reboot"}
Reboot to alternative partition...
:::

然后就简单啦，和更新OP时候一样，在 Backup/Flash Firmware 界面 选择 Flash new firmware image 上传刚刚保存的 FW_MR9000_1.1.3.210125_prod.img ，开刷。

![Screenshot 2025-06-02 at 20.58.28.png](/static/img/689364de485d1ab942a3993ce458e510.Screenshot%202025-06-02%20at%2020.58.28.webp)

或者也可以ssh 进去命令行：
```
rsync -avz /path/to/folder/FW_MR9000_1.1.3.210125_prod.img root@openwrt_ip:/tmp/
```
```
ssh root@openwrt_ip
```
```
sysupgrade /tmp/FW_MR9000_1.1.3.210125_prod.img
```
大功告成，完美～ 👍👍👍

# 最后的最后

## MR9000 的警告
:::danger{title=""}
- MR9000 没有OP官方支持，是歪果仁大神在 IPQ4019 的固件源码基础上修改编译的
- 基于此，千万嫑手贱去更新 **ath10k-board-qca9984** 
- 别问我怎么知道的
:::
但是真的 更新了 ath10k-board-qca9984 也有办法补救：

![Screenshot 2025-06-03 at 09.42.50.png](/static/img/c3ca2f6e8300048efbfa58c9ed4c724c.Screenshot%202025-06-03%20at%2009.42.50.webp)

## 补救措施
:::tip{title=""}
```
cp /rom/lib/firmware/ath10k/QCA9984/hw1.0/board-2.bin /lib/firmware/ath10k/QCA9984/hw1.0/
cp /rom/lib/firmware/ath10k/QCA9984/hw1.0/firmware-5.bin /lib/firmware/ath10k/QCA9984/hw1.0/
ls -l /lib/firmware/ath10k/QCA9984/hw1.0/
reboot
```
:::

儿童节！Linksys MR9000X 救砖

前段时间折腾OpenWRT，自己瞎搞把 Velop WHW03 v2 的mtd搞坏了，是的，双固件都搞坏了。
坏到什么程度呢？什么连续开关4次、长按reset通电继续按住30秒等等的failsafe都无效，就是无论如何都启动不了的程度... 具体表现为：LAN口不停的连接、断开、连接、断开...

于是，查询 [OpenWRT官网资料](https://openwrt.org/toh/linksys/whw03_v2)，由于OpenWRT官网没有提供这台设备如何恢复原厂固件的详细步骤（其实根本没有），所以不得已只能再+ChatGPT+Gemini。

![linksys_whw03v2.jpg](/static/img/d922febf009eff4bd917fd6ba0f6cac6.linksys_whw03v2.webp)



# 拆解 Velop WHW03 v2，找到串口
## 1、拆解
这台 v2 并没有拆解图，需要参考 [whw03 v1](https://openwrt.org/toh/linksys/whw03_v1#opening_the_case) 步骤和照片图示基本一致，但要注意下面这个差异点：

:::tip{title="v2和v1在图4螺丝位置的差异"}
v1 的这颗螺丝在图示位置，而 v2 的在旁边白色的塑料延长脚上。

![whw03_v1_p3.jpeg](/static/img/11f7051c469abcb9fc71067d93224413.whw03_v1_p3.webp)
:::

要把这两块白色侧板推出来是真难，卡的非常紧，需要工具+巧劲，或者破拆准备😅
## 2、串口位置和定义
与 v1 的串口不同，v2 的串口是空孔位，没有安装针脚，因此我们需要的公头杜邦线。

![whw03v2_serial_pinout.jpeg](/static/img/2698ab5b1be8df42ec4c97972d31dbe9.whw03v2_serial_pinout.webp)

# 准备工作
## 1、连接设备串口
用 CH341A 作为 TTL-USB 转串口适配器，只需要 连接 GND、TX、RX 三根线 到路由器的 UART 接口：

:::info{title="具体如下"}
CH341A <---> 路由器 UART \
GND <---> GND \
TXD <---> RXD \
RXD <---> TXD
:::

## 2、准备原厂固件、启动TFTP服务
### 提前下载好Linksys原厂固件
[Linksys Velop whw03 v2 的原厂固件下载地址](https://downloads.linksys.com/support/assets/firmware/FW_WHW03_2.1.19.215389_prod.img) \
macOS默认浏览器下载位置是：`~/User/yourusername/Downloads/`
原厂固件的文件名是：`FW_WHW03_2.1.19.215389_prod.img`

### 启动 Mac TFTP 服务器
```
sudo launchctl load -w /System/Library/LaunchDaemons/tftp.plist
sudo launchctl start com.apple.tftpd
```

### 复制固件到 TFTP 目录
```
sudo cp ~/User/yourusername/Downloads/FW_WHW03_2.1.19.215389_prod.img /private/tftpboot/bronx.img
sudo chmod 666 /private/tftpboot/bronx.img
```
## 3、macOS实战
### 检查网卡接口

连接你的电脑到 WHW03 V2 的 LAN 口，并配置静态 IP：

IP: 192.168.1.100 \
Netmask: 255.255.255.0 \
Gateway: 192.168.1.1

### 插入 CH341A 适配器，terminal输入：
```
ls /dev/tty.*
```
你应该会看到一个类似：
`/dev/tty.usbserial-XXXXX` 的输出结果

### 使用 screen 连接（MacOS 默认支持）
```
screen /dev/tty.usbserial-XXXXX 115200
```
### 进入 U-Boot

在 screen 终端里，重新上电设备，并在启动过程中不断按 Ctrl+C 或 Enter，尝试进入 U-Boot 命令行。
它应该会进入交互模式，并显示：
`(IPQ40xx) #`

#### 输入下列命令
```
printenv
```
得到输出如下：
```
altkern=a800000
auto_recovery=yes
baudrate=115200
boot_part=2
bootargs=init=/sbin/init rootfstype=ubifs ubi.mtd=alt_rootfs root=ubi0:ubifs rootwait rw
bootcmd=if test $auto_recovery = no; then bootipq; elif test $boot_part = 1; then run bootpart1; else run bootpart2; fi
bootdelay=2
bootpart1=set bootargs $partbootargs && nand read $loadaddr $prikern $kernsize && bootm $loadaddr
bootpart2=set bootargs $partbootargs2 && nand read $loadaddr $altkern $kernsize && bootm $loadaddr
fdt_high=87000000
flash_type=2
flashimg=tftpboot $loadaddr $image && nand erase $prikern $imgsize && nand write $loadaddr $prikern $filesize
flashimg2=tftpboot $loadaddr $image && nand erase $altkern $imgsize && nand write $loadaddr $altkern $filesize
image=nodes_v2.img
imgsize=a100000
ipaddr=192.168.1.11
kernsize=d00000
loadaddr=81000000
machid=8010006
maxpartialboots=3
partbootargs=init=/sbin/init rootfstype=ubifs ubi.mtd=rootfs root=ubi0:ubifs rootwait rw
partbootargs2=init=/sbin/init rootfstype=ubifs ubi.mtd=alt_rootfs root=ubi0:ubifs rootwait rw 
prikern=700000
serverip=192.168.1.100
stderr=serial
stdin=serial
stdout=serial

Environment size: 1172/524284 bytes
```

### 擦除并写入固件

在上面我们得到的环境变量 flashimg 和 flashimg2 预设了 NAND Flash 操作，我们可以直接使用它：

#### 如果要刷入 主固件分区：
```
setenv image bronx.img
run flashimg
```
#### 如果要刷入 备用固件分区：
```
setenv image bronx.img
run flashimg2
```
flashimg 对应 prikern=700000，flashimg2 对应 altkern=a800000。
### 设置 U-Boot 启动分区

如果刷入 prikern（主分区）：
```
setenv boot_part 1
saveenv
```
如果刷入 altkern（备用分区）：
```
setenv boot_part 2
saveenv
```
### 重启设备
```
reset
```
至此，我们的工作已完成，设备应该正常启动到原厂固件。
# 补充：正常启动，但双固件都刷成OpenWRT的恢复原厂固件办法
OpenWRT官方没写，我借鉴参考了MX5300的办法，稍作变通
## Reset to stock firmware

:::warning{title="注意"}
Flashing the factory Linksys firmware does NOT work with sysupgrade (LuCI or CLI) and MAY render your device inoperable.
:::
### mtd on OpenWrt
1. Download the stock firmware for the device and copy it to the /tmp directory on the device. 1.1 If you saved the stock firmware to your computer, use scp -O firmware.img root@192.168.1.1:/tmp. Replace firmware with the actual file name and 192.168.1.1 with the actual IP address.
2. 先在Advanced reboot界面看好，自己现在是运行在哪个分区上


![Screenshot 2025-06-07 at 17.06.32.png](/static/img/91495aaf73119ea2cebb94d650968086.Screenshot%202025-06-07%20at%2017.06.32.webp)
3. 命令行查看mtd
输入`cat /proc/mtd`回车
```
cat /proc/mtd
dev:    size   erasesize  name
mtd0: 00100000 00020000 "SBL1"
mtd1: 00100000 00020000 "MIBIB"
mtd2: 00100000 00020000 "QSEE"
mtd3: 00080000 00020000 "CDT"
mtd4: 00200000 00020000 "APPSBL"
mtd5: 00080000 00020000 "ART"
mtd6: 00080000 00020000 "u_env"
mtd7: 00040000 00020000 "s_env"
mtd8: 00040000 00020000 "devinfo"
mtd9: 0a100000 00020000 "kernel"
mtd10: 09b00000 00020000 "rootfs"
mtd11: 0a100000 00020000 "alt_kernel"
mtd12: 09b00000 00020000 "alt_rootfs"
mtd13: 00200000 00020000 "sysdiag"
mtd14: 0b500000 00020000 "syscfg"
```
4. 假设Current是在分区02，那么我们刷01（Alternative）
```
cd /tmp
mtd -e kernel write firmware.img kernel
reboot
```
5. 如果想要全部恢复，那么就把alt_kernel和alt_rootfs都刷一遍
```
cd /tmp
mtd -e kernel write firmware.img kernel
mtd -e alt_kernel write firmware.img alt_kernel
reboot
```
# 写在最后

:::tip{title="提示"}
用 UART 刷写固件的好处是：它可以在刷写过程中自动跳过nand的坏块，让固件可以继续写入运行，这一点是其他方式刷入固件做不到的。
:::

Linksys Velop WHW03 v2 恢复Linksys原厂固件

![Screenshot 2024-08-18 at 19.25.48.png](/static/img/e8d1327aa83aec5621ac30c3b4d7dc3a.Screenshot%202024-08-18%20at%2019.25.48.webp)
Docker不仅仅只能本地管理，也可以远程连接，很多应用就需要用到它，但是默认的连接端口2375并不加密，总感觉不安全，所以我们需要开启TLS并使用2376端口。

具体操作步骤：


# 使用 OpenSSL 创建 CA、服务器和客户端密钥
首先，在远端的docker宿主主机上新建个文件夹，保存生成的 CA 私钥和公钥文件：

```
mkdir ~/ca
cd ~/ca
```
## 使用OpenSSL生成 CA 私钥和公钥文件
依次执行以下命令：
```
openssl genrsa -aes256 -out ca-key.pem 4096
```
这里需要输入一个密码，请牢记这个密码，后面要用到
```
openssl req -new -x509 -days 3650 -key ca-key.pem -sha256 -out ca.pem
```
这里需要输入密码、国家、省、市、组织、单位、Common name、邮箱等。Common name填写 ip地址
```
openssl genrsa -out server-key.pem 4096
```
```
openssl req -subj "/CN=$HOST" -sha256 -new -key server-key.pem -out server.csr
```
注意，将/CN=后面的$HOST替换成docker所在主机的域名或者IP地址。
## 使用 CA 签署公钥
```
echo subjectAltName = DNS:$HOST,IP:0.0.0.0 >> extfile.cnf
```
同样要替换$HOST为docker所在主机的域名或者IP地址

由于这是服务器公钥，所以这里的IP是指服务器IP。上面是允许所有IP远程访问，也可以只允许指定的IP访问。例如，只允许192.88.9.8进行连接

将 Docker 守护程序密钥的扩展使用属性设置为仅用于服务器身份验证：
```
echo extendedKeyUsage = serverAuth >> extfile.cnf
```
## 生成签名证书
```
openssl x509 -req -days 3650 -sha256 -in server.csr -CA ca.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem -extfile extfile.cnf
```
## 继续创建客户端密钥和证书签名请求：
```
openssl genrsa -out key.pem 4096
```
```
openssl req -subj '/CN=client' -new -key key.pem -out client.csr
```
## 要使密钥适合客户端身份验证，请创建一个新的扩展配置文件：
```
echo extendedKeyUsage = clientAuth > extfile-client.cnf
```
## 现在，生成签名证书：
```
openssl x509 -req -days 3650 -sha256 -in client.csr -CA ca.pem -CAkey ca-key.pem -CAcreateserial -out cert.pem -extfile extfile-client.cnf
```
## 生成后cert.pem，server-cert.pem您可以安全地删除两个证书签名请求和扩展配置文件：
```
rm -v client.csr server.csr extfile.cnf extfile-client.cnf
```

:::tip{title="默认umask值为 022，您的密钥对您和您的组来说是世界可读和可写的。"}
为保护您的密钥免受意外损坏，请移除其写入权限。要使它们只能由您读取，请按如下方式更改文件模式：
:::
```
chmod -v 0400 ca-key.pem key.pem server-key.pem
```
证书可以是全世界可读的，但您可能希望删除写入权限以防止意外损坏：
```
chmod -v 0444 ca.pem server-cert.pem cert.pem
```
# 让 Docker daemon只接受来自提供 CA 信任的证书的客户端的连接
## 把dockerd要用到的文件找个地方单独存放：
```
cp {ca,server-*}.pem /etc/docker/
```
## 在启动docker daemon时开启TSL认证，并指定ca、公钥秘钥：
:::tip{title="注意：基于 TLS 的 Docker 应该在 TCP 端口 2376 上运行。"}
:::
## 使用service
一般是使用service管理docker daemon，配置：
```
vim /lib/systemd/system/docker.service
```
### 修改ExecStart为如下：
`ExecStart=/usr/bin/dockerd -H fd:// -H unix:///var/run/docker.sock --containerd=/run/containerd/containerd.sock --tlsverify --tlscacert=/etc/docker/ca.pem --tlscert=/etc/docker/server-cert.pem --tlskey=/etc/docker/server-key.pem -H tcp://0.0.0.0:2376`

:::tip{title="修改后记得reload一下"}
:::
```
systemctl daemon-reload
```
重启docker daemon服务：
```
systemctl restart docker
```
# 客户端设置
## 将客户端密钥和签名证书拉取到客户端
使用scp命令拉取服务器上的客户端秘钥和签名证书：
```
C:\Users\xxx> scp root@$HOST:~/ca/{ca,cert,key}.pem ./.ca/docker
```
同样将 $HOST 替换成docker daemon所在服务器的ip或域名

Docker开启TLS保护的安全远程连接

![Screenshot 2024-08-16 at 15.44.21.png](/static/img/89376b2540988daf5f819007c4ed3485.Screenshot%202024-08-16%20at%2015.44.21.webp)
> 更新至官方 24.10.0 版本、arm 架构编译为例，若为其他平台（x86、树莓派等其他架构）则下文中获取内核的魔法值、菜单配置需自行更改



# 准备工作
## 环境
- 系统：Ubuntu 24.04.2 LTS (GNU/Linux 6.11.0-24-generic x86_64)
- 网络：科学上网
- 磁盘：大约有 70G 的空闲空间
- 内存：至少 4G 物理内存
- CPU：越快越好，影响编译速度
## 依赖
:::tip{title="以 root 用户执行以下命令或者有 root 权限的用户运行以下命令"}
:::
> **Debian / Ubuntu / Mint**

Modernized set for Ubuntu 24.04 that has Python 3.12 without python3-distutils: (OpenWrt main/master in Apr 2024)

```
sudo apt update
sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses5-dev libssl-dev \
python3-setuptools rsync swig unzip zlib1g-dev file wget
```
## 源码
:::tip{title="以下命令以普通用户执行，不要用 root"}
:::
先进入自己的工作目录，例如我的是`~/Downloads`

```
cd Downloads
```

:::warning{title="注意"}
git clone **不要**用 `--depth=1` 参数，这是非常愚蠢的行为，因为它会导致你编译的 base-files 版本号与官方不一致！
:::
> 下载源码（`-b` 指定分支/标签、 `--single-branch` 仅下载单个分支/标签、 ~~`--depth=1` 只下载最新的一次提交~~ ）
```
git clone -b openwrt-24.10 https://github.com/openwrt/openwrt.git openwrt-24.10
```
> 进入到该目录
```
cd openwrt-24.10
````
# 配置
## vermagic
:::tip{title="编译时，一定会遇到内核的魔法值不一样，需要完成如下修改："}
:::
### 获取值
获取值时，要注意后续选择平台，本文以 arm 平台为例
> 方式一：(不知什么原因，该方式失效)

~~执行以下脚本即可写入到 vermagic 文件中。注意： 24.10.0 为版本号~~
```
curl -s https://downloads.openwrt.org/releases/24.10.0/targets/ipq40xx/generic/openwrt-24.10.0-ipq40xx-generic.manifest | grep kernel | awk '{print $3}' | awk -F- '{print $3}' > vermagic
```
> 方式二：

1. 打开官方对应版本的下载链接：https://downloads.openwrt.org/releases
2. 点击：24.10.0 -> targets -> ipq40xx -> generic 页面最底下
3. 下载 Supplementary Files 中的 openwrt-24.10.0-ipq40xx-generic.manifest 文件
4. 使用文本编辑器打开该文件，记录下 kernel 最后面的字符串（不包含版本号“6.6.73-1-”）
5. 执行以下脚本写入到 vermagic 文件中 \

#### ipq40xx
```
echo '60aeaf7e722ca0f86e06f61157755da3' > vermagic
```
#### qualcommax-ipq807x
```
echo 'fe73d0be6a246a6dcf1bbde8cd8b0d43' > vermagic
```
### 修改内核配置文件
> 编辑配置文件
```
vim include/kernel-defaults.mk +130
```
> 找到这一行，然后注释掉！
```
# grep '=[ym]' $(LINUX_DIR)/.config.set | LC_ALL=C sort | $(MKHASH) md5 > $(LINUX_DIR)/.vermagic
```
> 再在下一行添加如下内容
```
cp $(TOPDIR)/vermagic $(LINUX_DIR)/.vermagic
```
## 时区
> 编辑配置文件
```
vim package/base-files/files/bin/config_generate +315
```
> 修改时区为 CST-8
```
set system.@system[-1].timezone='CST-8'
```
> 再在下一行添加如下内容
```
set system.@system[-1].zonename='Asia/Shanghai'
```
## 默认IP
默认管理IP为 192.168.1.1 ，可以根据自己的需求进行修改
> 编辑配置文件
```
vim package/base-files/files/bin/config_generate +165
```
> 修改如下内容
```
lan) ipad=${ipaddr:-"192.168.50.1"} ;;
```
## 软件包
### 更新软件包源
每次编译之前，都需要执行以下代码更新 feeds 包
```
./scripts/feeds update -a
./scripts/feeds install -a
```
### 添加第三方软件有两种方式：

1. 将软件包仓库地址写入 feeds.conf.default 文件中，可以参考 kenzok8 的软件包的说明文档
2. 使用 git clone 手动下载软件包放入到 package 文件夹中(本人使用这种方式)
- 添加 nft-fullcone 软件包（Kernel modules -> Netfilter Extensions -> kmod-nft-fullcone）
```
git clone https://github.com/fullcone-nat-nftables/nft-fullcone.git package/nft-fullcone
```
- 添加 passwall2 软件包和依赖包
```
git clone https://github.com/xiaorouji/openwrt-passwall2.git package/luci-app-passwall2
```
```
git clone https://github.com/xiaorouji/openwrt-passwall-packages.git package/passwall-packages
```
- 添加 natmapt 软件包（Network -> natmapt）
```
git clone --branch master --single-branch --no-checkout https://github.com/muink/openwrt-natmapt.git package/natmapt
```
- 添加 luci-app-natmapt 软件包（LuCI -> Applications -> luci-app-natmapt）
```
git clone --branch master --single-branch --no-checkout https://github.com/muink/luci-app-natmapt.git package/luci-app-natmapt
```
- 添加 stunman 软件包（Network -> stuntman）
```
git clone --branch master --single-branch --no-checkout https://github.com/muink/openwrt-stuntman.git package/stuntman
```
- 添加 luci-app-log-viewer 软件包
```
git clone https://github.com/gSpotx2f/luci-app-log.git package/luci-app-log-viewer
```
- 添加 luci-theme-argon 软件包
```
git clone https://github.com/jerrykuku/luci-theme-argon.git package/luci-theme-argon
```
- 添加 luci-app-advanced 软件包
```
git clone https://github.com/sirpdboy/luci-app-advanced.git package/luci-app-advanced
```
- 添加 luci-app-adguardhome 软件包
```
git clone https://github.com/xiaoxiao29/luci-app-adguardhome.git package/luci-app-adguardhome
```
- 添加 fastfetch 软件包（Utilities -> fastfetch）
```
git clone --branch master --single-branch --no-checkout https://github.com/muink/openwrt-fastfetch.git package/fastfetch
```
3. 所有添加的软件包，都执行一下下面的命令，否则有可能make menuconfig可能会找不到
```
pushd package/xxx
umask 022
git checkout
popd
```

## 菜单配置
执行以下命令打开菜单配置
```
make menuconfig
```
终于来到了一个图形化界面，该界面有如下操作

:::tip{title="提示"}
- `↑` `↓` 键：上下切换
- `PgUp` `PgDn` 键：上下翻页
- `Enter` 回车键：
-进入子菜单
-选择/确认
- `Sapce` 空格键：在 < > 上进行操作，按一次变为 <*>，按两次变为 < M >
- `Y` 键：选中，在 < > 上进行操作，操作后变为 <*>
- `N` 键：取消选中，在 <*> 上进行操作，操作后变为 < >
- `Esc` 键：连击两下，返回上层菜单，如果在主菜单则为退出配置
:::
配置根据自己的需要进行选择
- Target System -> Qualcomm Atheros IPQ40XX
- Subtarget -> generic
- Target Profile -> Linksys WHW03 V2
- [*] Package the OpenWrt-based Toolchain   
- Base system --->
 
    < > dnsmasq
    
    <*> dnsmasq-full
- Kernel modules  ---> Netfilter Extensions  --->

     \<M> kmod-nft-fullcone
     
     {M} kmod-nft-compat
- LuCI  ---> Collections --->
    
    <*> luci    
- LuCI  ---> Collections ---> Modules ---> 
    
    <*> luci-base
- LuCI  ---> Collections ---> Modules ---> Translations  --->
    
    <*> Chinese Simplified
    
    

:::warning{title="注意"}
- 尽量不要把软件包写入rootfs，即 \" * \"，应该选择 \" M \" 。因为 \" * \" 会增加rootfs的磁盘占用，让生成的固件体积变大，进而导致磁盘**可用空间减少**。 \
- 由于squashfs格式编译的固件中rootfs是只读的，因此这些写入rootfs的软件包即使你手动remove了，它也仅仅是被系统标注为隐藏不可见而已，并**不会释放空间**。 \
- 如果你opkg upgrade任何一个已经存在于rootfs的软件包，同样也会将原始软件包标注为隐藏，然后在/overlay中另外安装一份新版本，那么这个软件包实际占用的空间**大致等于2倍**。
:::
> 如果不小心配错了，可以执行以下命令重新配置

```
rm -rf ./tmp && rm -rf .config
make menuconfig
```
> 如果想要清除以前旧的配置和缓存，可以使用以下命令

:::tip{title="仅清理编译结果（bin目录）"}
```
make clean
```
:::
:::tip{title="清理所有编译文件（除了.config、dl文件夹和feeds以外都清理）"}
```
make dirclean
```
:::
:::tip{title="清理所有编译文件以及相关依赖（完全清理干净，一键回到刚git clone下来的时候）"}
```
make distclean
```
:::
:::tip{title="还原使用make menuconfig对配置文件.config进行的调整"}
```
make defconfig
```
:::
## 预下载
:::tip{title="为了防止ssh连接因各种原因断开导致命令中断，务必采用tmux命令"}
```
tmux new -s openwrt
```
:::
先把编译时需要的文件下载下来（只是一部分，后面编译阶段还会下载，仍需保持网络畅通）

```
make download -j$(nproc)
```
# 编译
## 编译固件
接下来就要进入漫长的编译时间了，使用 -j 参数可以指定编译时使用的线程数

亲测Thinkpad X1 Carbon i5 线程全开需要接近1小时完成
> 根据CPU核心数开启指定线程数执行编译
```
make V=s -j$(nproc)
```
> 如果编译过程中报错了，需要使用单线程模式，确认出错的地方，然后排查（注：有时候单线程就不报错了）
```
make V=s -j1
```
## 单独编译某个软件包

1. `make menuconfig` \
Select the package LuCI -> Applications -> luci-app-xxxx 
2. `make package/luci-app-xxxx/compile V=99`

:::tip{title="如果ssh连接中断，再次ssh到服务器，输入以下tmux命令恢复会话"}
```
tmux attach -t openwrt
```
:::
# 获取成果

编译完成后，文件所在位置是：
`~/Downloads/openwrt/bin/targets/ipq40xx/generic/`