开始前先确认 ClashX 与订阅格式
ClashX 是 macOS 上的 Clash 图形客户端，主要通过菜单栏图标管理配置、代理节点和系统代理。安装完成后，ClashX 本身并不会自动提供可用节点，必须先导入一份有效的 Clash 配置或订阅。订阅通常由服务提供方生成，里面包含代理节点、策略组、规则、DNS 和端口等配置内容。
在添加订阅前，先确认你拿到的是适用于 Clash、ClashX 或 Clash Meta 的订阅地址，而不是单个 vmess://、ss:// 分享链接。分享链接通常只描述一个节点，不能直接替代包含策略组和规则的完整配置。如果服务商同时提供“Clash 订阅”“通用订阅”“sing-box 订阅”等选项，应优先选择明确标注 Clash 的地址。
| 内容类型 | 能否直接导入 ClashX | 说明 |
|---|---|---|
| Clash YAML 订阅 | 可以 | 通常包含 proxies、proxy-groups 与 rules 字段 |
| Clash Meta 或 mihomo 配置 | 取决于内核 | 使用新协议或扩展字段时需确认 ClashX 版本支持情况 |
| 单个 ss:// 或 vmess:// 链接 | 通常不可以 | 这类链接需要转换为完整配置后再使用 |
| 网页登录地址 | 不可以 | 网页地址不是订阅接口，客户端无法将登录页面当作配置解析 |
在 ClashX 中添加订阅链接
ClashX 的菜单名称会因版本、语言和发行方式略有不同，但基本流程一致：打开配置管理入口，新增远程配置，粘贴订阅 URL，下载配置并将其设为当前配置。安装完成后，可以先点击 macOS 菜单栏中的 ClashX 图标，查看菜单里是否存在“配置”“Profiles”“Config”或类似名称的项目。
使用远程 URL 导入
- 打开 ClashX，点击菜单栏中的 ClashX 图标。
- 进入配置管理区域，选择“远程配置”“Remote Config”或“从 URL 添加”。
- 在 URL 输入框中粘贴服务商提供的 Clash 订阅地址。
- 如果界面要求填写配置名称，可使用“日常订阅”“家庭网络”等容易识别的名称。
- 点击下载、保存或添加，等待配置内容获取完成。
- 回到配置列表，点击刚刚下载的配置，将它设为当前使用配置。
有些 ClashX 版本会把“下载远程配置”和“选择当前配置”分成两个操作。看到配置出现在列表中，不代表它已经生效；通常还需要再次点击配置名称，或选择“Set as Current”“设为当前配置”。配置切换完成后，可以重新打开菜单检查当前配置名称是否已经改变。
如果 ClashX 提供“订阅更新”或“更新配置”选项，第一次导入后建议立即手动更新一次。这样可以确认 URL 有效、服务端返回内容正常，并让客户端保存最新的节点和策略组。如果更新时要求设置更新代理，第一次可以选择直连；只有当订阅服务器在当前网络无法直接访问时，才改用现有代理。
配置名称：日常订阅
配置来源：远程 URL
更新方式：手动测试后再启用自动更新
代理端口：以当前配置的 mixed-port 为准
常见端口：127.0.0.1:7890更新失败时按状态码排查
订阅添加失败或更新失败时，先不要反复点击更新。ClashX 的提示可能只有“下载失败”“更新错误”或“配置无效”，但实际原因可能是链接过期、网络不可达、服务端限制请求头，也可能是返回了 HTML 页面而不是 YAML 配置。记录完整错误信息后，一次只修改一个变量，排查会更准确。
| 错误表现 | 常见原因 | 优先处理方式 |
|---|---|---|
| 401 Unauthorized | 令牌失效或需要重新登录 | 从服务商面板重新复制订阅地址 |
| 403 Forbidden | User-Agent、来源 IP 或访问策略被拒绝 | 重新生成 Clash 类型订阅，并查看服务商要求 |
| 404 Not Found | 旧链接已删除或路径发生变化 | 不要继续使用缓存地址，重新获取 URL |
| 429 Too Many Requests | 短时间内重复刷新过多 | 暂停手动更新，延长自动更新间隔 |
| timeout 或 connection reset | DNS、网络路由或连接被中断 | 切换网络并分别测试直连与代理更新 |
| YAML 解析错误 | 返回内容不是有效 Clash 配置 | 检查返回内容是否为登录页、验证码或 JSON 报错 |
可以在 macOS 终端中检查订阅是否返回成功。下面的地址仅是格式示例，请替换成自己的订阅链接，并注意终端历史记录可能保存完整 URL：
curl -L --connect-timeout 10 --max-time 30 \
-A "clash.meta" \
-o subscription.yaml \
-w "HTTP=%{http_code} SIZE=%{size_download}\n" \
"https://example.invalid/subscription/token"正常情况下，状态码通常是 200，下载文件大小不应为零。若保存下来的文件开头是 <!doctype html>、登录表单或错误说明，就算浏览器能够打开这个地址，ClashX 也无法将它当作配置导入。某些服务商还会按 User-Agent 返回不同内容，因此浏览器测试成功不一定代表客户端请求也会成功。
配置更新间隔不宜设置得过短。个人设备可以先使用 24 小时一次；如果节点经常变化，可设置为 6 小时一次。设置为 5 分钟或 10 分钟会增加服务端压力，也更容易触发频率限制。订阅更新成功后，节点列表发生变化并不代表当前节点会自动切换，当前策略仍可能保持原来的选择。
查看节点、测速并切换策略
配置成功后，ClashX 菜单中通常会出现“代理”“Proxy”或策略组列表。订阅里的节点一般不会直接全部平铺给系统使用，而是先被放入一个或多个策略组，例如“节点选择”“自动选择”“香港节点”“流媒体”或“故障转移”。真正需要切换的，通常是策略组中的当前选项，而不是随意点击一个孤立节点。
先理解节点与策略组的区别
- 节点：具体的代理服务器，例如某个地区、线路或协议实例。
- 策略组：把多个节点组织起来，允许手动选择、自动测速或故障转移。
- 节点选择：常见的手动策略组，适合需要固定地区或固定线路的场景。
- 自动选择：由客户端按照测速结果选择延迟较低的节点，但低延迟不等于所有网站都更快。
- DIRECT：直连选项，表示该流量不经过代理。
如果菜单里有多个策略组，应先选择最上层的主策略组，再在展开的列表中选择节点。例如，“Proxy”策略组当前选择了“节点选择”，而“节点选择”内部又选择了“东京 01”，那么最终使用的就是东京 01。只切换下层策略组但没有切换主策略组，可能看不到预期效果。
使用延迟测试作为参考
在节点或策略组上执行延迟测试时，ClashX 通常会访问一个测试地址并显示响应时间。测试值是某个时间点、某个 URL 的往返耗时，不是完整下载速度。节点显示 80 ms 不代表视频一定比显示 150 ms 的节点快，因为带宽、丢包、拥塞和目标网站位置同样会影响体验。
| 测试结果 | 通常意味着 | 使用建议 |
|---|---|---|
| 20～80 ms | 当前测试地址响应较快 | 适合优先测试，但仍需观察稳定性 |
| 80～200 ms | 跨地区访问较常见的延迟 | 网页、资料访问通常仍可使用 |
| 超过 300 ms | 线路较远、拥塞或网络质量不佳 | 与其他节点对比后再决定 |
| timeout | 测试地址无法通过该节点完成连接 | 换节点并检查协议、端口与网络环境 |
动手完成一次导入与切换
下面以“已经拥有一条 Clash 订阅链接”为前提，按最少步骤完成一次实际配置。操作过程中不要同时修改 DNS、TUN、代理端口等高级选项，以免无法判断问题来自订阅还是本地设置。
- 退出其他可能运行的代理客户端，避免它们同时修改 macOS 系统代理。
- 启动 ClashX，打开菜单栏配置管理入口。
- 新增远程配置，将完整订阅 URL 粘贴到地址栏。
- 下载配置，确认列表中出现新的配置名称。
- 点击该配置并设为当前配置，等待 ClashX 加载内核。
- 打开代理策略组，先选择一个延迟较低且测试成功的节点。
- 开启“设置为系统代理”或“Set as System Proxy”。
- 打开浏览器访问普通网页，确认访问记录和连接状态正常。
- 如果网页无法访问，先关闭系统代理，再重新选择节点测试，不要立即启用 TUN。
首次使用时，建议先选择手动策略组，而不是直接依赖自动选择。手动选择能帮助你确认节点是否真实可用，也能观察切换后的延迟、连接记录和网页表现。等确认配置稳定后，再考虑使用自动测速或故障转移策略。
开启系统代理与关闭代理的方法
切换节点只是改变出站线路，系统代理开关决定 macOS 应用是否把流量交给 ClashX。通常可以在 ClashX 菜单栏中找到“设置为系统代理”“Set as System Proxy”或类似选项。开启后，macOS 的 HTTP、HTTPS 和 SOCKS 代理设置会指向 ClashX 当前监听地址。
系统代理模式并不能接管所有程序。浏览器、终端工具和大多数支持系统代理的应用通常可以正常使用；部分游戏、虚拟机、独立更新器、命令行程序或自行建立网络连接的软件，可能完全忽略系统代理。此时可以考虑 TUN，但 TUN 会涉及网络扩展、管理员授权、路由和 DNS 接管，不建议在基础导入尚未验证成功时直接启用。
| 场景 | 优先模式 | 原因 |
|---|---|---|
| 浏览器访问网页 | 系统代理 | 配置简单，便于判断节点与规则是否正常 |
| 终端工具支持 HTTP 或 SOCKS | 系统代理或手动指定代理 | 可使用本地 mixed-port |
| 游戏或不读取系统代理的软件 | 视需要使用 TUN | 需要额外的网络扩展和路由权限 |
| 临时恢复直连 | 关闭系统代理 | 不会删除订阅，只停止系统流量转发 |
不使用 ClashX 时，建议从 ClashX 菜单关闭系统代理，再退出程序。若直接强制退出，macOS 有时仍可能保留代理地址，导致浏览器显示无法连接。可以在“系统设置”→“网络”→当前网络服务→“详细信息”→“代理”中确认 HTTP、HTTPS 或 SOCKS 代理是否已经取消。
常见问题与处理建议
ClashX 添加订阅后没有任何节点，怎么办？
先确认配置是否已经下载并设为当前配置，再检查订阅类型是否为 Clash 格式。若配置文件可以打开但没有 proxies 或 proxy-providers，可能拿到的是错误页面、纯分享链接或不兼容的订阅格式。重新从服务商面板复制 Clash 专用地址后再测试。
为什么切换了节点，网页访问结果没有变化？
检查系统代理是否开启，以及当前浏览器是否使用了独立代理设置。还要确认切换的是实际生效的主策略组，而不是一个未被 rules 引用的普通分组。若使用规则模式，目标域名可能被规则分配到 DIRECT 或其他策略组。
ClashX 中测速很低，但打开网页仍然很慢，为什么？
延迟测试只表示测试地址的响应时间，不代表下载速度、丢包率和所有网站的访问质量。可以更换两个地区节点进行实际对比，观察网页打开时间、持续下载速度和连接是否中断。对视频、文件下载等场景，带宽和稳定性通常比单次延迟更重要。
关闭 ClashX 后网络无法恢复，怎么处理？
重新启动 ClashX，进入菜单关闭系统代理，再正常退出应用。如果无法启动，可到 macOS 的网络代理设置中手动取消 HTTP、HTTPS 和 SOCKS 代理地址。确认代理设置恢复为空或恢复为原来的企业、校园网络配置后，再测试普通网页。