订阅更新失败：先区分下载、解析与节点连接
FlClash 更新订阅时，需要先访问订阅地址，取得配置内容，再解析并保存。节点连接发生在另一条流程中。因此，“订阅更新失败”与“节点测速超时”需要分别处理：旧配置里的节点仍然能用，不代表订阅地址仍然有效；订阅更新成功，也不代表其中每个节点都可连接。
排查前先保留当前可用配置。记录失败发生的时间、错误文字，以及本次使用的网络。暂时不要删除旧订阅，也不要连续修改 DNS、TUN 和规则模式。一次只改变一个条件，才能判断是哪一步起作用。
| 错误或现象 | 优先检查 | 下一步 |
|---|---|---|
401、403 |
令牌、账号权限、服务端访问限制 | 登录订阅来源，重新复制客户端专用链接 |
404、410 |
旧接口、链接路径、已撤销的地址 | 确认提供方是否更换了订阅入口 |
429 |
请求频率限制 | 停止连续刷新，按服务端提示等待 |
timeout、连接超时 |
网络路径、代理出口、服务端响应 | 换一种网络路径后手动更新一次 |
YAML、解析失败 |
响应正文、订阅格式、内核支持情况 | 确认拿到的是 Clash / mihomo 配置 |
错误码是线索，不是唯一结论。例如，403 既可能表示订阅权限失效，也可能来自网站的访问防护；200 只说明 HTTP 请求有响应，响应内容仍可能是登录页面。
手动刷新位置：从配置条目确认更新结果
常见操作路径是「配置」→ 找到对应的远程配置 → 点击该条目的更新图标，或打开条目菜单选择「更新」。不同平台与发行版本可能把操作放在卡片右侧或更多菜单中；应针对具体订阅条目操作，而不是只重启首页的连接开关。
- 确认配置类型。通过链接添加的远程配置才有可供重新请求的订阅地址。从本地文件导入的配置，需要重新导入文件，或另外添加远程链接。
- 只更新一个条目。订阅较多时，先单独更新出错项，避免批量请求让错误提示混在一起。
- 等待本次请求结束。查看成功提示、错误详情及更新时间；连续点击不会修复失效链接，还可能触发频率限制。
- 确认当前选中项。更新了配置 A，但仍选中配置 B 时，代理组与节点列表未必发生变化。
链接失效与权限问题：重新取得正确的订阅入口
区分订阅链接、管理页面与分享链接
FlClash 需要能够直接返回配置内容的地址。账号面板的网址、需要登录后才能访问的下载页面，以及普通节点分享链接，都不等于完整的 Clash 订阅。到提供方的订阅区域，选择标注为 Clash、Clash Meta 或 mihomo 的入口；如果入口细分客户端，优先使用明确支持 FlClash 的选项。
复制后检查地址是否被聊天软件截断，末尾是否带入空格、换行或中文标点。查询参数中的令牌应保持原样；不要自行删除看起来多余的参数，也不要反复解码或编码其中的特殊字符。
按响应状态处理权限与限流
- 401 或 403：检查账号状态、订阅权限以及令牌是否被重置。若浏览器显示验证码或访问验证，客户端通常无法按网页交互完成验证，应向提供方索取客户端可用入口。
- 404 或 410：检查旧订阅接口是否已迁移。从面板重新复制，不要只在旧地址上尝试改域名。
- 429：暂停手动更新与其他设备的密集请求。若响应提供
Retry-After，按其要求等待后再试。 - 500、502 或 503：可能是订阅服务或上游暂时异常。保留旧配置，稍后重试；持续出现时再联系提供方。
请求超时与证书错误：检查实际访问路径
订阅请求不一定与浏览器使用相同的出口。浏览器可能走系统代理，而客户端的配置下载请求可能采用自身的请求策略；TUN 开启后，流量路径也可能改变。因此，浏览器能打开订阅网址只能证明一条路径可达，不能直接证明 FlClash 的更新请求可达。
用两次对照缩小范围
- 本地网络对照：在 Wi-Fi 下记录一次错误，再切换手机热点或另一条可信网络，手动更新同一条订阅。如果只有一条网络失败，优先检查该网络的 DNS、门户认证或访问限制。
- 出口路径对照：保留旧配置。如果当前版本提供订阅更新的代理选项，可分别测试直连与已有可用代理；没有该选项时，不要把“切到全局模式”等同于必然改变订阅下载路径。
出现 no such host 一类错误时，先检查域名拼写与 DNS 解析。出现 connection refused 时，检查是否访问了已经停止监听的本地代理端口。若错误指向 127.0.0.1:7890，这里的 7890 只是该次请求使用的端口，应与客户端实际配置核对，不能直接当作所有安装的默认值。
证书错误则先检查系统日期、时区与自动校时。certificate has expired 可能来自服务器证书过期，也可能来自设备时间异常；证书域名不匹配时，应核对订阅域名与重定向目标。不要通过关闭证书验证来掩盖问题，订阅令牌需要受到 HTTPS 保护。
如果首次导入的地址只能通过代理访问，而客户端尚无可用配置，可向提供方询问可直连的订阅入口或本地配置导入方式。反复刷新同一个不可达地址，无法建立最初的访问路径。
格式解析失败：确认返回的是 Clash / mihomo 配置
Clash 系列客户端通常使用 YAML 配置。其他客户端使用的 JSON 配置、编码后的节点 URI 列表，不能仅靠修改文件后缀变成可用的 Clash 配置。FlClash 使用的 mihomo 内核与原版 Clash 在功能支持上也存在差异，订阅需要匹配实际客户端能力。
检查内容，而不是只看扩展名
- 正文以
<!DOCTYPE html>或登录表单开头：拿到的是网页，优先处理登录、重定向或访问验证问题。 - 正文主要是
vmess://、ss://等链接：可能选择了节点列表订阅，应改用提供方的 Clash / mihomo 输出入口。 - 错误指出行号与列号：检查对应位置及上一行的缩进、引号和冒号。YAML 缩进使用空格，不要混入 Tab。
- 提示代理类型或字段不支持：核对配置要求与当前客户端、内核版本，再决定更新客户端或选择兼容格式。
下面仅展示 YAML 的层级与规则结构，不包含节点，也不是可用于代理的完整订阅。实际远程配置可能使用 proxies，也可能通过 proxy-providers 引用节点来源，不能只凭缺少某一个字段就判定文件无效。
proxy-groups:
- name: 出站选择
type: select
proxies:
- DIRECT
rules:
- MATCH,出站选择如果配置本身下载成功，但某个 proxy-providers 或 rule-providers 更新失败，应继续检查对应资源的地址与错误信息。这是配置内部资源的下载问题，与主订阅地址无法下载属于不同层次。
部分服务会根据请求的 User-Agent 返回不同格式。浏览器下载到的内容与客户端获得的内容可能不同；遇到这种情况，应让提供方确认 FlClash 的适配入口，而不是随意修改请求标识或把私人订阅交给来源不明的在线转换服务。
自动更新间隔：在远程配置编辑项中设置
先完成一次手动更新，再配置自动更新。常见入口是「配置」→ 对应远程配置的更多菜单 →「编辑」→ 查找自动更新开关与更新间隔。具体字段名称、可选单位及入口位置以安装版本为准；本地文件配置通常不会提供同样的订阅更新选项。
先看单位，再填数值
自动更新间隔表示两次计划更新之间的时间，不是请求超时，也不是节点测速周期。例如，1 小时等于 60 分钟或 3600 秒；24 小时等于 1440 分钟或 86400 秒。若界面单位为分钟，填写 60 才表示每小时，不能把秒数直接填进分钟字段。
| 使用情况 | 可参考的间隔 | 设置依据 |
|---|---|---|
| 配置与节点较稳定 | 24 小时 | 减少重复请求，需要时再手动更新 |
| 提供方经常调整节点 | 6 小时 | 兼顾变更获取与请求频率 |
| 提供方要求较短周期 | 按提供方说明 | 同时遵守接口限流要求 |
表中的间隔是设置建议，不是 FlClash 的默认值。不要假设填 0 就代表关闭：不同版本对零值可能有不同处理。停用自动更新时，优先使用明确的开关，并在保存后重新打开编辑页确认设置已保留。
自动更新没有按时发生时检查什么
自动更新通常依赖客户端运行与系统调度。桌面端退出进程、电脑休眠，或手机限制后台活动，都可能推迟执行。Android 的电池优化、后台网络权限尤其值得检查；调整前先理解耗电影响，不必一次性放开所有后台限制。
保存设置后记录一次成功更新时间，保持客户端运行，跨过设定周期再检查。若中间有休眠或断网，恢复后先手动更新确认链接仍可用。自动更新无法修复过期令牌、错误格式与服务器限流，也不应被理解为严格到秒的系统定时任务。
恢复后的检查顺序与反馈信息
- 确认订阅请求成功。查看对应配置的成功提示与更新时间，而不是只看首页连接状态。
- 确认配置已选中。核对代理组、规则及节点来源是否属于刚更新的配置。
- 单独测试节点访问。如果更新已经成功但访问仍失败，再检查节点、规则命中、系统代理与 TUN，不要继续反复替换订阅地址。
- 最后启用合理的更新周期。避免多个客户端同时以很短间隔请求同一订阅。
持续失败时，可整理系统类型、FlClash 版本、内核版本、失败时间、网络类型与脱敏错误文字。补充“换网络是否成功”“旧配置是否仍可使用”“失败的是主订阅还是内部资源”这三项，通常比一张只有“更新失败”的截图更有判断价值。