QUICK START / 首次配置
Clash 入门指南
按“导入订阅 → 选择代理模式 → 连接 → 验证”的顺序完成首次设置。本页面向已经安装客户端的用户,流程可作为约十分钟的操作路线;订阅下载和网络排查所需时间取决于实际环境。先完成一次可验证的连接,再调整高级功能。
开始前:客户端与订阅
准备一个已安装且能够正常打开的客户端,以及一条与该客户端兼容的订阅链接,或者一份完整的本地配置文件。客户端负责读取配置、执行规则和建立连接;安装客户端本身并不自动获得代理线路。订阅应由服务提供方或配置维护者提供,普通网页地址、账号登录页面和付款页面不能代替订阅地址。
如果还未安装,先到Clash 客户端安装包页面按系统与处理器架构选择安装文件,再回到本页。首次启动时先确认程序能够进入主界面,不要立刻修改端口、DNS 或 TUN 设置。若设备上已有其他代理工具或 VPN,先断开其连接,避免后续出现流量接管冲突。单位或学校管理的设备,应先确认其网络使用政策和安装权限。
订阅链接可能包含可用于访问服务的身份信息。复制时检查是否混入空格、换行或聊天软件附加的标点,保存时使用便于辨认的本地名称,不要把完整链接发到公开讨论区。本文不需要向任何在线工具提交订阅;遇到格式问题时,优先向提供方确认是否有适配 Clash 或 mihomo 的配置格式。
第一步:导入订阅并启用配置
从链接导入
在客户端侧栏或底部导航中打开“配置”“订阅”或“Profiles”,找到“新建”“添加”或“导入”入口。如果界面提供本地文件与远程链接两种类型,选择“URL”“远程配置”或含义相同的选项。将完整订阅地址粘贴到地址栏;若有名称栏,可填入便于区分的名称。保留其余默认设置,点击下载、导入或保存,等待客户端完成请求和解析。
导入完成后,配置列表应出现一条新记录,可能同时显示更新时间、流量信息或文件名称。这些信息是否存在取决于服务端提供的内容,不是判断成功与否的唯一依据。接着点击该配置或使用其菜单中的“启用”“使用”选项,确认它带有选中标记,再进入代理组页面查看是否出现预期节点。仅把配置加入列表,并不一定会自动切换当前生效配置。
如果提供的是本地 YAML 文件,则在同一页面选择“从文件导入”,从系统文件选择器打开配置,再选中启用。不要把订阅 URL 保存成文本文件后当作完整 YAML 导入,两者内容不同。文件导入通常只读取当时的内容,后续是否自动更新取决于配置内部的远程资源和客户端功能,不能把它直接等同于远程订阅。
导入失败时停在这一阶段检查
遇到超时、拒绝访问或解析错误,先核对链接是否完整、订阅是否仍有效,以及当前网络能否访问订阅服务。若客户端提示字段不支持,可能是配置格式或内核兼容性问题;若下载到的是网页,常见原因是使用了登录页地址或服务端返回了错误页面。此时不应通过切换全局模式来修复,因为还没有可供内核运行的有效配置。
不要反复导入相同链接形成多份难以区分的配置。先保留一份记录,使用其更新功能重试,并查看具体错误提示。若当前环境必须经由代理才能更新,而客户端尚未有任何可用线路,需要向提供方获取可访问的订阅入口或适用的本地配置。更详细的订阅格式与更新问题见帮助中心。当代理组能够显示节点后,再进入模式选择。
第二步:选择规则模式与节点
回到首页或设置页,找到“运行模式”“代理模式”或“Mode”,首次使用选择“规则”或“Rule”。规则模式根据配置中的规则,决定请求使用直连、某个代理组还是拒绝策略。它不是按网站所在地自动作出绝对正确的判断,实际行为由订阅中的规则内容与排列顺序决定;因此后续验证时,还需要查看请求究竟命中了哪条规则。
“全局”通常把被内核接管的请求交给全局策略处理,适合临时对照测试,并不意味着设备上所有应用都已经被接管。“直连”通常使被接管请求直接连接目标,也不能代替关闭客户端。首次配置先固定为规则模式,避免在尚未确认系统代理是否生效时不断切换模式,使问题来源变得难以判断。
随后进入“代理”或“策略组”页面。一个配置可能包含主选择组、自动选择组和按用途划分的多个组。先找到规则实际引用的主组,展开并选择一个准备使用的节点。如果组中选中的是另一个策略组,需要继续确认下一级组的选择;看到一个节点被选中,不代表所有网站都会经过它,不同规则可能引用不同的组。
如果客户端提供延迟测试,点击当前组的测试按钮,等待结果返回。数值表示对指定测试目标的请求耗时,不是带宽,也不保证所有网站都能访问。出现超时可以换一个节点对照,但不要连续快速点击测试。自动选择组会依据自身配置选择节点;手动选择组则需要用户指定。为了方便首次排查,可以先在允许手动选择的组里固定一个有响应的节点。
第三步:开启连接与流量接管
桌面端:内核运行与系统代理
在桌面客户端首页确认内核处于运行状态;有些客户端启动后自动运行内核,有些需要点击“启动”或“连接”。然后在首页、设置页或托盘菜单中开启“系统代理”。这通常会让遵循系统代理设置的浏览器和应用把请求发送到客户端的本地监听端口。内核运行与系统代理是两个环节:只有前者开启,浏览器仍可能直接访问网络。
开启后,先使用一个常规浏览器做测试。若浏览器安装了独立的代理扩展,或应用中手动配置过代理地址,先确认其设置不会覆盖系统代理。Linux 桌面环境对系统代理的支持有所不同;终端、游戏及部分应用也可能不读取系统设置。本轮以能够遵循系统代理的浏览器完成验证,不要因某一个应用未被接管就立即修改所有网络参数。
如果系统代理开关无法保持开启,检查客户端是否报告本地端口监听失败、权限不足,或者被另一个代理程序反复改写设置。先记录报错,再处理对应原因。端口被占用时,不必直接终止未知系统进程;可以退出发生冲突的应用,或按帮助文档修改客户端端口,并确保系统代理指向相同的实际端口。
移动端:允许建立 VPN 连接
在 Android 或 iOS 客户端中,确认当前配置和策略组后点击“连接”或主开关。系统首次可能弹出添加 VPN 配置或建立 VPN 连接的授权提示,核对正在操作的应用后再允许。授权完成返回客户端,等待连接状态稳定。状态栏中的 VPN 标记只说明系统隧道已经建立,不代表远端节点、DNS 解析和规则分流都正常。
若系统已有另一个 VPN 连接,先断开再测试;常见移动系统通常不允许普通 VPN 应用同时接管同一用户环境。Android 若只在部分应用上不生效,还应检查客户端是否启用了按应用代理,以及浏览器是否在接管范围内。若锁屏后连接中断,再检查系统的后台与电池限制,首次操作不需要预先关闭所有省电功能。
TUN 是另一种接管方式,适合处理不遵循系统代理设置的应用,但还涉及虚拟网卡、路由和 DNS。桌面端首次连接先不叠加启用 TUN;只有普通浏览器已经验证成功、又有明确应用需求时,再按系统化配置手册逐步设置。完成本步后,保持当前模式与节点不变,进入验证阶段。
第四步:验证网页、规则与出口
先在浏览器中打开一个已知可正常访问的网站,确认设备本身具备基本联网能力;再访问一个按当前配置应走代理的网站。每次测试都重新发起请求,必要时刷新页面或新建标签页,避免只看到本地缓存。一个网页能打开只能说明该次访问成功,还不能单凭这一点判断使用了哪个出口,也不能证明所有应用都经过代理。
随后打开客户端的“连接”“活动连接”或“日志”页面,再刷新测试网页。查找对应域名或目标地址,展开查看命中规则、使用的策略组及最终节点。如果出现 DIRECT,表示该请求被安排为直连;若显示代理组与节点链路,说明它被交给了相应代理策略。网页可能同时请求多个资源,应关注主站及相关请求,不能只凭任意一条后台连接作判断。
连接列表为空时,先确认页面是否确实产生了新请求,并检查浏览器是否遵循系统代理、移动端应用是否在接管范围内。若记录里有请求但持续超时,说明流量至少已进入内核,排查重点应转向所选节点、服务状态、DNS 或目标站点。对照时一次只改变一个条件,例如换一个节点后访问同一目标,避免同时改模式、端口和 DNS 导致无法复现。
需要进一步确认公网出口时,可访问可信的 IP 查询服务,观察其报告的出口 IP。规则模式下,查询服务本身也会匹配规则:它若走直连,显示本地网络出口是正常现象,不能据此认定整个客户端失效。将查询请求在连接列表中的策略与网页结果结合判断;IP 的地区信息由查询服务数据库给出,可能存在偏差,不宜作为唯一证据。
最终以三个结果结束首次配置:目标网页能够完成加载;客户端中能找到对应的新请求;该请求采用的直连或代理策略符合配置预期。如果网页仍打不开,按“配置有效性 → 节点可用性 → 流量接管 → DNS 与规则”的顺序检查。可转到帮助中心查找对应症状,不要直接重装客户端或清空全部设置。
日常使用:更新与退出
日常启动时,先确认当前配置仍是预期的那一份,再检查连接状态。订阅更新通常位于配置记录的菜单中,点击后等待成功提示,再看节点列表是否变化。更新可能重置部分选择,也可能被客户端保留原选择;若更新后访问异常,先检查主策略组,不必重新导入所有配置。自动更新周期由实际使用频率与服务要求决定,不宜设置得过于频繁。
桌面端结束使用时,先关闭系统代理,再退出客户端;正常退出是否自动恢复代理设置取决于客户端实现。若程序异常退出后浏览器无法联网,可到系统网络设置检查是否仍指向已经停止运行的本地代理。移动端则通过客户端断开连接,必要时到系统 VPN 设置确认隧道已经停止。不要只关闭窗口就假定后台内核和代理设置都已退出。
本页流程完成后,可以继续在新手到进阶手册学习规则分流、TUN 与日常维护。遇到具体故障时,准备客户端名称、系统版本、报错时间和经过脱敏的错误信息,会比单独描述“已连接但不能用”更容易定位问题。分享截图前应遮挡订阅链接、账号信息及可识别的配置名称。