husi 导入订阅教程：基于 sing-box 的安卓多协议客户端

官方信息核对

以下信息核对自 husi 的官方 GitHub 仓库、Releases 发布页和项目 Wiki，核对日期为 2026 年 10 月 21 日：

项目	核对结果
最新版本	v2.3.1（Releases 最新正式发布，非预发布）
发布日期	2026-10-20
平台	安卓（arm64-v8a、armeabi-v7a、x86、x86_64 APK）；Linux（deb、rpm、pacman、AppImage、tar.zst）；macOS（arm64 dmg）；Windows（amd64 安装程序与 zip，含自带运行时的 jbr 版本）
价格	官方页面未见收费说明，发布页可免费下载
许可证	README 标注 GPL-3.0 或更高版本；GitHub 自动识别显示为 Other，未能进一步核实
是否归档	否
官方来源	仓库 https://github.com/xchacha20-poly1305/husi ，发布页 https://github.com/xchacha20-poly1305/husi/releases ，Wiki https://github.com/xchacha20-poly1305/husi/wiki
官网	仓库未设置独立官网，未能核实

另外两点补充：README 写明 Intel 芯片的 macOS（darwin/amd64）已不再支持，Windows arm64 版本暂时不提供。部分第三方网站称项目已迁移到 Codeberg，但本次查看的 GitHub 仓库页面没有显示迁移声明，且 2026-10-20 仍有新版本发布，本文以 GitHub 为准。

husi 是什么

husi 的中文名叫「虎兕」，官方给自己的描述颇为谦虚：一个「非专业的、以代理集合为核心的多平台代理工具集」。它的底层是 sing-box 内核，通过 Go 语言编写的 libcore 库封装，界面层则采用 Kotlin 多平台技术，所以同一套代码既能出安卓 APK，也能出桌面安装包。

它的应用包名是 fr.husi，在发布文件名里可以看到。从项目结构看，husi 走的是 SagerNet 系客户端的路线：节点按分组管理、订阅只是分组的一种、协议扩展靠插件 APK。与同样基于 sing-box 的 NekoBox 相比，husi 的更新节奏较快，并把桌面端也纳入了同一个项目。

husi 导入订阅最关键的限制：不支持 Clash 订阅

在讲步骤之前，必须先强调一件事。官方 Wiki 在「分组」页面介绍订阅类型时写得很直接：默认的 Raw 类型 不支持 Clash/Mihomo 配置。

很多机场默认展示给用户的是 Clash 订阅链接，直接把它粘进 husi，大概率会得到空列表或解析报错。正确的做法是在机场后台寻找以下两类链接之一：

• sing-box 格式：返回内容是 JSON；
• 通用 / V2Ray 格式：返回内容是一长串 base64 编码文本，解码后是一行行 vmess://、vless://、ss:// 之类的分享链接。

分不清机场给的是哪种，可以用手机浏览器打开订阅链接看一眼返回内容。Clash 格式的特征和其他格式的区别，见 Clash 订阅说明。

husi 的三种订阅类型

官方 Wiki 列出了 husi 支持的三种订阅类型：

Raw（默认）。 husi 会先尝试 base64 解码，然后解析其中的文本，可以识别 sing-box JSON，或者任何包含代理链接的文本。如果机场在 HTTP 响应头里带了 Subscription-Userinfo，husi 还能读出已用流量和到期时间。绝大多数机场用户选这一项就对了。

OOCv1。 一种较少见的订阅协议，支持流量统计以及固定证书的强制 TLS 1.3。除非机场明确告诉你用它，否则不必理会。

SIP008。 Shadowsocks 社区定义的订阅格式，同样少见，只有纯 Shadowsocks 服务商才可能用到。

husi 安卓端导入订阅步骤

下面按常见版本的界面说明，不同版本名称略有差异，找不到对应文字时，留意意思接近的选项。

1. 安装 APK。 从官方发布页下载与手机架构匹配的 APK，主流手机选 arm64-v8a。README 还推荐用 Obtainium 跟踪 GitHub 发布、自动提醒更新。
2. 打开分组页面。 在侧边菜单中进入「分组」。
3. 新建分组并选择订阅类型。 点击添加，分组类型选「订阅」，订阅类型保持默认的 Raw。
4. 填写订阅地址。 粘贴机场的 sing-box 或通用格式链接。Wiki 提到订阅地址可以包含基本认证信息，一般机场用不到。
5. 按需调整高级选项（见下一节），然后保存。
6. 更新订阅。 对该分组执行更新，节点出现在列表里。
7. 选择节点并启动。 回到主界面点选节点，按启动按钮，首次会弹出安卓 VPN 授权，选择允许。

值得了解的订阅选项

husi 的订阅设置比多数客户端细致，Wiki 里逐项列出了说明，挑几个实用的讲：

• 过滤（正则）：这是一个「排除」过滤器，名称匹配正则的节点会被删掉。比如机场列表里混有「官网」「剩余流量」这类说明性条目，可以用它去掉。留空则不过滤。
• 去重：删除重复节点，适合合并多个订阅时使用。
• 强制解析：把服务器域名解析成 IP，并尽可能设置 HTTP Host 与 SNI。遇到 DNS 污染时可以尝试，平时不必开启。
• 仅在已连接时更新：设备没连代理时跳过定时更新；手动更新会弹确认框。适合订阅域名在直连环境下打不开的情况。
• User-Agent：有默认值，也可以自定义，支持用 $version 和 $box_version 插入版本号，注意大小写敏感。部分机场会根据 UA 返回不同格式的内容，订阅出问题时可以从这里入手。
• Age 身份：用于解密 age 格式加密的订阅文本，属于非常小众的需求。
• 自动更新：受安卓系统限制，最短间隔 15 分钟。

另外，Wiki 说明订阅类型的分组只能更新来自该订阅的节点，手动添加的节点建议放在单独的分组里。

插件与协议

husi 把一部分协议做成单独安装的插件 APK。README 提到的插件包括 hysteria2、juicity、naive（已标记为弃用）、mieru、shadowquic。如果机场节点使用这些协议，需要额外安装对应插件，否则节点会显示不可用。

官方 Wiki 的「代理协议」页面还有一条值得注意的说明：husi 为了实现某些非对称协议的加密，对 sing-box 做了修改，并且在应用内不推荐使用 VLESS 或 REALITY。如果机场主力节点是 VLESS + REALITY，选客户端时要把这一点考虑进去。各协议的背景知识见 协议百科。

桌面版简介

husi 的桌面版和安卓版同出一个项目。Windows 用户可以选安装程序或便携 zip，文件名带 jbr 的版本自带 Java 运行时，不想单独安装 Java 21 的话选它最方便。Linux 提供 deb、rpm、pacman、AppImage 等多种包；macOS 目前只有 Apple 芯片的 dmg。桌面端的订阅逻辑与安卓端相同，同样不支持 Clash 配置。桌面客户端的整体选择，可参考 Windows 客户端指南 和 Mac 客户端指南。

用好 User-Agent 和过滤器的两个场景

husi 的订阅选项看起来琐碎，但在两个常见场景里能派上大用场。

场景一：机场返回了错误的格式。 不少机场会根据请求头里的 User-Agent 判断客户端类型，再决定返回哪种格式。如果你确认复制的是通用链接，导入后却没有节点，可能是机场没有认出 husi，返回了不兼容的内容。这时可以尝试在订阅设置里调整 User-Agent。具体改成什么值，最好先问机场客服支持哪些客户端标识，不要随意伪装成其他软件。

场景二：节点列表太乱。 机场订阅里常常混着「剩余流量」「到期时间」「官网地址」之类的伪节点，还有一些你永远不会用的地区。用过滤器写一条正则，比如匹配「剩余|到期|官网」，更新后这些条目就会被自动剔除。需要注意的是，这个过滤器是排除逻辑，写错了可能把正常节点也删掉，改完后对照一下节点数量。

两个场景都提醒我们，导入失败时不要急着换客户端，先检查订阅返回了什么内容、客户端又拿这些内容做了什么处理，往往就能找到症结所在。

排查思路

1. 导入后没有节点：九成是拿了 Clash 格式的链接，换 sing-box 或通用格式。
2. 只有部分节点能用：检查不可用节点是否属于需要插件的协议。
3. 流量和到期时间不显示：说明机场没在响应头里提供相关信息，不影响使用。
4. 订阅更新超时：开启「仅在已连接时更新」，或先连上节点再手动更新。
5. 后台断开：在系统设置里关闭电池优化，允许后台运行。
6. 桌面版无法启动：确认已安装 Java 21，或者改用文件名带 jbr、自带运行时的版本。

通用排查方法见 订阅更新失败 与 Clash 导入失败排查。

适合谁

husi 适合手里有 sing-box 或通用格式订阅、希望在安卓和电脑上用同一款工具、并且愿意花点时间研究订阅选项的用户。如果你的机场只提供 Clash 订阅，或者主要使用 VLESS + REALITY 节点，那么 FlClash、SFA 或 Hiddify 可能更合适。安卓客户端的选择思路见 安卓客户端指南，更多客户端请回到 客户端总览。