luci-app-ssr-plus 是什么：OpenWrt 安装前须知

luci-app-ssr-plus（SSR Plus）是什么

luci-app-ssr-plus 常被简称为 SSR Plus，是 OpenWrt 路由器上的一个 LuCI 网页插件。装好之后，路由器后台的「服务」类菜单里会多出一个页面，用来添加节点、导入订阅、选择运行模式和设置分流规则。真正转发流量的不是插件本身，而是它在后台调用的各种内核与组件，例如 Xray、shadowsocks-rust、v2ray-core 等。

名字里虽然带着 SSR，但它早已不只支持 ShadowsocksR 协议。从源码仓库收录的软件包来看，它周围配套了 Shadowsocks、Trojan、Xray、V2Ray、Hysteria、TUIC、NaiveProxy 等多种实现，插件负责把这些组件组织起来。

官方来源核对

SSR Plus 的源码目录位于 GitHub 仓库 fw876/helloworld 中。这个仓库本身不是单一插件，而是一个 OpenWrt 软件源，顶层目录里能看到 luci-app-ssr-plus，以及 chinadns-ng、dns2socks、hysteria、mosdns、naiveproxy、shadowsocks-rust、shadowsocksr-libev、trojan、tuic-client、v2ray-core、xray-core 等配套软件包。以下信息来自 2026 年 10 月 21 日的查看结果。

项目	核对结果
源码仓库	https://github.com/fw876/helloworld
插件目录	仓库顶层的 luci-app-ssr-plus 目录
仓库简介	页面显示未提供描述
最新发布标签	v197.3（发布页标记为 Latest，对应整个软件源）
发布日期	页面显示 10 月 21 日，年份未显示，未能核实
插件自身版本号	未能核实
适用平台	OpenWrt 及其衍生固件（具体支持的版本范围未能核实）
许可证	仓库显示 GPL-3.0
是否归档	页面未显示归档标记
价格	未能核实（页面未标注）

需要注意，发布页上的 v197.3、v196.19 等标签是仓库层面的版本，不能直接当作 luci-app-ssr-plus 的版本号使用。此外，仓库 README 说明的是如何把它作为源码加入 OpenWrt 编译环境，并没有提供面向普通用户的一键安装包。

README 里值得注意的几点

README 的内容主要面向自己编译固件的人：要求先安装 clang；提供了三种接入方式，分别是直接克隆到源码的 package 目录、作为 git 子模块加入、以及作为 OpenWrt 软件源添加，并分别说明了更新与移除的做法。

另一条提示与旧版本系统有关：对于 OpenWrt 21.02 或更低版本，README 要求手动把 Golang 工具链升级到 1.21 或更高，才能编译 Xray-core。换句话说，老旧固件上自行编译会碰到额外门槛。README 没有列出其他受支持的 OpenWrt 版本，本页也不做推测。

luci-app-ssr-plus 适合谁用

SSR Plus 适合这几类人：已经在用 OpenWrt 或基于 OpenWrt 的第三方固件，并且固件里预装或可以方便地加入这个插件；希望全家设备不装客户端也能走代理；能够登录路由器后台、看得懂基本网络设置。

如果你只是想让一台电脑或一部手机用上订阅，完全不必折腾路由器。电脑端看 v2rayN 或 Clash Verge Rev，安卓看 v2rayNG，更简单也更容易回退。

操作前必须先备份

在路由器上装插件，和在电脑上装软件的风险级别完全不同。路由器一旦出问题，影响的是家里所有设备的网络，你可能连搜索解决办法的条件都没有。

建议按这个顺序准备：

1. 在路由器后台的「系统」类菜单中找到备份或恢复页面，下载一份当前配置的备份文件，保存在电脑上。
2. 记下当前固件的名称、版本和设备型号，并确认能从官方或可信渠道重新获取同版本固件。
3. 查看路由器剩余存储空间。插件和配套内核体积不小，空间不足会导致安装中断。
4. 准备一条不依赖路由器的备用网络，例如手机热点，以防安装后断网。

不同固件与版本的菜单名称略有差异，有的写作「备份/升级」，有的写作「备份与恢复」，以你自己的后台为准。

luci-app-ssr-plus 安装与配置的一般流程

由于 SSR Plus 通常随第三方固件预装，或通过软件源以软件包形式提供，具体方式差别很大，这里只给出通用思路，不列具体命令参数：

• 固件已预装：直接在后台的「服务」类菜单中找到 SSR Plus 页面。
• 需要自行安装：在后台的软件包管理页面更新软件列表，搜索插件名称并安装，同时留意依赖是否一并装上。
• 自行编译固件：按 README 的说明把仓库加入源码，再在编译菜单中勾选。

装好后，一般先在节点或订阅相关页面添加订阅链接并更新，再在主页面选择要使用的节点，最后开启服务并选择运行模式。订阅格式的基础知识见 订阅链接是什么，协议说明见 常见代理协议说明。不同固件与版本名称略有差异，请以实际界面为准。

断网或无法启动时怎么办

装插件后断网，常见原因包括 DNS 设置冲突、与其他代理插件同时启用、运行模式选择不当，或者节点本身不可用。先尝试在插件页面关闭服务，看网络是否恢复；如果后台都无法打开，可以用网线直连路由器，通过默认管理地址登录。

如果路由器反复重启或无法进入系统，就需要按设备厂商或固件作者提供的恢复方式处理，这正是事先备份配置和固件的意义所在。不要在同一台路由器上同时启用 SSR Plus、PassWall 和 OpenClash，它们会争抢相同的网络规则。全家网络方案的整体考虑，可以参考 家庭设备怎么统一走代理。

怎么判断手里的插件包来自哪里

SSR Plus 流传很广，很多第三方固件和软件源都会收录它，这也意味着同名插件的版本和改动可能各不相同。拿到一个安装包或者一份固件时，可以从几方面判断：固件作者是否公开说明了插件来自哪个源码仓库；软件源地址是否能追溯到公开的项目页面；安装包是否附带可核对的校验信息。如果这些都说不清楚，就不要轻易安装。

还有一个容易忽视的点：fw876/helloworld 作为源码仓库，提供的是编译所需的源码目录，而不是现成的安装包。网上自称「官方 ipk」的下载链接，并不能因为名字相同就视为官方发布，应当和其他来源一样谨慎对待。

升级插件时的注意事项

插件升级比首次安装更容易出问题，因为旧配置要被新版本读取。升级前同样要备份系统配置，并且最好单独导出插件内的节点和规则设置。升级时注意依赖的内核和组件是否需要同步更新，只升级插件而不升级内核，可能出现功能选项可见但无法启动的情况。

如果升级后服务无法启动，先查看插件页面或系统日志里的报错提示，再决定是回退到原版本还是修正配置。固件本身大版本升级时，插件是否仍然兼容也需要重新确认，不要默认可以无缝沿用。

和其他路由器插件怎么取舍

OpenWrt 上同类插件不少，选择时可以抓住两个问题。第一，你的订阅是什么格式。如果机场主要提供 Clash 订阅，并且你希望直接使用机场给出的分流规则，以 Clash 为中心的 OpenClash 更顺手；如果订阅是常见的节点链接形式，SSR Plus 或 PassWall 这类以节点列表为主的插件更直接。第二，你的固件里预装了什么。很多第三方固件只预装其中一两种，强行混装不同来源的插件，比使用固件自带的插件更容易出现依赖冲突。

无论选哪一个，同一时间只启用一个代理插件，是避免断网最简单有效的原则。

如果你想换插件，正确的顺序是先在旧插件里关闭服务并确认网络恢复正常，再安装和配置新插件，而不是两者同时开启测试。必要时可以先卸载旧插件，并在卸载后重启路由器一次，让残留的防火墙规则和 DNS 设置被清理干净。

小结

luci-app-ssr-plus 是 OpenWrt 上的代理管理插件，源码位于 fw876/helloworld 软件源仓库，仓库许可证为 GPL-3.0，最新发布标签为 v197.3，但插件自身版本号本次未能核实。它适合已经熟悉 OpenWrt 的用户；新手在动手之前务必备份配置、准备备用网络，并从可信渠道获取固件和软件包，相关原则见 安全下载指南。