简介现代 Web 管理 · A/B 双槽防变砖 · 一套固件覆盖 6 款 BPI 路由板项目内容名称BpiRouter OS类型Banana Pi 路由器板的统一固件 Web 管理系统底层系统OpenWrt v25.12.2Linux 内核 6.12支持设备BPI-R4 / R4-Lite / R4 Pro / R3 / R3 Mini / OpenWrt One界面语言中文 / 英文默认地址https://192.168.100.1状态6 款板已完成真机验收1. 这是什么BpiRouter OS是为 Banana Pi 路由器系列打造的一套统一固件——在 OpenWrt 之上提供一个现代化的图形 Web 管理界面以及一套防变砖的固件升级与恢复机制。它要解决两个痛点裸 OpenWrt / LuCI 对普通用户不友好→ 我们提供对标消费级精品路由的图形界面开箱即用的配置向导常用功能一屏可达。路由器刷固件容易刷坏、变砖难救→ 我们提供固件 A/B 双槽 在线升级失败自动回退 四层恢复阶梯刷坏也救得回。一套固件6 款板通用同一个 Web 界面与功能运行在全部 6 款 BPI 路由板上板间差异只在硬件层由固件按板自动适配。2. 为什么选 BpiRouter OS亮点说明️现代 Web 管理界面Vue 3 图形界面响应式电脑/平板/手机深色模式中英双语常用功能开箱即用️A/B 双槽防变砖双固件槽在线升级写入备用槽并试运行失败自动回退到上一个好版本刷坏不变砖四层恢复阶梯从配置回滚到整机救砖逐级兜底——坏配置、坏固件都能救回出厂状态企业级安全多用户角色权限、登录防爆破、操作审计日志、全程 HTTPS功能齐全网络/无线/VPNWireGuard OpenVPN/防火墙/端口转发/DDNS/诊断一应俱全6 板统一一套固件覆盖 6 款 BPI 路由板体验完全一致3. 支持的设备设备芯片主要硬件能力BPI-R4MediaTek MT7988A2×10G SFP 4×千兆Wi-Fi 7BPI-R4 LiteMediaTek MT7987AWi-Fi 7出厂 BE14 三频需 12V 供电BPI-R4 Pro (8X)MediaTek MT7988A8GB 内存4×2.5G 10G WAN系统状态灯BPI-R3MediaTek MT7986AWi-Fi 6多介质SD/NAND/eMMCBPI-R3 MiniMediaTek MT7986AWi-Fi 62.5G PHY紧凑无 SD 卡槽OpenWrt OneMediaTek MT7981BWi-Fi 6纯 NAND全部 6 款均已完成「固件 A/B 在线升级回退 四层恢复」的真机验收。4. 功能总览4.1 开箱即用首次配置向导全新设备开机自动进入向导3 步设好上网方式DHCP / 静态 / 宽带拨号、WiFi、管理密码。仪表盘一屏总览 CPU/温度/内存/存储、联网状态、客户端数、实时上下行流量曲线自动刷新。4.2 网络与无线上网WANDHCP / 静态 IP / PPPoE 宽带拨号IPv4 IPv6 双栈。局域网LANLAN IP、DHCP 地址分配地址池/租期。无线多频段管理2.4G / 5G / 6G信道/带宽/功率/国家码SSID 与加密6GHz 强制 WPA3/OWE。已连接设备实时查看接入设备的 IP / MAC / 主机名 / 在线状态。4.3 安全上网VPN内置WireGuard与OpenVPN——两种协议可同时启用既能做客户端连到远程 VPN也能做服务端让本机成为 VPN 服务器。服务端可自定义监听端口与地址段一键生成客户端配置 二维码手机 App 扫码即连并支持客户端列表查看与吊销。端口转发把外网端口映射到内网设备。DMZ把所有外网入站流量转给指定内网主机。防火墙规则自定义放行 / 拒绝 / 丢弃规则。DDNS动态公网 IP 绑定固定域名支持 DuckDNS / No-IP / Dynu / Cloudflare / FreeDNS。4.4 系统管理主机名 / 时区 / 系统时间时区从下拉列表选择可搜索时间自动 NTP 对时也支持手动设置 / 用浏览器时间同步无 RTC、离线场景兜底校时。改密、重启。关键改动二次确认网络 / WiFi / 防火墙等可能切断管理连接的改动可开启「保存后限时确认」——改错导致掉线时会自动回滚默认开启。固件升级A/B 双槽 A/B 双槽见 §5、配置备份与恢复、恢复出厂。诊断工具Ping / Traceroute / DNS 查询结果直接在界面查看。系统日志。4.5 多用户与审计三种角色管理员全部/ 操作员日常配置/ 观察员只读。权限最小化观察员看不到也改不了配置。审计日志仅管理员记录登录、权限拒绝、配置变更、固件升级、用户管理等安全相关操作可事后追溯不记录任何密码/密钥。5. 可靠性永不变砖的升级与恢复这是 BpiRouter OS 最核心的差异化能力。路由器固件最怕「升级刷坏、远程变砖、要寄回返修」——我们用双槽 四层兜底根除这个风险。5.1 固件 A/B 双槽升级设备有两个固件槽。在线升级时新固件写入备用槽不动当前正在运行的槽自动重启进入新固件界面弹出「升级待确认」横幅带倒计时确认一切正常 → 点「确认升级」转正若不确认比如新固件网络不通、人不在场→ 倒计时到点自动回退到升级前的固件和配置。升级前会自动校验固件不兼容的镜像直接拒绝可选「保留配置」让设置随升级延续。5.2 四层恢复阶梯从软到硬逐级兜底层级触发方式效果L1 配置回滚自动改了导致掉线的配置 → 限时未确认自动撤销L2 固件自动回退自动坏固件启动失败 → 引导自动切回上一个好固件槽L3 恢复出厂运行中长按恢复键约 5 秒清除当前配置回出厂不重刷固件L4 整机救砖断电 → 按住恢复键 → 上电并持续按住从内置黄金镜像把整机刷回出厂结果即使配置和固件都损坏L4 也能把设备救回出厂状态——刷坏也救得回不会永久变砖。恢复键因板而异BPI-R4 使用WPS 键R4-Lite / R4 Pro / R3 / R3 Mini 使用物理 reset 键。详见各板说明。6. 安全特性全程 HTTPS自签名证书首次访问确认一次即可。现代认证JWT 登录态1 小时过期密码安全校验。登录防爆破同一来源连续失败后逐次延时最长 60 秒有效阻止暴力破解。角色权限RBAC方法级最小权限 默认拒绝越权操作后端兜底拦截即便绕过界面也无效。操作审计安全相关动作全程留痕且不记录任何敏感参数。7. 界面与使用体验多语言中文 / 英文即时切换。深色模式浅色 / 深色护眼。响应式电脑、平板、手机自适应手机端侧边栏自动折叠。顺滑反馈升级 / 回退 / 重启 / 恢复出厂等整机操作有全屏进度提示与「掉线→上线」探测过程不留白屏。高级后路保留原生 LuCI 入口本界面未覆盖的高级/诊断场景可一键转 LuCI。8. 快速开始详细步骤见对应子页烧录指南、首次配置、恢复与救砖。8.1 烧录到设备从下载页见 §11获取对应板型的固件镜像。按板型烧录有 SD 卡槽的板R4 / R4-Lite / R4 Pro / R3把安装镜像写入 SD 卡按拨码引导依次写入 NAND、再装入 eMMC。无 SD 卡槽 / 纯 NAND 板R3 Mini / OpenWrt One经串口 U 盘灌入随固件提供 flashkit 工具与逐步说明。详细的拨码、灯态、逐步流程见 [烧录指南]。8.2 首次配置浏览器打开https://192.168.100.1首次会有一次证书安全提示确认继续。自动进入配置向导依次设置上网方式 → WiFi 名称/密码 → 管理员密码。完成后自动进入仪表盘开始使用。9. 已知限制我们坚持如实告知当前版本的已知限制BPI-R4 Pro10G combo-LAN 口暂不可用— 该多速率组合口目前只能作 WAN已验证可用暂不能作 LAN。不影响 4×2.5G 网口与面板口正常使用后续版本将放开。BPI-R4 Pro2.5G 口「独立使用」不加入网桥转发不通— 默认部署下 2.5G 口都在 LAN 网桥内、工作正常若要把某口单独当独立网段/WAN当前版本不支持。其余功能在 6 款板上均已通过真机验收。10. 技术规格项目内容底层系统OpenWrt v25.12.2 / Linux 6.12架构aarch64ARM 64 位后端Go 单体服务JSON-RPC 2.0前端Vue 3 Naive UIWeb服务NginxTLS 终端 反向代理 LuCI 共存VPNWireGuard、OpenVPN含 PKI / 证书吊销升级机制固件 A/B 双槽 在线 OTA 四层恢复BpiRouter OS 构建于 OpenWrt 之上完整复用 OpenWrt 的驱动与软件生态在其之上提供统一的 Web 管理界面与防变砖的固件升级/恢复体系。11. 下载与资源固件下载BPI-R4: openwrt-mediatek-filogic-bananapi_bpi-r4-sdcard.imgopenwrt-mediatek-filogic-bananapi_bpi-r4-squashfs-sysupgrade.itbBaidu : 百度网盘 请输入提取码 提取码: 8888Google: https://drive.google.com/drive/folders/1_H2FaK_btdSv0Ofc9F7hLDwgyUr0x6sH?uspsharingBPI-R4 PRO-8X:openwrt-mediatek-filogic-bananapi_bpi-r4-pro-8x-sdcard.imgopenwrt-mediatek-filogic-bananapi_bpi-r4-pro-8x-squashfs-sysupgrade.itbBaidu: 百度网盘 请输入提取码 提取码: 8888 Google: https://drive.google.com/drive/folders/1KybHmzsDeFiFhd1YIlZ0YUiLN0042Dly?uspsharingBPI-R4 LITEopenwrt-mediatek-filogic-bananapi_bpi-r4-lite-sdcard.imgopenwrt-mediatek-filogic-bananapi_bpi-r4-lite-squashfs-sysupgrade.itbBaidu: 百度网盘 请输入提取码 提取码: 8888Google: https://drive.google.com/drive/folders/1MSU0x5Ihz2Ctj0AJ_X0rBUyfcn9nGGaV?uspsharingBPI-R3openwrt-mediatek-filogic-bananapi_bpi-r3-sdcard.imgopenwrt-mediatek-filogic-bananapi_bpi-r3-squashfs-sysupgrade.itbBaidu: https://pan.baidu.com/s/1WbHnRUj-fqBdy2IACjSlUQ?pwd8888 提取码: 8888Google: https://drive.google.com/drive/folders/1ZtnUVS4r1MY3I31d8sokPRk7bD1J9hXT?uspsharingBPI-R3 MINIinstall packagesopenwrt-mediatek-filogic-bananapi_bpi-r3-mini-squashfs-sysupgrade.itbBaidu: 百度网盘 请输入提取码 提取码: 8888Google: https://drive.google.com/drive/folders/1p2RY4uUv6LxVg1aGo83EcRe2-VjvxgzB?uspsharingOpenWrt Oneinstall packagesopenwrt-mediatek-filogic-openwrt_one-squashfs-sysupgrade.itbBaidu: 百度网盘 请输入提取码 提取码: 8888Google: https://drive.google.com/drive/folders/1Ogu34Du_uxqHexs9y-bNgkGmyiZi7WSs?uspsharing[烧录指南](烧录指南)— 把板烧成出厂系统SD 卡 / 串口两种方式[首次配置](首次配置)— 第一次开机的配置向导[恢复与救砖](恢复与救砖)— 四层恢复阶梯与各板恢复键常见问题见 §1212. 常见问题FAQQ1升级固件会不会把设备刷坏A不会变砖。新固件写入备用槽并试运行确认无误才转正失败会自动回退到上一个好版本。万一配置和固件都坏了还有「长按恢复键开机」的整机救砖兜底。Q2忘记管理密码 / 配置乱了怎么办A运行中长按恢复键约 5 秒即可恢复出厂配置不重刷固件重新走配置向导即可。Q3和原来的 LuCI 冲突吗A不冲突。界面保留 LuCI 入口本界面未覆盖的高级场景可随时转 LuCI两者共存。Q4支持 IPv6 吗A支持WAN/LAN 均为 IPv4 IPv6 双栈。Q5一套固件真的 6 款板都能用AWeb 界面与功能完全一致固件会按板型自动适配硬件差异。按你的板型下载对应镜像即可。Q6界面是中文还是英文A中英双语界面内一键切换。Q7WireGuard 和 OpenVPN 能同时用吗A能。两种协议互不冲突可同时启用服务端可自定义端口与地址段并一键给客户端生成配置与二维码。Q8怎么备份和迁移配置A系统页可一键下载配置备份在新设备或恢复后上传该备份即可还原全部设置。固件升级时勾选「保留配置」也会自动延续设置。Q9升级会丢配置吗A默认「保留配置」升级后主机名 / WiFi / 用户 / VPN 等设置仍在也可选择不保留、回到出厂配置。13. 其他子页烧录指南、首次配置、恢复与救砖