FAQ

❓ 常见问题

支持哪些客户端和目标格式？

当前稳定版支持 Clash、ClashR、Surge、Quantumult、Quantumult X、Loon、Surfboard、Stash、Sing-box 及多种传统订阅格式。clash、clashr 节点链接使用 Mihomo 解析桥，其他目标使用客户端原生远程资源、对应生成器或兼容解析器。完整列表见客户端与目标格式。

为什么不同目标使用不同的解析器？

非 Mihomo 客户端需要各自的输出格式，很多目标无法直接复用 Mihomo 配置模型。项目使用兼容解析器和独立生成器处理这些目标，并按目标能够表示的字段过滤节点；相关能力仍会持续优化。

公共实例会下载我的订阅吗？

取决于目标和参数。默认 Clash/ClashR、Surge、QuanX、Loon、Surfboard、Stash 远程资源通常由客户端更新；list=true 和其他服务端解析目标会由后端下载订阅。

无论正文是否下载，/sub 请求仍可能携带订阅 URL。敏感订阅建议自行部署。

为什么 Provider 在客户端更新失败，但转换链接返回 200？

后端成功生成 Provider 不代表客户端一定能访问 Provider URL。检查客户端网络、订阅有效性、proxy: DIRECT、服务商 User-Agent/请求头要求和客户端支持格式。

怎样取消 Mihomo Provider 的 proxy: DIRECT？

单条订阅：

proxy_direct:false,https://example.com/sub

整个请求：

&provider_proxy_direct=false

自部署默认：

[proxy_provider]
proxy_direct = false

优先级见特色参数与扩展语法。

怎样修改 Provider 更新间隔？

单条订阅：

interval:21600,https://example.com/sub

自部署默认：

[proxy_provider]
interval = 21600

Surge、QuanX、Stash 的间隔语义与 Mihomo 不完全相同，Surfboard 和 Loon 不接受此扩展。

为什么 proxy_subscription 对 Provider 更新没有作用？

因为 Provider 由客户端更新，不经过 SubConverter-Extended。proxy_subscription 只控制后端实际下载订阅的路径，例如 list=true 或服务端解析目标。

为什么生成配置后所有节点都不可用？

先检查 DNS。除 Stash 独立模板外，默认输出通常不是完整 DNS 配置。还要检查 Provider 更新、客户端版本、节点有效性和目标格式是否保留了必要字段。

为什么 managed_config_prefix 必须修改？

默认回环地址只对服务所在设备自身有效。其他设备加载托管配置时，需要能够访问实际局域网地址或 HTTPS 域名。

可以直接把 lan 实例暴露公网吗？

不建议。lan 保留请求访问本地、私网和 fake-ip 资源的历史行为。公网实例应使用 public 或 strict，并配合 HTTPS、端口隔离和入口访问控制。

allow_public_upload=false 为什么在 lan 仍可能允许上传？

该开关只决定 public 档位的公开上传。lan 保留历史允许行为，strict 始终禁止。需要无条件禁止公开上传时使用 strict。

Dashboard 为什么返回 404？

/dashboard 只在 statistics.enabled=true 时注册。修改配置后需要重启服务。

能否通过 /healthz 判断转换服务完全正常？

不能。它只返回进程存活状态。还需要检查 /version 和至少一个真实 /sub 转换。

能否把整个宿主机目录挂载到容器 /base？

不建议。这样会遮盖镜像内随版本更新的模板、规则和运行文件。只挂载用户配置文件和统计目录。

Wiki 和 README 描述哪个版本？

默认描述稳定版 master。开发分支 dev 可能包含尚未发布的目标和参数，不会提前作为稳定功能写入用户手册。

怎样安全地报告问题？

提供版本、修订、部署方式、客户端、target、状态码、X-Request-ID 和脱敏 explain 报告。不要提供真实订阅 URL、节点、token、Cookie 或完整查询日志。