客户端配置
Stash、Mihomo、Surge、Loon 订阅怎么管理?格式、证书与链接更新指南
了解星渡客户端订阅如何组合节点和分流规则,各客户端格式有哪些协议与证书限制,以及更新、重置和停用链接分别会发生什么。
客户端订阅是一份可更新的配置
在星渡中,客户端订阅将当前组织选中的已部署节点与有序分流规则组合成配置。客户端每次拉取链接时,控制端重新生成内容,因此管理员修改节点选择或规则后,不需要为同一订阅重新分发链接;客户端仍需执行更新才能获得新内容。
这里的订阅不是付费套餐,也不是为每位使用者生成独立节点账号。当前基础订阅使用节点已有的共同凭据。如果需要按个人追踪流量、独立限额或即时撤销单人的节点访问,不能把基础订阅链接当作这些能力的替代。
按实际客户端选择格式
先按实际 App 选择导出格式,再选择该格式支持的节点。Stash 和 Mihomo 的字段映射分别实现,不能因为两个文件都是 YAML 就混用;Surge、Loon 也有各自的协议和证书限制。若保存或下载时提示某个节点不兼容,应调整节点选择或格式,不要手工删除证书验证字段来绕过错误。
Hysteria 2 分享链接只适用于该协议,没有分流规则且默认流量走节点时才能导出。Shadowrocket 暂无专用输出。具体客户端版本对字段的支持仍需实际验证,不应通过关闭证书校验来获得表面的兼容。
从已部署节点创建第一条订阅
- 在节点列表确认至少一个节点部署成功,记下它支持的客户端与协议范围。
- 进入订阅页面,填写容易识别的名称,选择客户端格式和需要包含的节点。
- 先使用简单规则或基础模板,确认策略组中的节点选择与默认出口,再保存。
- 复制订阅链接,或使用页面提供的二维码、导入按钮。按钮只表示尝试打开客户端,仍需在 App 中确认导入。
- 在客户端刷新配置并测试连接。之后调整节点或规则,再刷新一次确认变化,完成整个更新流程。
规则顺序会影响流量去向
可以在单个订阅中配置精确域名、域名后缀或 IP CIDR 规则,按列表顺序匹配,选择代理、直连或拒绝,再指定未匹配流量的处理方式。域名规则使用普通 ASCII 域名,国际化域名需转为 Punycode;域名后缀本身包含对子域的匹配,不需要再加通配符。
规则模板可以在组织内复用,订阅保存应用时的规则副本。修改模板不会自动更新已经保存的订阅,需要重新应用并保存,再让客户端更新。模板、策略组和规则目标应一起检查:规则指向的组需要选入合适节点,未命中规则的流量也要有明确去向。客户端分流规则不等于服务器端访问控制。
既开发又看电影,不必维护两份配置
需要同时覆盖开发与影音时,可以从综合模板开始,再分别给开发、影音和默认策略组选择节点。同一个节点可以分配到多个组;分组的意义是让不同服务有独立选择,而不是要求每组必须购买一台服务器。
例如开发流量选择一个稳定的节点,影音组选择另一个已验证可用的节点,未命中的流量交给默认组。保存后更新客户端,分别检查两个组的选择与实际规则命中。延迟测试只代表测试地址的可达性,不证明某个影音或 AI 服务一定可用。
完整配置模板可能引用由客户端下载的第三方规则源。规则更新与可用性也受上游和客户端网络影响,不能把模板名称理解为覆盖所有网站;遇到漏分流时,先检查具体域名、匹配顺序和规则源更新结果。
下载失败、更新没变化,分别怎么查
- 下载失败:确认链接未停用或重置,所选节点仍可导出,客户端能访问订阅域名;不要把完整链接发到公开 Issue。
- 规则没变化:确认修改后保存了订阅;若只编辑了模板,需要重新应用;再确认客户端已更新正确的远程配置。
- 配置能导入但不能连接:回到节点的服务、端口与证书排查;配置语法正确并不能证明服务器可达。
- 重置链接后旧连接还在:这是链接授权与节点凭据的区别;需要终止节点访问时另行更换凭据或卸载服务。
编辑、重置与停用有不同作用
编辑订阅改变后续生成的配置;重置链接使旧链接失效,并生成新的访问令牌;停用或删除阻止后续拉取。这些操作都不会撤回客户端已经下载的节点认证凭据,也不会保证断开已有连接。
链接本身包含访问授权,持有者无需登录即可获取配置。不要放入公开截图、Issue 或群公告。发生泄露时,除了重置链接,还需要评估节点凭据是否已被获取;必要时移除对应节点并重新部署以更换凭据。
导出成功后,还要完成客户端验收
当前适配器输出与部分配置解析已验证,所有目标 App 的实际导入及转发验收仍待完成。推荐使用一次性测试订阅,不覆盖日常配置,并记录客户端名称、版本、系统与测试结果。
- 导入后检查协议、地址、端口、TLS 名称和证书校验设置。
- 验证实际 TCP/UDP 转发,以及错误证书和错误认证会被拒绝。
- 修改节点选择或规则后,主动更新订阅并确认变化。
- 确认旧链接失效与已下载凭据继续存在之间的区别。