基于树莓派 4B 的 OpenWrt 软路由
- 概述
- 环境
- 拓扑
- 烧录
- 分区和硬盘容量
- 1. 进入分区工具
- 2. 分区操作(重点)
- 3. 挂载分区
- 树莓派风扇
- ✔ 设置开机自启
- ✔ 立即启动测试
- 插件安装
- 项目地址
- 静态 IP 配置
- 服务器侧操作
概述
本文档记录了在树莓派 4B 上部署 OpenWrt 作为旁路由的全流程,包括系统烧录、分区扩容、风扇控制、插件安装以及下游服务器的网络配置。
环境
树莓派 4B,4GB 内存,32GB 的 TF 卡
OpenWrt 25.12.2
拓扑
主路由上接树莓派、电脑和服务器。电脑通过主路由上网,服务器通过树莓派(作为旁路由)上网。
烧录
进入 OpenWrt 官网,找到树莓派 4B 对应的系统。
网址:https://firmware-selector.openwrt.org/?version=25.12.2
搜索:raspberry Pi 4B/400/CM4 (64bit)
为了方便连接,在「首次启动时运行的脚本(uci-defaults)」里填入自定义的静态 IP 配置:
uci set network.lan.proto='static' uci set network.lan.ipaddr='在这里指定 IP 地址' uci set network.lan.netmask='在这里指定子网掩码' uci commit network /etc/init.d/network restart登录主路由后台,应该可以看到树莓派的网络信息,与指定的 IP 应当一致。
浏览器输入树莓派 IP,进入 OpenWrt 的网页端。无需输入密码,直接点「登录」进入后台,然后设置密码并开启 SSH 登录。
通过 SSH 登录树莓派,进行换源和网络配置。由于之前配置的静态 IP 不完整,此时无法上网,所以要先改为 DHCP 获取 IP。后续使用插件之前,再从网页端改回正确的静态 IP。
sed -i 's_https\?://downloads.openwrt.org_https://mirrors.tuna.tsinghua.edu.cn/openwrt_' /etc/apk/repositories.d/distfeeds.list uci set network.lan.proto='dhcp' uci delete network.lan.ipaddr uci delete network.lan.netmask uci delete network.lan.gateway uci delete network.lan.dns uci commit network /etc/init.d/network restart此时已能正常上网,可以到软件包中安装中文插件。
分区和硬盘容量
1. 进入分区工具
cfdisk /dev/mmcblk02. 分区操作(重点)
- 选中
/dev/mmcblk0p2,按Resize,把它缩小(保留 500MB 足够系统使用,手动输入结束位置即可) - 缩小后,末尾会出现大片 Free space
- 选中空闲空间 → 按New,一路回车,创建新分区
/dev/mmcblk0p3 - 按Write→ 输入
yes保存分区表 - 按Quit退出
3. 挂载分区
在下拉框里选择:作为外部 overlay 使用 (/overlay)
- 这个选项会把
/dev/mmcblk0p3分区挂载到/overlay,系统后续的所有配置、插件、数据都会存在这个 29G 的分区里。 - 注意:不要选「作为根文件系统使用 (/)」,这个选项会直接替换系统根目录,会导致系统无法正常启动。
点击右下角的「保存」→ 再点页面下方的「保存并应用」。
重启路由器。配置生效必须重启,执行:
reboot验证是否成功。重启后 SSH 登录,执行:
df -h正常情况下,你会看到/overlay已经挂载到/dev/mmcblk0p3,容量是 29G 左右,就说明扩容完成了。
树莓派风扇
接线:黑色线接 GND,红色接 5V,蓝色线接一个 PWM 管脚。
创建 init.d 启动脚本nano /etc/init.d/fan:
#!/bin/sh /etc/rc.common START=99 STOP=10 USE_PROCD=1 start_service() { procd_open_instance procd_set_param command /root/fan_control.sh procd_set_param respawn procd_close_instance } stop_service() { killall fan_control.sh 2>/dev/null }chmod +x /etc/init.d/fan✔ 设置开机自启
/etc/init.d/fan enable✔ 立即启动测试
/etc/init.d/fan start创建风扇控制脚本nano /root/fan_control.sh:
#!/bin/sh GPIO=530 TEMP_ON=50 TEMP_OFF=45 # 初始化GPIO if [ ! -d /sys/class/gpio/gpio$GPIO ]; then echo $GPIO > /sys/class/gpio/export fi echo out > /sys/class/gpio/gpio$GPIO/direction FAN_STATE=0 # 🧠 关键:退出时执行清理 cleanup() { echo 0 > /sys/class/gpio/gpio$GPIO/value echo "[EXIT] FAN OFF" exit 0 } trap cleanup INT TERM EXIT while true; do temp=$(cat /sys/class/thermal/thermal_zone0/temp) temp=$((temp / 1000)) echo "[TEMP] ${temp}°C | FAN_STATE=${FAN_STATE}" if [ $temp -ge $TEMP_ON ] && [ $FAN_STATE -eq 0 ]; then echo 1 > /sys/class/gpio/gpio$GPIO/value FAN_STATE=1 echo "[FAN] ON - ${temp}°C" fi if [ $temp -le $TEMP_OFF ] && [ $FAN_STATE -eq 1 ]; then echo 0 > /sys/class/gpio/gpio$GPIO/value FAN_STATE=0 echo "[FAN] OFF - ${temp}°C" fi sleep 5 donechmod +x /root/fan_control.sh插件安装
项目地址
https://github.com/vernesong/
由于 OpenWrt 是 25.12.2 版本,下载时选择nftables for apk版本。也可通过luci安装
静态 IP 配置
禁用 DHCPv4 服务和 DHCPv6 服务。
在 服务配置页面中记得开启 DNS代理。
服务器侧操作
以下配置适用于 RHEL/CentOS 系列 Linux 服务器(网卡配置文件路径为
/etc/sysconfig/network-scripts/ifcfg-eno1)。
nano /etc/sysconfig/network-scripts/ifcfg-eno1TYPE=Ethernet PROXY_METHOD=none BROWSER_ONLY=no BOOTPROTO=static DEFROUTE=yes IPV4_FAILURE_FATAL=no # 关闭IPv6 IPV6INIT=no NAME=eno1 UUID=b57d0ead-b8aa-4d11-91d7-a30757d80289 DEVICE=eno1 ONBOOT=yes IPADDR=服务器ip NETMASK=局域网的子网掩码 # 网关指向 OpenWrt GATEWAY=树莓派的地址 DNS1=树莓派的地址 DNS2=主路由的地址curl -I -4 https://www.baidu.com