HomeProxy官网下载与配置教程：订阅分流、未运行怎么修

先看结论：HomeProxy 是装在路由器上的 sing-box 图形管理插件，不自带节点。官方下载认准 ImmortalWrt 的 GitHub；本站已镜像最新主分支构建的 IPK、APK 两个包。新手优先装固件软件源里的配套版本，再按“导订阅 → 选主节点 → 保存应用”使用。显示未运行先查主节点和日志，别一上来就升级内核。

HomeProxy有什么作用，适合哪种路由器？

它把节点、DNS、透明代理和分流设置放进路由器网页后台。配置好以后，以这台路由器为网关、且被代理规则接管的设备可以共用代理，不必在每台手机、电脑和电视上单独装客户端。

官方项目面向 ARM64 / AMD64 的 ImmortalWrt。插件本身标为 all / noarch，意思是界面代码不按CPU分包，不代表任意路由器都能装：实际还取决于固件软件源里的 sing-box、内核模块、可用内存和存储空间。官方项目与依赖说明

HomeProxy官网、GitHub与安装包下载

官方入口是 immortalwrt/homeproxy。 本次核实时，仓库没有已发布的 Release；下载要看 Actions → 成功的 master 构建 → Artifacts。不要把 Pull request 测试包、dev 分支或其他作者的分支当作同一个正式版。

这次镜像对应 2026-10-15 的 master 构建 #1023，版本 1792056518~fadaa67，源码提交为 fadaa676104f59ff6ace480a780a258d846d0aec。这是主分支快照，不是带稳定性承诺的正式 Release。官方构建与下载页面

两个官方安装包，按包管理器选

APK在这里不是安卓安装包。 两个包都不能直接装到手机、Windows或macOS。GitHub Actions下载可能要求登录，产物也有保留期限；本站链接可以直接下载。

本表收齐的是此次官方主分支构建的全部安装包，不混入历年旧包和第三方修改版。两包已内置简体中文翻译；sing-box、firewall4和内核模块不在这个约0.6MB的包里，依赖优先由你的固件源安装。需要单独查内核包时，可参考文末的 sing-box 下载教程，先核对兼容版本再下载。

如果希望跟随固件而非主分支快照，可从官方软件源查包：ImmortalWrt 24.10软件包目录、25.12软件包目录。这里展示的是x86_64目录，其他架构应在自己的固件软件源里选择；软件源包与上表快照的版本号不同，不能只看数字大小混装。

文件来源与SHA256校验

两种安装包均从上面的 ImmortalWrt官方GitHub构建页面原样下载，未重新打包、未修改。本站核对了GitHub公布的SHA256，并从R2公开地址重新下载比对一致。

源码采用 GPL-2.0-only：对应源码下载 · 官方源码 · 许可证。源码ZIP用于查看和自行构建，不能当安装包上传到LuCI。

OpenWrt与iStoreOS安装教程：先把依赖配齐

先在路由器的“系统 → 备份/升级”保存配置备份，再通过SSH查看环境：

cat /etc/openwrt_release
uname -m
command -v opkg
command -v apk
sing-box version
df -h /overlay

看到opkg就用IPK，看到apk就用APK。 不确定的定制固件，按实际命令与软件包页面判断，别只凭教程里的版本年份。

软件源里已有HomeProxy

在LuCI的“系统 → 软件包”更新列表，搜索 luci-app-homeproxy。如果已有该包，优先使用软件源版本；中文翻译若单列，再安装 luci-i18n-homeproxy-zh-cn。

使用opkg的系统也可执行：

opkg update
opkg install luci-app-homeproxy

使用apk的系统对应为：

apk update
apk add luci-app-homeproxy

上述命令以固件源实际提供该包为前提。 提示“Unknown package”不等于路由器坏了，而是当前软件源没有它。iStoreOS也不能保证商店里搜得到；其项目中已有用户报告这一情况。iStoreOS相关问题

手动安装本站下载的包

官方列出的主要依赖是 sing-box、firewall4、kmod-nft-tproxy、ucode-mod-digest，还需要可用的LuCI环境。用固件自己的软件源安装依赖；缺少某个包时，先确认固件支持情况，不要用强制忽略依赖硬装，更不要整套替换成另一发行版的软件源。

对依赖已兼容的opkg系统，把IPK上传到 /tmp 后执行：

opkg install /tmp/luci-app-homeproxy_1792056518~fadaa67_all.ipk

apk系统可在软件包页面上传APK，或用 apk add /tmp/完整文件名.apk。本次Actions构建脚本未给APK配置签名；若包管理器拒绝不可信包，优先使用固件源的签名包，不把关闭签名验证作为新手默认步骤。

安装完成后重新进入路由器后台，菜单应为 “服务 → HomeProxy”，下面有“客户端设置、节点设置、服务端设置、服务状态”。日常导入机场用的是前两项，不需要打开服务端。官方菜单定义

HomeProxy配置教程：订阅导入后还要选主节点

第一步：拿对订阅格式

在机场后台寻找 通用订阅、v2rayN订阅或Base64节点订阅。本次核实的官方解析器支持Base64编码的节点链接列表，以及Shadowsocks SIP008；可解析的链接包括SS、VMess、VLESS、Trojan、Hysteria2、TUIC、AnyTLS等，实际连接还取决于内核功能和节点参数。官方订阅解析器

Clash的YAML配置、sing-box的整份JSON配置、机场登录页地址，都不能直接当作这里的节点订阅。 机场只给Clash格式时，先向客服要兼容订阅；不要随手把含账号令牌的订阅地址贴进陌生在线转换站。

第二步：保存订阅，再更新节点

1. 打开 “服务 → HomeProxy → 节点设置 → 订阅”。
2. 把地址填入 “订阅地址”，多家订阅可分项添加。
3. 点击 “保存当前设置”，再点击 “从订阅更新节点”。只填地址没保存就更新，容易仍然读取旧设置。
4. 查看节点列表是否出现实际节点；需要定时更新，再打开自动更新选项。

如果更新后为空，先检查订阅是否过期、是否拿错格式、过滤关键词是否把节点筛掉，以及路由器能否访问订阅域名。“通过代理更新”只适合已有可用代理的情况，首次安装不能指望它解决所有下载失败。

第三步：选择主节点并应用

进入 “客户端设置 → 路由设置”，把 “主节点”从“禁用”改成一个实际节点。新手先用单节点，路由模式选“绕过中国大陆”，代理模式保留固件支持的默认选项，保存并应用。

导入成功不等于代理已经启动。 官方默认配置里主节点就是禁用状态；未选节点、又没有开启服务端时，启动脚本会直接退出。先看到状态变成运行，再用一台经过该路由器的设备检查国内和国外网站，最后扩展到其他设备。

URLTest可用于在候选节点之间做延迟测试选择，但先确认单节点能连，再添加候选列表。导入订阅主要获得节点，不会自动照搬机场Clash配置里的策略组和分流规则。

HomeProxy分流与规则集怎么配？

一般家用先选 “绕过中国大陆”。还提供GFWList、仅代理中国大陆、自定义路由和全局等模式；其中“仅代理中国大陆”是另一种使用方向，不要和绕过大陆选反。国内国外判断依赖规则数据，不保证每个站点都符合你的预期。官方客户端设置

需要按网站分配不同出口时，再进入 “自定义路由”：

1. 在“路由节点”里建立出口，并选择实际节点。
2. 在“规则集”里添加本地或远程规则，填写来源及格式。
3. 在“路由规则”中引用该规则集，指定对应出站；按需求调整规则顺序。
4. 检查默认出站与DNS服务器，保存后从日志和实际访问确认命中结果。

增加规则集之后，还要在规则里引用它。 只添加一个下载地址，不会自动决定哪些网站走哪个节点。DNS规则与流量路由也要配套；刚开始不要同时叠加多套DNS插件来排错。

若想去广告，可用适合sing-box的规则集配合阻断动作，但它不是装完即有的万能去广告开关。域名规则无法保证去掉和正常内容共用域名的视频广告。

HomeProxy的TUN模式在哪里？

在 “客户端设置 → 路由设置 → 代理模式”。官方界面会按已安装功能显示选项：

看不到TUN时，检查 ip-full 与 kmod-tun，这是官方界面明确提示的两个条件。内核模块必须来自与你的固件内核匹配的软件源，不能从别的设备包里随便拷一个。

TUN不等于一定更快，也不等于分流策略。 它决定如何接管流量；哪些网站走代理仍由路由规则决定。先用现有模式跑通，再根据UDP或应用需求切换；其他透明代理插件同时运行时，应先停用其代理功能，避免防火墙与DNS规则争用。

HomeProxy未运行：按这个顺序排查

“未运行”是本机服务状态，不能直接说明机场节点已经失效。先区分服务没启动，还是服务运行但节点连不上。

SSH可用时，先看这些信息：

sing-box version
uci get homeproxy.config.main_node
tail -n 80 /var/run/homeproxy/homeproxy.log
tail -n 80 /var/run/homeproxy/sing-box-c.log
sing-box check -c /var/run/homeproxy/sing-box-c.json

最后一条用于检查已经生成的配置；如果提示文件不存在，应回头看生成配置为何失败。运行目录在重启或停止服务后可能清空。向别人求助时，只提供错误行和版本，先遮住订阅令牌、节点密码及其他私人信息。官方启动与配置检查流程

更新尤其要注意配套。 截至本文核实日，官方仍有针对sing-box 1.14的适配提案处于草稿状态，另有相关启动修复提案；这不表示所有1.14组合都会失败，却足以说明“内核越新越好”不是可靠安装建议。适配提案 #671 · 启动修复提案 #673

HomeProxy更新与配置文件备份

HomeProxy的主要配置保存在 /etc/config/homeproxy，证书和规则等在 /etc/homeproxy/；运行时生成的sing-box配置是 /var/run/homeproxy/sing-box-c.json。要长期修改，改LuCI/UCI设置；直接改运行时JSON，下一次生成配置就可能被覆盖。

升级前保存固件备份，并另存上述配置目录和已知可用版本信息。更新时分别确认：

• 插件更新：跟随固件软件源，或在明确兼容时更换手动安装包。
• 内核更新：检查HomeProxy是否适配，不能仅因为sing-box有新版就替换。
• 订阅更新：更新机场节点，不会更新插件或内核。
• 规则资源更新：更新分流数据，也不是软件升级。

/etc/config/homeproxy里可能包含订阅地址和节点信息，备份应自己保管。不要把整份配置上传到公开仓库求助。

HomeProxy面板、iStoreOS与Docker常见误区

为什么教程里的面板和我的不一样？

官方版的管理面板就是LuCI里的HomeProxy页面。网上带Clash API、额外选择器或Dashboard的演示，可能来自其他分支，不能保证官方版有同样入口。例如 muink/luci-app-homeproxy 明确标注停止更新，并已归档；它的功能说明不能直接当作当前官方主分支的说明。该分支说明

iStoreOS装上了，为什么还是未运行？

安装包只解决插件文件，运行还需要配套sing-box、UCI模块、防火墙和节点设置。先按前面的排查表查依赖与日志。不建议为了装一个插件直接把iStoreOS全套软件源改成ImmortalWrt源，尤其内核模块不能跨固件随意替换。

HomeProxy Docker科学上网怎么用？

本次在 ImmortalWrt官方仓库和构建工作流中没有发现独立Docker镜像。HomeProxy依赖OpenWrt的LuCI、UCI、procd和firewall4，不是给普通Linux容器准备的独立Web服务。

如果你实际要在NAS或Linux服务器上运行代理，可以考虑 sing-box官方Docker方案：自己准备配置、按场景配置容器网络。它运行的是sing-box内核，不会因此自动出现HomeProxy面板。把完整OpenWrt环境放进容器是另一种部署方案，不能简化成“安装一个HomeProxy容器就让全家设备自动走代理”。

搜索结果里的 HAProxy 是另一个代理/负载均衡项目，Homepage 是另一个主页面板项目，都不是这里的HomeProxy。不要因为名字相近就复制它们的Docker命令。

还没选工具或订阅，可以看哪些？

如果你已经有Clash配置、希望直接使用策略组和对应生态，可看 OpenClash下载与设置教程；想在普通Linux或Docker上直接运行内核，可看 sing-box下载与配置教程。HomeProxy更适合愿意在路由器后台自己配置sing-box分流的人。

可按协议匹配的机场

HomeProxy不绑定某一家机场。选择前先确认有可导出的通用订阅，不能只支持自家客户端。下面两家是按已核实协议挑的候选，本篇没有购买节点做HomeProxy连接实测；价格为各自评测核实记录，购买前以后台为准。

• 鹿语云：节点使用AnyTLS，本文核实的HomeProxy解析器支持这一协议。适合已经确认内核支持AnyTLS、想用路由器统一管理的人；评测记录为月付20元100GB起，长付没有折扣且不退款，先月付确认兼容。
• ASH微斯人：节点使用V2Ray/VMess，评测记录为月付15元100GB起。更适合固定的大陆家庭网络；它的订阅有IP绑定与拉取频率限制，不适合频繁换网络更新，路由器自动订阅频率也别设得太密。

常见问题

HomeProxy免费吗，下载后就能用吗？

插件免费开源，但不自带免费节点。还需要兼容的路由器环境，以及自己的代理服务器或机场订阅。

HomeProxy官网和GitHub在哪里？

官方项目是 immortalwrt/homeproxy。本次没有已发布的Release，安装包在Actions成功的master构建中，也可以从ImmortalWrt对应固件的软件源安装。上面的下载表保留了官方入口与R2镜像。

HomeProxy的APK能装在安卓手机上吗？

不能，它是路由器apk包管理器使用的软件包。用opkg的固件选IPK，用apk的固件选APK，还要满足依赖，不能按手机安装包理解。

HomeProxy为什么一直显示未运行？

先确认主节点没有停在“禁用”，再查节点是否导入、依赖是否齐全。更新内核后出现问题，要对照日志检查插件与内核的配置格式是否配套，不要只反复重启。

HomeProxy能直接导入Clash订阅吗？

本文核实的官方版本不直接解析Clash YAML。向机场获取通用或v2rayN格式订阅；sing-box完整JSON也不能直接作为节点订阅导入。订阅、规则集和运行配置是三种不同的内容。

HomeProxy有Docker版吗？

本次未在官方仓库与工作流中发现独立Docker镜像。普通Linux或NAS容器用户可考虑sing-box官方Docker方案，但它不是HomeProxy的LuCI插件。

核实日期：2026-10-16。本文对照官方仓库、构建产物、源码、简体中文翻译及固件软件源编写；浏览器查看了官方GitHub与谷歌搜索结果，未在实体路由器上完成安装和联网测试。镜像安装包与官方SHA256一致。文中机场评测可能包含推广链接，购买不会增加你的费用，本站可能获得佣金。