配置文档
Raspberry Pi + ImmortalWrt
树莓派 ImmortalWrt 全流程文档站
从固件烧录、网络接入到 OpenClash 与备份恢复，按真实使用场景拆分，降低新手踩坑概率。
- 覆盖从刷机、联网到插件配置的完整路径。
- 提供智能备份、恢复、维护与排错方案。
- 中文/英文独立浏览，不再混排。
自动化脚本
1
备份与运维脚本说明更新记录
3
包含 docs/scripts/frontend 变更固件版本说明（Firmware Version Description）
ImmortalWrt-Raspberry Pi 4B/400/CM4 (64bit) Latest
EXT4 版本
完整覆盖安装，会清除所有现有配置。适合首次安装或需要完全重置系统。支持更大的存储空间和更好的数据恢复能力，但刷机后需重新配置。
SQUASHFS 版本
增量更新安装，保留用户已有配置。适合已配置好系统仅需升级固件的用户。占用更小、启动更快，但存储容量有限。
文档目录
按用途分组浏览，点击标题进入完整文档页面。
开始使用
从固件烧录到项目总览
- 树莓派 OpenWrt 软路由配置指南
从零开始，打造属于你的全屋智能网关
README.md - 烧录固件工具及步骤
固件源：ImmortalWrt Firmware Selector
docs/Write_Image.md
网络与代理
LAN/拨号接入与 OpenClash 配置
- LAN 连接（上级路由 LAN 接入场景）
本文用于：让树莓派上的 ImmortalWrt 通过上级路由器上网，同时其它设备连接树莓派提供的 Wi-Fi 后也可以正常上网。
docs/Lan_Connectioin.md - Openclash_Config
具体配置细节还请见README文档中的Youtube视频，博主有空会直接配置好把固件发出来的。
docs/Openclash_Config.md - PPPoE_Connection
如果要家庭拨号，那么此时的软路由做主路由。相关的拨号账户的获取，这里不再展开。请见桥接模式的教程。
docs/PPPoE_Connection.md
备份与维护
备份策略、恢复流程和系统维护
- ImmortalWrt TF 卡系统的安全扩容
下面为一份 最简洁、完整、无坑版的扩容教程 ，包含从分区、格式化、挂载到验证的全部命令。
docs/ExtendOverlaySize.md - ImmortalWrt 智能自动备份 (Smart Backup)
脚本功能 :
docs/OpenWrt_AutoBackup.md - 备份与恢复
由于题主的SD卡是128GB，全部挂载到了Openwrt系统上，但整个系统一共消耗的资源只有287MB，有点大材小用了。遂计划备份后换到一个4GB的内存卡上。
docs/OpenWrt_Backup&Resotre.md - OpenWrt 系统维护与故障排查
文档说明 : 本文档记录树莓派 OpenWrt 软路由的日常维护、监控配置和故障排查方法。
docs/System_Maintenance.md
脚本与更新
部署脚本说明与更新日志索引
- 🌐 ImmortalWrt 智能自动备份 (Smart Backup)
脚本名称 : /root/smart backup.sh
scripts/README.md - 更新日志
本目录记录项目的重要变更和更新历史。
changelogs/README.md