安装与导入
商店搜不到 / 地区不可用
是否从官方链接进入；Apple 账户地区、系统版本是否符合。
回安装步骤核对。不要下载 Android APK，也不靠改商店 URL 强行换区。
输入框里不是自己的订阅
剪贴板是否被本教程、其他网址或文本覆盖。
回软件云重新复制，然后立即切回 ClashMi 粘贴。
没有粘贴选项 / 被拒绝粘贴
先长按输入框主动粘贴；此前是否拒绝该 App 的粘贴请求。
重新触发粘贴；若系统提供该 App 的“从其他 App 粘贴”设置，按需调整。菜单随 iOS 版本不同。
下载超时 / 网络失败
基础网络、软件云网站是否可达；是否只在 Wi‑Fi 或蜂窝中失败。
换网络再试；若需旧客户端帮助下载，先完成下载，再关闭旧 VPN 启动 ClashMi。
401 / 403 / 404
可能是访问权限、过期/变更地址、限制或拦截；不只一种原因。
登录软件云重新取链接，保留状态码。请区分安装包下载失败和个人订阅导入失败。
YAML / 格式 / 不支持配置
可能复制成登录页、得到 HTML 或其他客户端格式；也可能配置语法有误。
确认 Clash/Mihomo 选项；仍失败把去敏后的报错交软件云支持，不随意拼接参数或使用陌生转换站。
导入后没有预期节点
是否选中正确配置、套餐有效且有流量；订阅是否提供这些节点。
更新一次订阅，连接后再看代理。不要仅凭没有流量余额字段认定导入失败。
连接与访问
开启后马上断开
记录核心日志或报错 → 确认旧 VPN 未抢占 → 更新稳定版与订阅 → 仍失败交支持核查。复杂规则或资源占用也可能影响 iOS VPN 扩展，不要盲目修改大量规则。
显示已连接，但目标打不开
确认主分组不是 DIRECT / REJECT → 更换可响应节点 → 切换 Wi‑Fi / 蜂窝 → 重连并刷新目标。保留当次模式、节点和时间。
全局模式也没用
核对 GLOBAL 分组实际出口。全局不代表自动选择了代理；如果仍是 DIRECT，流量还是直连。排错后恢复规则模式。
只有 HY2 / Hysteria2 不好用
尝试同套餐的 AnyTLS 节点，再对比另一网络。Hysteria2 基于 UDP，网络条件不同可能表现不同；不要承诺它永远更快。
延迟检测显示超时，但网页能用
延迟测试目标可能不可达；不要只凭一个数字删除节点。以实际访问和多次观察判断。
刚换节点，但 App 似乎没变
已有连接未必立即迁移；刷新页面、重新打开目标 App，必要时在 ClashMi 断开重连。
内置“面板”空白或无法操作
先回原生“代理”页完成选择。面板兼容性问题不等于 VPN 必然失效，不要随意更换外部控制器或公开控制密码。
某个站 / App 仍提示地区受限
网络出口、分流规则与目标账号地区分别核对；普通连通测试通过不保证所有地区限定服务都可用。
日常使用与迁移
如何更新订阅？和更新 App、续费有什么区别？
「我的配置」→ 软件云配置右侧「⋮」→「更新」。成功后检查节点，必要时断开重连。
更新订阅是刷新节点；更新 App 请去 App Store；套餐续费请回软件云账户处理。三者不是同一件事。
更新失败时先保留旧配置，不要删除唯一可用的配置。链接已重置时，从账户内复制新链接，再添加并验证。
从 Shadowrocket / ClashZ 等旧客户端迁移怎么办？
- 保留旧 App 和可用配置，确认还能登录软件云。
- 按图文教程安装 ClashMi，重新获取 Clash/Mihomo 格式订阅。
- 准备启动 ClashMi 时，关闭旧 VPN 及其自动重连。
- 确认新版可连接、实际访问正常，并成功更新一次订阅。
- 稳定后再决定是否卸载旧版；旧 App 的本地规则和设置不会自动迁移。
AnyTLS / Hysteria2 / SS 怎么切换？为什么没有 IEPL？
在「代理」里选择对应协议的节点即可，不要手改 type、端口、密码或证书。网络不佳时可换地区，或在套餐提供的 AnyTLS / Hysteria2 / SS 节点间对比。
Hysteria2 使用 UDP，表现取决于网络环境。IEPL 是线路属性，部分专线可能仅适用于定制客户端；以套餐与实际下发线路为准。
内置面板如何选节点？
连接后可从首页「面板」进入。选择主要代理分组，再点具体节点；不要把主分组选为 DIRECT / REJECT。新手优先用原生「代理」页。
订阅能分享吗？要不要修改 UserAgent？
个人订阅相当于访问凭据，不要发群、放进截图或提交到陌生转换网站。泄露后联系软件云支持确认重置方式。
先保留默认 UserAgent。确认 Clash/Mihomo 格式后仍导入失败，请把去敏后的报错交软件云支持，不要猜参数。
App Store 地区不可用，或需要换测试版？
使用本人可下载 ClashMi 的 Apple 账户，不需要退出 iCloud。只改商店网址的 /us/ 不会改变账户地区。不要用 Android APK 安装到 iPhone。
优先用 App Store 稳定版。TestFlight 可能满员或过期，且可能覆盖商店版；换版本前先备份配置。
联系支持时需要提供什么？
设备与 iOS 版本、ClashMi 版本、Wi-Fi / 蜂窝网络、卡在哪一步、报错时间、模式与节点显示名，以及遮住隐私后的截图或报错文字。
不要发送完整订阅、二维码、账号密码或节点凭据。
图片、资料来源与许可
3 张主教程图片引自 ClashMi 官方用户手册；FAQ 内置面板图片引自 官方内置面板说明。原图未改动，名称、流量和到期时间均为官方演示数据。
官方文档标示 GPL-3.0，附 原始许可文本。另参考 ClashMi 官方 FAQ、稳定版界面源码及 Hysteria2 协议说明。
软件云订阅的 iPhone 导入、连接、更新仍未完成实机验收；图片不是本次实测截图。操作以安装版本和账户实际配置为准。