Troubleshooting zh

故障排查

🌐 English · Русский · 中文

错误信息的含义与处理方法。部分信息带有稳定代码（如 [E-20]）——把代码告诉服务商客服比任何描述都快。

错误代码

代码	提示内容	实际发生了什么	怎么办
E-10	服务器返回了空响应	面板有响应，但内容为空	稍后重试；持续出现请联系服务商
E-11	服务器返回了网页而非配置	收到的是 HTML 错误页/限流页，不是 YAML	等一分钟再试；确认链接是订阅地址而不是面板页面
E-20	无法连接订阅服务器	DNS/TLS/连接失败——网络问题或域名被封锁	检查网络；换个网络试试；面板域名可能在你所在地区被封锁
E-30	订阅已使用 age 加密，密钥缺失或错误	内容已加密，而应用没有（或持有错误的）解密密钥	从面板导入完整链接（密钥在 # 之后），或在 配置属性 → Age 密钥 中设置。参见加密订阅

常见情况

导入成功，但连接后什么都不通

最常见原因：订阅通过代理拉取规则列表（rule-providers 中的 proxy: 字段），而该节点宕机或不可达。应用能连上，但规则是空的，流量无处可去。

• 打开日志，查找 initial rule provider … error 或 dial … i/o timeout 之类的行——dial 行中的地址就是连不上的节点。
• 换一个节点 / 向服务商确认服务器状态，然后重新连接。

刚添加订阅就提示 “Run timed out”

与上一条同类：某个规则源没能及时下载（域名被封或途中节点失效）。订阅本身下载正常。等节点可达后重新连接——规则源也会在后台自动重试。

“引擎拒绝了此配置”

订阅的 YAML 确实无效（提示中会引用具体原因，如 proxy 'X' not found）。这是面板下发的配置问题——把提示转给服务商。

配置卡片上的流量/到期时间看起来过期了

用量数据与配置来自同一次下载。下拉刷新配置；如果面板不发送 subscription-userinfo，会保留旧数据而不是清零。

如何阅读日志

应用内的日志显示引擎自身的消息。反馈问题时，连接/导入前后几秒的截图比任何描述都有用：

• [TCP] dial <分组> … error: <ip>:<port> … i/o timeout —— 节点 <ip> 不可达
• initial rule provider <名称> error —— 规则列表下载失败
• decrypt config error / [E-30] —— 解密密钥缺失或错误