HomeProxy 路由器导入订阅教程：ImmortalWrt 插件

官方信息核对（2026-10-21）

以下信息来自官方 GitHub 仓库页面、仓库元数据以及仓库内的 Makefile 和订阅脚本源码。

项目	核对结果
官方仓库	https://github.com/immortalwrt/homeproxy
维护方	ImmortalWrt 项目组织
最新版本号	未能核实（Releases 与 Tags 均为空）
发布日期	未能核实
最近代码提交	2026-10-15
适用系统	ImmortalWrt（仓库简介写明面向 ARM64 / AMD64）
依赖	sing-box、firewall4、kmod-nft-tproxy、ucode-mod-digest（来自 Makefile）
许可证	GPL-2.0
是否归档	否
订阅格式	base64 分享链接列表、SIP008；不支持 Clash YAML 与 sing-box 完整配置

仓库简介为「The modern ImmortalWrt proxy platform for ARM64/AMD64 (powered by sing-box)」。仓库首页的 README 实际上是一份待办清单，列出了订阅页面在节点较多时响应慢、重构 nftables 规则、把访问控制设置移到独立页面等改进方向，并没有安装说明。

HomeProxy 的定位

HomeProxy 是 ImmortalWrt 项目组织维护的 LuCI 插件，后端只用 sing-box 一个内核。这和 PassWall 的「多内核」路线、OpenClash 的「Mihomo + Clash 配置」路线都不一样：它把 sing-box 的能力用 LuCI 界面包装起来，追求的是结构简单、依赖少。

从 Makefile 看，它的依赖只有四项：sing-box 内核、firewall4 防火墙、kmod-nft-tproxy 内核模块和一个 ucode 模块。这意味着它只支持基于 nftables 的新式防火墙，不适用于仍在用 iptables 的老固件。

如果你对 sing-box 本身还不熟悉，可以先看 sing-box 介绍，了解它的配置思路，再回来看 HomeProxy 会容易理解很多。

先确认三件事

1. 固件是不是 ImmortalWrt。 HomeProxy 由 ImmortalWrt 项目维护，官方简介也直接写的是 ImmortalWrt 代理平台。其他 OpenWrt 衍生固件能否使用，官方页面没有说明，本文不作保证。
2. 设备架构是不是 ARM64 或 AMD64。 这是官方简介写明的范围。很多老款家用路由器是 MIPS 架构，不在此列。
3. 固件是否使用 firewall4。 依赖中有 firewall4 和 kmod-nft-tproxy，老版本固件不满足这一条件。

三条都满足，再考虑安装。

HomeProxy 安装前的备份与风险提示

路由器是全家的网络出口，任何插件出错都可能导致断网；如果你为了用 HomeProxy 而改刷 ImmortalWrt 固件，刷机失败还有设备无法启动的风险。请先完成：

• 在 LuCI 的系统菜单中导出配置备份并保存到电脑（不同固件与版本名称略有差异）。
• 记下宽带拨号账号、Wi-Fi 名称和密码。
• 查清本机型的恢复模式和救砖方法。
• 用网线连接路由器操作，并准备手机热点作为备用网络。

安装思路

官方仓库没有提供 Release 安装包，所以 HomeProxy 通常通过 ImmortalWrt 的软件源安装。通用做法是：在 LuCI 的软件包管理页面或通过 SSH 更新软件源列表，搜索 homeproxy 相关的 LuCI 应用包，安装后刷新页面，在「服务」菜单下找到入口。不同固件与版本名称略有差异，包管理器可能是 opkg 也可能是 apk，请以你的固件为准，本文不提供具体命令参数。

请不要从第三方网盘或论坛下载所谓的「HomeProxy 增强版」安装包。社区确实存在一些修改版或分支项目，它们与官方仓库不是同一个东西，功能和安全性都需要单独评估。判断来源的方法见 下载安全指南。

HomeProxy 导入订阅的格式：这一节最重要

很多人装好 HomeProxy 后发现订阅导入不了，原因几乎都在格式上。我们读了官方仓库中的订阅更新脚本，结论很明确：

• 支持 base64 编码的分享链接列表。 脚本会先尝试按 JSON 解析，失败后再做 base64 解码，并按行拆成节点链接。
• 支持 SIP008 格式。 这是一种 JSON 形式的 Shadowsocks 订阅格式。
• 不支持 Clash YAML。 机场给的 Clash 订阅不能直接用。
• 不支持 sing-box 完整配置。 虽然后端是 sing-box，但订阅功能并不接收 sing-box 格式的完整配置文件。
• 未编码的纯文本链接列表，按脚本逻辑不会被直接处理。

支持的分享链接类型包括 anytls、http / https、hysteria、hysteria2（含 hy2）、socks 系列、ss、trojan、tuic、vless、vmess。另外有几条限制：hysteria、hysteria2、tuic 需要所装的 sing-box 支持 QUIC，否则会被跳过；使用 kcp 传输的 vless 和 vmess 节点会被跳过；部分不符合格式要求的 vmess 链接也会被跳过。

所以在机场后台取订阅时，应选择「通用订阅」或「分享链接订阅」一类，而不是 Clash 订阅。Clash 订阅和通用订阅的区别可以看 Clash 订阅指南 和 订阅链接科普。各协议的含义见 协议科普。

订阅导入后节点数量明显少于后台，先对照上面的跳过条件检查；完全拉不下来，再按 订阅更新失败 排查网络与订阅状态。另外，官方待办清单里提到节点很多时订阅页面响应较慢，这是已知问题，不一定是你的设备出了故障。

分流与日常使用

HomeProxy 的分流能力来自 sing-box 的路由系统，可以按域名、IP 等条件决定直连还是代理。刚上手时建议使用简单的规则组合，确认稳定后再细化，规则基础见 分流规则指南。

sing-box 版本更新时有时会调整配置字段，HomeProxy 也需要跟进。如果升级 sing-box 后插件无法启动，可以到官方仓库的 issue 区搜索相同报错，看看是否已有维护者说明或临时解决办法，再决定是等待更新还是暂时回退版本。遇到间歇断流，参考 连接断开怎么办。

HomeProxy 导入时机场只有 Clash 订阅怎么办

这是 HomeProxy 用户最常遇到的情况。处理思路有几种，按推荐程度排列：

1. 向机场索取通用订阅。 多数机场在后台同时提供多种订阅格式，名称可能是「通用订阅」「V2Ray 订阅」或「分享链接」。选那种内容是 base64 编码节点链接的格式即可。
2. 手动添加少量节点。 如果只用两三个节点，可以从机场后台复制单个节点的分享链接，在 HomeProxy 的节点页面逐个添加。缺点是节点变动时需要手动维护。
3. 换用更对口的插件。 机场只提供 Clash 订阅、又不想折腾时，OpenClash 或 PassWall 2 能直接识别 Clash 配置中的节点，可能更省事。

不建议把订阅链接交给来历不明的在线转换服务。订阅链接里包含你的账号凭证，交给第三方相当于把节点使用权一并交出。

与 sing-box 版本的配合

因为 HomeProxy 完全依赖 sing-box，两者的版本关系比其他插件更紧密：

• 尽量让插件和 sing-box 都来自同一个固件软件源，不要单独从别处替换 sing-box 二进制文件。
• 升级前先导出 HomeProxy 配置，升级后先检查服务能否正常启动，再检查节点连通情况。
• 订阅中的 hysteria2、tuic 节点依赖 sing-box 的 QUIC 支持，如果这类节点全部消失，先确认所装 sing-box 是否带有该功能。

把这几条记住，大部分「升级后突然不能用」的问题都能更快定位。

为什么没有版本号也能放心用

HomeProxy 的官方仓库没有发布 Release，也没有打标签，这让不少人担心它是不是已经停止更新。从仓库元数据看，项目没有归档，代码在 2026 年 10 月中旬仍有提交，待办清单也在列出后续改进方向，说明它处于持续维护中。它的分发方式更接近「随固件软件源走」：ImmortalWrt 的软件源会打包插件，你在软件包管理器里看到的版本，就是当前固件对应的版本。

因此，判断自己装的是不是较新的 HomeProxy，看的是软件源中的包版本和更新时间，而不是 GitHub 上的发布页。遇到问题时，先把软件源更新到最新，再看问题是否仍然存在。如果问题依旧，可以到官方仓库的问题区搜索相同现象，提交反馈时附上固件版本、设备架构、sing-box 版本和报错日志，并记得把日志里的订阅地址与节点信息打码，方便维护者定位，也保护自己的账号安全。

出问题如何回退

• 在 HomeProxy 页面关闭服务，观察网络是否恢复。
• 如果是升级后才出问题，考虑回退 sing-box 或插件到升级前的版本（以软件源中可用的包为准）。
• 后台无法访问时，用网线直连并尝试恢复模式，再用事先导出的备份还原。

适合谁

HomeProxy 适合已经在 ARM64 或 AMD64 设备上运行 ImmortalWrt、偏好 sing-box、机场能提供分享链接订阅的用户。机场只有 Clash 订阅的话，OpenClash 会更省心；设备不是标准 OpenWrt 的话，可以看 ShellCrash。家庭多设备的整体方案选择见 家庭设备使用指南，其他客户端见 客户端总览。本页信息核对于 2026 年 10 月 21 日。