Repo Document

备份与恢复

由于题主的SD卡是128GB，全部挂载到了Openwrt系统上，但整个系统一共消耗的资源只有287MB，有点大材小用了。遂计划备份后换到一个4GB的内存卡上。

docs/OpenWrt_Backup_Resotre.md更新于 2026年4月12日
中文首页Switch To English

备份与恢复

由于题主的SD卡是128GB，全部挂载到了Openwrt系统上，但整个系统一共消耗的资源只有287MB，有点大材小用了。遂计划备份后换到一个4GB的内存卡上。

备份

  1. 前往系统设置填写备份列表。

  2. 在系统 -> 备份与升级 -> 生成备份 备份系统相关配置：（保存文件到本地）

如果备份文件只有170B那么这个大小一定是出错了！请把你的IDM或者NDM插件关掉，用浏览器默认下载。 备份结束。

如果在系统设置中导出了备份，那么openclash也会被包含在备份中；以下仅为单独备份插件的方式。（可以不用） 备份openclash相关配置：（保存文件到本地

备份结束。

恢复

拿出新卡 or U盘

恢复部分按顺序看，不要把下面几段拆成互不相关的章节。

  1. 先烧录固件。

烧录树莓派相关的版本的固件。请见Openwrt固件选择以及烧录教程

  1. 再恢复备份。

重要：如果您不执行以以下操作，直接从备份与恢复设置上传备份，会报错！且难以解决！最好的方式就是新系统自行安装好插件，再进行备份文件上传。

烧录固件后，请先配置好网络，即，openwrt能够更新软件包，并安装相关内容如下；

安装 cargo luci 主题，提升界面美观度（参考视频 33:12）https://www.youtube.com/watch?v=JfSJmPFiL_s&t=1992s

先判断系统版本：

  • OpenWrt 24.10 及更早稳定版：使用 opkg
  • OpenWrt 25.12 及更新版本 / 新分支：使用 apk

如果你只想尽快恢复系统，优先使用 LuCI 网页里的“软件包”页面搜索安装所需主题和插件，不必强行照抄旧脚本。

如果您自己会安装，请直接按照以下步骤操作：

系统--软件包--更新列表--没有报错--安装luci-theme-argon--安装luci-i18n-ttyd-zh-cn

插件安装：

  • luci-app-openclash
  • luci-i18n-passwall-zh-cn
  • luci-i18n-homeproxy-zh-cn
  • luci-i18n-quickstart-zh-cn

插件位置在：侧边栏的“服务”标签页。

如果你偏好命令行，可按系统版本执行：

# OpenWrt 24.10 及更早稳定版
opkg update
opkg install luci-theme-argon luci-app-openclash luci-i18n-passwall-zh-cn luci-i18n-homeproxy-zh-cn luci-i18n-quickstart-zh-cn

# OpenWrt 25.12 及更新版本 / 新分支
apk update
apk add luci-theme-argon luci-app-openclash luci-i18n-passwall-zh-cn luci-i18n-homeproxy-zh-cn luci-i18n-quickstart-zh-cn

imm.sh、is-opkg 这类第三方安装脚本更容易受版本切换影响。 如果你当前是 25.12+，先确认脚本作者是否已经适配 apk，不要默认把它们当成恢复前置步骤。

重要：如果您不执行以上操作，直接从备份与恢复设置上传备份，会报错！且难以解决！

安装好插件后，去系统设置中上传备份：

恢复结束。可以退出本文档了！

如果您是命令行选手，那么请跟我来。

如果你更习惯命令行，可以直接按下面这组步骤走。

  1. 给openwrt安装sftp服务：
# OpenWrt 24.10 及更早稳定版
opkg update
opkg install openssh-sftp-server

# OpenWrt 25.12 及更新版本 / 新分支
apk update
apk add openssh-sftp-server
  1. 安装luci-theme-argon后，在系统--备份与升级--上传备份。
  2. 安装插件（恢复前建议至少安装以下内容）：
# OpenWrt 24.10 及更早稳定版
opkg install luci-app-openclash luci-i18n-passwall-zh-cn luci-i18n-homeproxy-zh-cn luci-i18n-quickstart-zh-cn

# OpenWrt 25.12 及更新版本 / 新分支
apk add luci-app-openclash luci-i18n-passwall-zh-cn luci-i18n-homeproxy-zh-cn luci-i18n-quickstart-zh-cn
  1. 还原文件openclash配置(经实验，这个可以不用，openclash相关备份已经包含在系统备份中)

成功！

从 GitHub Configs 恢复配置 (高级)

我们的智能备份脚本 (smart_backup.sh) 除了生成 .tar.gz 压缩包外，还会将 /etc/config/ 下的配置文件解压到 GitHub 仓库的 configs/ 目录中。

这有什么用？

  • 版本对比: 你可以在 GitHub 上直接看到每次备份改了什么参数。
  • 单文件恢复: 如果你只改坏了一个配置（比如 network），不需要回滚整个系统，只需恢复这一个文件。

这部分按使用场景看就够了，不需要再把它理解成新的大章节。

  1. 恢复单个配置文件。

假设你把网络设置 (/etc/config/network) 改坏了，导致连不上网，或者配置错乱。

  1. 在 GitHub 上找到文件:

    • 打开你的备份仓库。
    • 进入 configs/ 目录。
    • 找到 network 文件。
    • 点击 "Raw" 按钮，复制内容。

  2. 在路由器上恢复:

    • SSH 登录路由器。
    • 编辑文件并粘贴内容： 
      vi /etc/config/network
# 按 dG 删除所有内容
# 按 i 进入插入模式
# 粘贴 GitHub 上的内容
# 按 Esc，输入 :wq 保存退出
    • 或者直接用 cat 覆盖 (如果你能复制粘贴)： 
      cat > /etc/config/network <<EOF
# 在这里粘贴内容
EOF

  3. 应用更改:

    /etc/init.d/network restart

  4. 批量恢复所有配置。

如果你想把整个 /etc/config 目录回滚到 GitHub 上的某个版本：

  1. 进入备份目录:

    cd /root/immortalwrt-backup

  2. 拉取最新代码:

    git pull origin master

  3. 覆盖系统配置:

    # 警告：这将覆盖你当前所有的系统设置！
cp -r configs/* /etc/config/

  4. 重启相关服务或系统:

    reboot