入门指南 / 首次配置
Clash 使用教程:
订阅导入与连接验证
按“导入订阅 → 选择代理模式 → 连接 → 验证”完成首次设置。先使用默认网络设置建立可验证的连接,再考虑 TUN、DNS 或自定义规则。客户端已安装、订阅可用时,可按约十分钟的首次配置流程操作;下载与网络排查所需时间另计。
开始前准备:安装适合设备的客户端,并确认普通网络可以正常访问网站。尚未安装时,先到Clash 下载页选择平台与架构。准备好由服务提供方交付的兼容订阅链接,或已有的 YAML 配置文件。客户端负责读取配置和转发流量,不会因为安装完成就自动获得可用节点。
首次操作只保留一个代理客户端运行。若设备已有其他 VPN、网络加速或代理工具,先断开其连接,保留原设置记录。这样后续出现异常时,可以判断是哪一项改动造成影响,而不是在多个接管层之间反复切换。
1. 导入订阅并启用配置
打开服务提供方的订阅管理页面,寻找标注为 Clash、Clash Meta 或 mihomo 的配置入口,复制完整订阅地址。订阅地址通常带有个人访问参数,应按凭据保管。不要发送到群聊、公开截图或陌生的在线转换页面;向他人求助时,只描述错误类型并遮住完整地址。
回到客户端,打开“订阅”“配置”或“Profiles”页面,选择“新增”“导入”或对应的加号入口。若可以选择配置类型,使用远程订阅;在 URL 输入框粘贴地址,再填写便于识别的本地名称。确认地址开头、末尾没有空格或换行,然后点击下载、保存或导入。此时客户端会请求远程内容,等待操作结束后再继续,不要连续点击生成多个相同条目。
导入成功后,列表应出现对应配置。点击该条目,或使用“启用”“设为当前配置”一类操作,使其成为正在使用的配置。部分客户端把“下载成功”和“启用成功”分成两步:仅在列表中看到名称,还不能证明内核已加载它。检查当前配置标识,再进入代理页面,确认能看到代理组以及组内的节点。
如果拿到的是本地文件,选择“从文件导入”,定位到已有的 config.yaml 或其他 YAML 配置文件。导入后同样需要启用。文件名并不决定内容是否兼容;不要把网页另存为的 HTML 文件改名为 YAML,也不要把单个节点链接直接当作完整配置文件。首次上手优先使用服务提供方明确支持的配置格式,避免在导入前手动改动字段。
遇到“解析失败”时,先检查复制内容是否确实是订阅地址,而不是服务商首页、登录页或付款页面。若提示请求失败,先在原管理页面确认链接仍然有效、服务状态正常。订阅链接可能包含敏感内容,不建议为了检查返回结果而随意粘贴到外部工具。导入成功但节点为空,则返回配置页面确认当前启用项,并向服务提供方确认订阅包含节点。
完成这一阶段后,应同时满足两个条件:当前配置已经选中,代理页面能显示可选节点。满足后进入下一步,不必立即修改更新间隔、DNS 或端口。订阅与配置文件的区别可在概念速查中阅读;持续导入失败时,转到疑难手册按订阅症状排查。
2. 选择规则模式与代理节点
配置加载后,打开“代理”“模式”或客户端首页的模式选择区域。首次使用选择“规则”或“Rule”。规则模式会按照当前配置的规则顺序判断连接应该直连、通过代理组还是拒绝。它适合作为日常起点,但最终分流结果取决于配置本身,并不保证每个网站都自动符合个人预期。
部分界面同时列出“全局”和“直连”。全局模式通常把进入内核的连接交给全局策略,适合临时对比;直连模式通常让进入内核的连接直接发出。这里的关键是“进入内核”:模式切换不能替代系统代理或 VPN 接管,尚未接入客户端的应用不会因为选择全局就自动被代理。先停留在规则模式,不要用频繁切换模式代替后面的连接设置。
接着查看代理组。代理组名称由订阅决定,可能使用“节点选择”“自动选择”等名称。展开用于代理流量的主组,选择一个可用节点。如果组内列出的还是另一个代理组,继续查看该组最终选中的目标,确认没有停在不符合预期的 DIRECT 策略上。不要只更改一个名字显眼、实际却未被规则引用的组。
客户端提供延迟测试时,可以运行一次测试,排除明显无法建立测试连接的节点。测试值只反映指定测试目标下的结果,不代表带宽,也不保证所有网站都能访问。某个节点显示超时,可能与测试地址、当地网络或远端服务有关;先选一个能完成测试的节点继续验证,不必在此阶段反复追求最低数字。
如果组采用自动选择策略,手动选择的入口与行为可能不同。可以先保留订阅默认的自动组,也可以在支持手动选择的主组中指定节点。无论使用哪种方式,都应记住最终策略,方便第四步对照连接记录。修改后若有“应用”或“重新加载”按钮,按界面提示完成操作;若界面即时生效,则不用额外重启客户端。
到这里,确认模式显示为规则,主要代理组有明确选择,即可建立连接。需要理解 rules、proxy-groups 与 MATCH 的关系时,先看规则与分流术语。本次不需要编辑规则列表,也不需要把整份订阅覆盖成网上找到的示例配置。
3. 开启系统代理或批准 VPN 连接
先回到客户端首页,查看内核或服务是否处于运行状态。只有界面打开不代表代理服务已经启动;若显示停止、启动失败或端口占用,先处理该提示,再打开系统接管。正常启动后,按当前平台选择下面对应路径,不要把桌面端的系统代理开关和手机端的 VPN 授权混为一项设置。
桌面端:先用系统代理
Windows、macOS 与带桌面环境的 Linux 通常可以先开启客户端的“系统代理”开关。它会把系统支持的代理设置指向本机代理端口,让遵循这些设置的应用接入内核。macOS 若请求修改网络设置或安装客户端所需的服务组件,先确认提示确实来自刚安装的客户端,再按系统要求授权。Linux 的桌面环境支持情况不同;若客户端无法写入系统代理,可在桌面网络设置中手动填写客户端显示的本地地址与端口。
地址与端口必须以当前客户端设置页为准。HTTP 或混合代理通常使用本机地址 127.0.0.1,端口则读取界面实际值;不要因为其他教程使用某个数字就直接覆盖。HTTP 代理端口与 SOCKS 端口不一定相同。首次连接不需要打开“允许局域网连接”,也不应把代理监听暴露给不受信任的网络。
系统代理开启后,浏览器通常可以用于第一次验证。终端工具、游戏和部分应用可能不读取系统代理,因此暂时没有被接管并不等于节点失效。先让浏览器验证通过,再为确实需要的应用配置单独代理。需要接管更多流量时再研究 TUN;本次不要同时开启系统代理、TUN 和另一个 VPN,以免无法判断实际流量路径。
移动端:确认系统 VPN 授权
Android 或 iOS 上,返回客户端首页点击连接、启动或对应开关。首次连接时,系统通常会提示添加 VPN 配置或建立 VPN 连接。核对应用名称后批准请求;iOS 可能还要求使用设备密码或生物识别确认。拒绝授权会使连接无法建立,返回应用重新发起即可,不必删除已经导入的订阅。
授权后,查看客户端是否显示已连接,并在系统 VPN 设置或状态区域确认连接状态。手机通常不能同时保持多个普通 VPN 应用的连接,若另一项连接仍在运行,先将其断开。Android 若设置了按应用代理,确认用于验证的浏览器已包含在接管范围内;iOS 若连接后很快断开,先保持应用在前台查看错误提示,再做下一步。
当内核运行正常、桌面系统代理已开启或手机 VPN 已连接时,进入最后一步。此时的“已连接”只说明本地接管已建立,远端节点与目标网站是否可达,还需要实际访问确认。
4. 验证访问结果与规则命中
打开浏览器,新建标签页访问一个平时可以正常打开的网站,确认基础访问没有因设置变更而中断。再打开一个按当前配置预期应通过代理访问的网站,等待页面实际加载。不要只看客户端开关、托盘图标或延迟测试结果;页面内容能否持续加载,才是连接验证的一部分。
访问的同时,回到客户端的“连接”“Connections”或日志页面,寻找刚才打开的网站对应记录。若界面支持搜索,可输入目标域名缩小范围。查看目标、命中规则以及最终策略链:预期代理的连接应落到相应代理组或节点,预期直连的连接则可能显示 DIRECT。部分请求会因为缓存没有产生新连接,必要时刷新页面,或换一个未打开过的目标再观察。
若网站可以访问、连接记录也与预期一致,即可保留当前设置。出口 IP 查询可以作为辅助对照,但只能说明该次查询请求的出口,不能单独证明所有应用都经过代理。在规则模式下,不同网站走不同策略本来就是正常行为,不必因为两个网站显示不同出口就改成全局模式。
若网站打不开,而且客户端中没有相应连接记录,优先检查流量是否进入客户端:桌面端确认系统代理仍然开启,浏览器扩展没有另行指定代理;移动端确认 VPN 没有断开,验证应用位于接管范围内。终端命令无法连接而浏览器正常时,先检查该工具自身的代理支持,不要立即更换节点或修改 DNS。
若已经出现连接记录,但请求报错或长期停留在连接中,说明流量至少到达了客户端。先看最终选择是否正确,再只更换一个节点重试同一目标。若只有单个网站失败,查看该域名命中的规则;若多个目标均失败,再检查订阅服务状态与本地网络。日志中出现域名解析相关错误时,记录错误摘要,按疑难手册中的 DNS 与节点超时排查流程继续,不要直接复制陌生的 DNS 配置覆盖现有设置。
最后测试一次退出与恢复。桌面端关闭系统代理后再退出客户端,确认普通网站仍能访问;移动端断开 VPN 后同样检查基础网络。随后重新打开客户端,确认当前配置、规则模式与代理组选择仍然正确,再按需要连接。只有在手动流程稳定后,才启用开机启动、启动时自动连接或自动更新订阅等便利功能。
首次连接到此完成。日常使用优先保持规则模式,订阅更新后检查当前配置与节点选择。需要解释配置字段时查概念速查;遇到无法上网、更新失败、系统代理不生效等持续问题时再查疑难手册,无需从头重装客户端。