配置文档
Raspberry Pi + ImmortalWrt
树莓派 ImmortalWrt 全流程文档站
从固件烧录、网络接入到 OpenClash、备份恢复与存储扩容，按真实使用场景拆分，并明确区分 `opkg` 与 `apk` 路线。
- 覆盖从刷机、联网到插件配置的完整路径。
- 提供智能备份、恢复、维护与排错方案。
- 中文/英文独立浏览，不再混排。
自动化脚本
1
备份与运维脚本说明更新记录
8
包含 docs/scripts/frontend 变更OpenWrt Version Split
先判断你的系统分支
现在很多教程失效，不是步骤错了，而是包管理器已经变了。仓库里的新版文档都会先分清 `24.10-` 和 `25.12+`，再给出对应命令。
查看 OpenClash 新手册24.10 及更早稳定版
继续使用 `opkg`。旧教程大多还是按这条路线写的。
25.12 及更新版本
改用 `apk`。不要再直接照抄旧的 `opkg install`。
推荐阅读路径
按你当前想解决的问题进入，不用从头到尾硬读一遍。
固件版本说明（Firmware Version Description）
ImmortalWrt-Raspberry Pi 4B/400/CM4 (64bit) Latest
EXT4 版本
完整覆盖安装，会清除所有现有配置。适合首次安装或需要完全重置系统。支持更大的存储空间和更好的数据恢复能力，但刷机后需重新配置。
SQUASHFS 版本
增量更新安装，保留用户已有配置。适合已配置好系统仅需升级固件的用户。占用更小、启动更快，但存储容量有限。
文档目录
按用途分组浏览，点击标题进入完整文档页面。
开始使用
从固件烧录到项目总览
网络与代理
LAN/拨号接入与 OpenClash 配置
备份与维护
备份策略、恢复流程和系统维护
- 备份与恢复
由于题主的SD卡是128GB，全部挂载到了Openwrt系统上，但整个系统一共消耗的资源只有287MB，有点大材小用了。遂计划备份后换到一个4GB的内存卡上。
docs/OpenWrt_Backup_Resotre.md - OpenWrt 系统维护与故障排查
文档说明 : 本文档记录树莓派 OpenWrt 软路由的日常维护、监控配置和故障排查方法。
docs/System_Maintenance.md - ImmortalWrt 存储扩容与分区指南
这篇文档用于回答 3 个最容易混淆的问题：
docs/Storage_Expansion_Guide.md - ImmortalWrt Overlay 与 Extroot 扩容（进阶版）
本文只适用于：
docs/ExtendOverlaySize.md - ImmortalWrt GitHub 自动备份（旧版参考）
说明：这篇文档保留为旧版参考，内容基于早期的 SSH + configs/ 明文快照方案。
docs/OpenWrt_AutoBackup.md
脚本与更新
部署脚本说明与更新日志索引
其他文档
补充资料