Raspberry Pi ImmortalWrt 配置文档

Raspberry Pi ImmortalWrt安装与配置手册

适用于首次配置 ImmortalWrt 的完整文档,涵盖固件烧录、网络接入、OpenClash、备份和日常维护。各阶段均列出前置条件、操作步骤和验收标准。

适用设备:Raspberry Pi 4B / 400 / CM4;覆盖 OpenWrt 24.10 与 25.12 及更新版本

SETUP OVERVIEW

安装流程

  1. 01方案确认
  2. 02固件烧录
  3. 03网络配置
  4. 04OpenClash
  5. 05配置备份
  6. 06系统维护

文档重点

  • 明确阅读顺序
  • 区分 LAN 与 WAN
  • 按版本选择包管理器
  • 提供分步验收方法

使用场景

按当前状态选择文档

可从快速入门开始,也可根据当前配置进度直接查阅对应章节。

配置流程

安装与配置顺序

以下六个阶段覆盖基本部署流程。阅读进度保存在当前浏览器,无需登录。
阅读进度0/6 已完成
  1. 8 min
    部署准备

    确认硬件型号、网络角色和配置顺序。

    验收标准 · 已确定适用的网络方案
  2. 12 min
    固件选择与烧录

    选择设备和文件系统对应的镜像,写入 SD 卡并完成首次启动。

    验收标准 · LuCI 管理界面可以访问
  3. 15 min网络方案
    接入现有路由器

    由上级路由器负责互联网接入,树莓派通过以太网获取网络。

    验收标准 · 树莓派 Wi-Fi 客户端可以联网
  4. 18 min
    配置 OpenClash

    确认使用 opkg 或 apk,导入配置模板,填写订阅地址并验证分流。

    验收标准 · 代理与直连规则正常生效
  5. 10 min
    备份与恢复准备

    导出并验证配置备份,记录固件版本和需要单独重装的软件包。

    验收标准 · 已保存可用的配置备份
  6. 14 min系统维护
    系统维护

    建立健康检查、日志查看和定期维护流程。

    验收标准 · 已建立日常维护检查表

配置准备

配置前需要确认的事项

网络角色

上级路由接入与 PPPoE

已有路由器负责互联网接入时,使用上级 LAN 接入方案;树莓派直接负责拨号时,使用 PPPoE 方案。两种方案的接口配置不同。查看 PPPoE 配置

系统分支

24.10 使用 opkg,25.12 及更新版本使用 apk

执行安装命令前应先确认系统版本和包管理器。包管理命令不匹配时,报错通常与网络无关。查看版本检查方法

文件系统

根据恢复和扩容需求选择文件系统

写入新镜像会覆盖目标介质。配置能否保留取决于升级与备份流程,不能仅根据 EXT4 或 SQUASHFS 判断。查看固件选择说明

专题文档

配置与维护手册

网络、存储、代理和维护相关的专题说明,可在基本部署完成后按需查阅。

网络场景

接入、拨号与连接故障

3 篇文档

功能增强

代理、存储与高级配置

3 篇文档

备份与维护

恢复、监控和长期运行

3 篇文档

项目参考

脚本、规范和更新记录

3 篇文档

PROJECT SUPPORT

问题反馈

提交 Issue 时请附上设备型号、系统版本、网络拓扑、失败步骤和相关检查结果,以便定位问题。