先确认能否使用你账户里的节点

Surge 面向 macOS 和 iOS，具体能力随平台与版本变化。应先看官方支持协议表，再对照账户实际下发的节点。Roxi 当前提供 mihomo YAML、sing-box JSON 和 Base64 节点列表，没有独立的 Surge Profile 输出端点；自动识别出 Surge 并返回列表，也不等于已经生成了 Surge 配置。

准备兼容的配置来源

先在 Roxi 网站登录自己的账户，打开订阅区域，复制“第三方客户端”订阅地址。不要复制官网首页、邀请链接或浏览器地址栏里的登录地址。客户端不附送节点；套餐、流量、到期时间和设备限制以账户页为准。

  1. 复制并保管自己的订阅，在服务方或自己的可信本地工具中取得与 Surge 版本匹配的配置。先确认具体节点协议、传输和参数被支持。
  2. 若只有一条兼容节点，可通过 Surge 的配置编辑器手工添加该代理，再建立策略组和规则；所有服务器与认证参数来自自己的配置，不能从示例中猜。
  3. 如果账户本轮没有可用的兼容协议，先使用本目录里能直接读取相应格式的客户端，或向服务方索取适配配置；转换工具不能让内核凭空支持另一个协议。

核对四层配置

区段作用常见错误
[General]DNS 等全局选项把其他客户端字段直接复制进去
[Proxy]兼容协议的节点定义把整段 Base64 或 JSON 填在这里
[Proxy Group]手动或自动选点引用了不存在的代理名称
[Rule]请求去哪个策略节点存在，但 FINAL 或目标规则仍指向 DIRECT

加载、连接和更新

  1. 在新的配置副本中加载并检查语法，确认没有“未知协议/字段”，再设为当前 Profile。
  2. Mac 先验证系统代理，需要更广接管时再验证 Enhanced Mode；iPhone 启动后确认 VPN 授权。
  3. 在请求记录里核对目标域名、命中规则和实际策略。手动节点不会自动随原订阅更新；节点变更后重新核对参数，或改用可信的托管 Profile。

失败后按层排查，保留可恢复的配置

现象先核对下一步
下载失败或 401 / 403订阅地址、账户状态、设备限制和当前网络回账户复制新地址；看响应说明，不连续重复导入
解析失败 / 节点为零下载到的是 YAML、JSON、节点列表还是登录网页换成本文指定格式，保留错误字段名与客户端版本
能启动但目标打不开当前节点、规则、DNS 和请求日志换一条兼容节点做对照，勿删除 TLS 校验
停止后不能直连系统代理、其他 VPN、断线阻止设置先在客户端正常停止接管，再退出；恢复改动前设置

求助只提供系统与客户端/核心版本、失败阶段、发生时间和脱敏日志。升级前备份本地规则；订阅更新会替换远程内容，个性化设置尽量放在客户端支持的覆写或本地规则里。