HomeProxy 从安装到分流：在 ImmortalWrt 和新版 OpenWrt 上怎么配

HomeProxy 是 ImmortalWrt 项目维护的一款 LuCI 代理插件，包名 luci-app-homeproxy，内核用 sing-box。它的界面比 PassWall 精简，菜单分成「客户端设置」「节点设置」「服务器设置」「服务状态」几页，很多高级功能藏在自定义路由里。它有一个硬条件：只支持 firewall4（nftables），老的 iptables 固件装不上。下面先确认条件，再一步步配。

先确认固件够不够新

1. 看防火墙类型。OpenWrt 从 22.03 起默认用 firewall4。SSH 登录后执行下面的命令，能列出 nftables 的表，说明满足条件。
2. 看固件来源。ImmortalWrt 的软件源里直接有 HomeProxy；官方 OpenWrt 的源里没有，要另找安装包；iStoreOS 等衍生固件，取决于它用的 OpenWrt 版本和防火墙。
3. 看架构和空间。sing-box 内核体积不小，闪存紧张的设备先看剩余空间。

nft list tables
cat /etc/openwrt_release
df -h /overlay

nft 命令不存在或报错，通常说明固件还在用 iptables，这时换 PassWall 或脚本方案 ShellCrash 更现实。

安装插件和中文包

ImmortalWrt 上最简单：后台「系统 → 软件包」里先更新列表，搜 homeproxy 装上；或者在 SSH 里执行：

opkg update
opkg install luci-app-homeproxy luci-i18n-homeproxy-zh-cn

依赖的 sing-box 会一并装上。较新的固件如果改用了 apk 包管理器，命令换成对应写法即可。

官方 OpenWrt 用户需要找与固件版本、CPU 架构都对得上的 ipk，连同 sing-box 一起装。HomeProxy 更新较快，插件和 sing-box 版本不匹配时，常见症状是服务起不来、日志里报配置字段不认识。装完刷新后台，在「服务」菜单下找到 HomeProxy。

导入订阅或单个节点

进入 HomeProxy 的节点设置页，有两种添加方式。

1. 订阅：在「订阅」页签填订阅地址，点「保存订阅设置」，再点「从订阅更新节点」，节点会出现在节点列表。可以设自动更新，也可以用「过滤节点」加关键词过滤掉「剩余流量」「到期时间」这类信息条目。
2. 分享链接：手里只有一两条 ss://、vmess://、vless://、trojan://、hysteria2:// 之类的链接，用导入分享链接功能粘贴进去即可，也可以按字段手动填。

格式上要记住两点。第一，HomeProxy 认的是 Base64 处理过的分享链接订阅，另外支持 Shadowsocks 的 SIP008 格式，Clash 的 YAML 不行。第二，节点协议要在 sing-box 支持范围内，SSR 这类旧协议会被跳过。

订阅还没着落的话，可以在 推荐号位 里比一比，再看 一翻云、微风 的单家页。本站手上没有各家的订阅格式与设备数资料，付款前问客服：能否提供通用订阅（分享链接形式），一个账号同时能在线几台设备。全家共用一条订阅时，流量消耗会比单人高不少。

选主节点和路由模式

回到客户端设置页，从上到下：

1. 主节点选一个延迟低的节点。代理模式带 UDP 时会多出「主 UDP 节点」，可以单独指定，也可以选「保持与主节点一致」。
2. 选路由模式，见下表。
3. 选代理模式：只重定向 TCP、TCP 重定向加 UDP 透明代理、TCP 重定向加 UDP 走 TUN，或者全部走 TUN。设备性能一般时，前两种开销小；游戏、语音这类 UDP 多的场景，选带 UDP 的。
4. 视家里网络决定是否开启 IPv6 支持。宽带有 IPv6、又没在插件里开，设备可能经 IPv6 直接出去，绕过代理。

自定义路由是 HomeProxy 发挥 sing-box 能力的地方：先建路由节点，再写路由规则，指定某类域名或 IP 交给某个节点；也能配合规则集按类别分流。第一次配置先用「大陆白名单」，跑稳后再动自定义路由。

把 DNS 设对

DNS 决定分流准不准。非自定义路由模式下，客户端设置页有两处要分开填：

1. 国内 DNS 服务器：只在大陆白名单模式下出现，给国内域名用，填运营商或国内公共 DNS。
2. DNS 服务器：给其余域名用，经主节点去查，避免拿到错误地址。

用自定义路由时，DNS 改在单独的 DNS 设置里按规则配。

旁路由用法下，还要把主路由 DHCP 下发的网关和 DNS 指向装 HomeProxy 的设备，否则设备直接问主路由 DNS，分流会失效。iStoreOS 做旁路由的具体步骤，在 iStoreOS PassWall 那篇写得更细，网关、DNS、IPv6 的处理思路对 HomeProxy 同样适用。

用状态页验证

1. 打开状态页，看连接检查：国内站点和国外站点两项都通，说明基本工作正常。
2. 同一页能看到插件日志和 sing-box 日志，启动失败时这里会写原因。
3. 拿一台没装代理软件的手机连 Wi-Fi，打开查出口 IP 的网页，地区应是节点所在地。
4. 再刷几个国内网站，确认没有绕道变慢。

和另外两种方案对照着选

HomeProxy 不是孤例，路由器上做代理还有 PassWall 和 ShellCrash。三者差别主要在固件要求、订阅格式和设置方式上，挑之前对一下手里的条件。

几种常见情形可以这样落：刷的是 ImmortalWrt，又只有通用订阅，HomeProxy 最省事，装上就能填；固件停在较老的版本、防火墙还是 iptables，HomeProxy 装不上，转 PassWall；手里只有 Clash 订阅，又不想经过第三方转换，ShellCrash 直接吃这种格式，新版 PassWall 也能读出其中的节点。换方案时先停用当前插件，再装新的，两套透明代理规则并存是断网的头号原因。

另外，sing-box 本身仍在快速迭代，新协议支持、配置字段的变动都会先体现在内核上，再传到 HomeProxy。喜欢跟进新特性的人会觉得这是好事；追求稳定的人，固件和插件跑顺之后不必急着升级，每次升级前先导出一份配置。

常见故障怎么查

排查从最外层开始：先停用 HomeProxy，确认网络本身正常；再只开基础设置，不碰自定义路由；最后逐项打开高级功能，每改一处看一次状态页。HomeProxy 版本更新频繁，菜单文字和选项可能随版本变化，遇到和本文对不上的地方，以插件界面上的说明为准。