Clash 全平台安装与配置

第一次连接,先按快速上手完成导入、选组和验证。已有配置、准备换设备,或需要查清流量为什么没经过客户端,再按本手册查对应章节。章节中的操作按下载、安装、导入、接管、验证排列。

通用准备:安装包、配置与接管方式

先确定设备和使用范围

到获取客户端按操作系统选包。首次安装优先看该平台可用的 Clash Plus;Linux 可先看 Clash Verge Rev。需要迁移已有配置时,还要确认目标客户端支持原来的协议、策略组和规则集,不能只凭产品名判断。旧设备有一份稳定运行的配置,就先保留原客户端和原配置,等新设备完成验证后再迁移日常使用。

安装前写下要测试的应用。只让浏览器和少数工具走代理,先选系统代理或应用自己的代理设置;需要处理不读取代理设置的应用,再考虑桌面 TUN 或移动端 VPN。两台设备加载相同规则,不代表接管范围相同。流量先要进入客户端,之后才由规则决定直连、走代理或拒绝。没有进入客户端的请求,不会出现在规则记录里。

接管方式先检查什么常见边界
系统代理系统里登记的地址和端口是否与客户端一致应用可使用自己的代理设置,不一定读取系统值
桌面 TUN虚拟网卡、权限、路由和 DNS 是否正常可能影响局域网、企业 VPN 和虚拟网络
移动端 VPN系统授权、当前连接以及应用范围同一用户或资料环境内的 VPN 会争用接管权

区分订阅地址与本地配置

远程订阅是客户端定期获取配置的地址,本地配置则是设备上已有的文件。导入远程地址时,确认服务提供的是目标客户端能读取的格式。节点分享链接、服务管理网页和完整配置文件并不是一回事。地址能在浏览器打开,也不代表返回内容能被客户端解析:浏览器可能已经登录,客户端访问时却只拿到登录页。

订阅地址经常包含账户识别信息,应当按密码管理。不要把完整地址放进工单、截图或共享文档。迁移本地配置时,除了主文件,还要检查规则集和代理提供者引用的资源。桌面配置引用的本机路径在手机上通常不存在;缓存文件可能只是上一次下载的副本。先建立一份可更新的原始配置,再决定哪些自定义改动要搬到新设备。

把下载、加载和启动分开确认

添加配置后,看列表中是否出现新条目,再确认条目能加载并被选为当前配置。部分客户端导入只增加列表项,不会自动启用它;另一些客户端更新订阅后会重新载入,手动选择的节点也可能变化。检查策略组内是否有可用成员,确认规则模式已选中,然后再启动系统代理、TUN 或 VPN。不要把设置项全部打开后才做第一次测试。

验证时各选一个预期直连和一个预期走代理的域名,分别打开新请求。在客户端支持的情况下,对照连接记录中的目标、命中规则和实际出站。不需要用出口地址的变化判定整套规则是否正确:出口地址只反映访问检测站的那条连接。若两个请求都没进日志,先查接管;只有一个选错出站,再查规则与策略组。

准备一条可恢复的基线

改动前停止客户端,确认当前网络能打开常用网页,记录企业代理、专用 DNS 或工作 VPN 是否原本就在使用。基线不正常时,应先恢复网络,不要靠更换多个客户端找原因。切到公共无线网络时,先完成网络登录页认证,再开始接管;否则跳转页面可能打不开,表现看起来很像订阅或节点失效。

Windows:系统代理与 TUN

选择安装包并退出旧客户端

从Windows 下载区获取 Clash Plus。需要切换客户端时,可对照 Clash Verge Rev、FlClash 或 Clash Nyanpasu;Clash for Windows 是停止维护的归档客户端,优先用于查阅旧环境,不作新装选择。下载前打开 Windows「设置」中的「系统」→「系统信息」,核对系统类型与下载页所列架构。系统是 ARM64 时,不要把桌面程序能否通过兼容层运行,与它能否正常安装虚拟网卡或服务混为一谈。

安装前,在旧客户端关闭系统代理和 TUN,再从通知区域退出。仅关闭窗口往往只是隐藏界面。若两套客户端一起启动,可能先后重写同一份系统代理设置,也可能抢占同一本地端口。完成安装后先正常启动一次,不用为了导入配置而把客户端长期设成管理员运行;确需安装网络服务时,只在对应操作发起后确认系统授权。

导入后先验证系统代理

打开客户端的配置管理界面,添加订阅或导入本地配置,等待解析完成,再选中刚导入的配置。切到规则模式,选定代理组成员,开启系统代理。随后到 Windows「设置」→「网络和 Internet」→「代理」核对当前状态。若客户端使用手动代理地址,系统值应与客户端显示的地址和端口一致;若单位设备原本通过脚本提供代理配置,先向管理员确认本机能否变更该设置。

用正常读取系统代理的浏览器打开目标网页,再对照客户端记录。浏览器可用、终端不可用,并不能推出节点故障。某些命令行工具优先读取环境变量或命令自己的参数,部分服务还使用 WinHTTP。可以在终端执行下面的只读命令查看 WinHTTP 代理;它显示直连,并不能否定浏览器正在走代理。浏览器和终端的验证顺序见系统代理分场景排查。

netsh winhttp show proxy

需要验证本地监听时,可以单独给工具指定代理地址,不必改系统设置。若文末示例已加载,且本机使用其中的混合端口,可以执行下列命令。这里的示例出站为直连,收到 HTTP 响应只说明请求能经本地监听发出,不代表远程代理节点已经生效;换用自己的配置时,应填客户端实际显示的端口。

curl.exe -I --proxy http://127.0.0.1:7890 https://example.com/

仅在需要时启用 TUN

如果目标应用不读取系统代理,先关闭系统代理做单独对照,再启用客户端支持的 TUN 功能。遇到权限提示时按该客户端的流程安装或启用服务,等待虚拟网络接口和路由就绪。新建应用连接后查看日志,不要用已经保持多时的下载或会议通话来判断切换是否生效。若启用后断网,立刻关闭 TUN,确认普通联网能否恢复,再查看服务启动错误。

电脑同时运行企业 VPN、虚拟机或容器时,先检查这些环境能否在不改变单位网络策略的前提下共存。外网正常、内网域名打不开,应分别测内网地址和名称解析,区分是路由被接管还是内部 DNS 不再可达。切换模式时不要顺手重置整个网络;这会清掉差异,使下一次复现更难,也可能破坏原有连接。

处理休眠、端口冲突与退出残留

休眠恢复后先观察客户端是否仍运行,再开一个新请求,避免把旧连接超时当成配置失效。如果系统代理仍指向本机,但客户端已退出,浏览器可能无法联网。关闭客户端接管后,将系统代理还原为改动前的状态;单位设备不要一律改成直连。若日志提示端口被占用,先退出占用端口的旧客户端,或在现用客户端改端口,并同步修改手工填写代理的工具。

macOS:架构、网络服务与休眠恢复

按芯片选包并完成首次启动

从macOS 下载区优先选择 Clash Plus,也可按配置兼容性选择 Clash Verge Rev 或 FlClash。ClashX Meta 已停止维护,迁移时先保留原配置备份。打开苹果菜单中的「关于本机」,看硬件信息显示的是 Apple 芯片还是 Intel 处理器,再选择对应架构。兼容层能启动界面,不代表网络组件在同样的环境下就能工作;有匹配架构的安装包时应优先使用。

如果发布包是磁盘映像,打开后按其中提示把应用放入「应用程序」,退出映像中的副本,再从「应用程序」启动;如果是系统安装包,就按安装器流程操作。系统拦截启动时,先确认文件来源和提示原因,再按系统提供的流程处理,避免关闭全局安全保护。升级时先完全退出旧进程,并保留原配置,避免后台仍在运行旧实例而误认为新包无效。

导入配置并核对当前网络服务

用客户端的配置管理界面添加订阅或本地文件,选为当前配置。迁移来的文件如果引用其他目录里的规则集,先解决引用问题,再打开接管。启动规则模式和系统代理后,到「系统设置」→「网络」选中实际联网的服务,在「详细信息」中的「代理」核对。无线和有线可能分别保存代理设置;刚插入扩展坞时,应该检查当前走的是哪条连接,而不是只看无线服务。

先用浏览器打开预期直连和代理的两个目标,在日志中比较规则命中。若终端工具结果不同,先查它自己的环境变量和参数,不必立刻更换节点。下列只读命令查看动态代理配置,可辅助确认当前系统看到的代理状态。输出说明设置如何登记,并不证明某个进程一定采用该设置;是否经过本机监听仍应以实际新请求为准。

scutil --proxy

有些环境原本使用代理自动配置,也就是由脚本决定哪些请求需要代理。如果系统里同时存在自动配置和手动地址,不要只根据某个开关判断最终路径。先记录原设置,按工作网络要求保留必须项,再用不同域名做对照。在公司配置由管理描述文件强制下发时,应联系管理员确认,不要反复覆盖系统自动恢复的值。

启用虚拟网卡前先分离变量

目标应用不读系统代理时,再尝试当前客户端实现的 TUN 接管。不同客户端可能通过不同的网络组件实现,按当前客户端和系统提示授权即可;不要照搬另一款客户端的设置路径。保留一份系统代理能正常使用的基线,关闭它后单独测试 TUN,再打开应用建立新连接。这样可以确认新路径本身可用,而不是浏览器仍沿用旧代理设置而掩盖问题。

如果远程代理能访问,但局域网打印机、文件共享或内部站点异常,先分别访问局域网地址和内部域名。前者不通时检查路由与网段,后者单独失败时检查解析来源。给某个域名设置直连规则,只决定已进入客户端的流量如何出站,并不自动恢复系统发现服务。需要保留工作网络时,先关闭 TUN,确认原网络恢复后再逐项调整。

切网与唤醒后重做一次连接

从无线切到网线,或笔记本休眠后恢复,原有会话可能失效,即使菜单栏图标没有变化。先取一个新的请求,看客户端是否收到;订阅更新也失败时,再检查当前网络是否已完成登录以及本机时间是否正确。如果只有原来打开的程序卡住,可先重连该程序,不要同时改 DNS、换节点并重装客户端。

卸载或更换客户端前,先关闭系统代理和 TUN,再退出应用。如果曾在多个网络服务上开启代理,切到相应服务核对是否恢复。保留改动前的代理截图或文字记录,比出问题后把所有代理选项一并关掉可靠;尤其在受管理的设备上,关闭原本需要的代理也会让网络不可用。

Android:安装 APK 与 VpnService 接管

核对架构、安装来源和原应用

从Android 下载区优先选择 Clash Plus;需要使用原有 Clash Meta 配置时,可对照 Clash Meta for Android 和 FlClash 的兼容情况。Surfboard 也列在下载区,但应使用其支持的配置格式,不要把其他客户端的配置直接改名导入。设备支持哪种应用架构,要以系统支持的 ABI 为准;处理器支持六十四位,不等于系统一定允许安装相应应用。该客户端提供通用包时,可按下载页说明选择。

从浏览器或文件管理器打开 APK 时,Android 可能要求允许该来源安装应用。只对实际打开安装包的应用授权,安装完成后可撤回。如果提示无法安装,先检查系统版本、架构、存储空间以及设备管理限制。若手机已装同名客户端,包名相同但签名不同就不能覆盖升级。不要把卸载当成第一步:卸载可能一并清掉订阅记录和手工改动,应先备份可导出的配置。

载入配置后再发起 VPN 授权

在客户端配置列表添加订阅,或通过系统文件选择器导入设备上的配置文件。导入完成后回到列表,选择要启用的那一项。先确认策略组里看得到可用成员,再启动连接。Android 弹出连接请求时,核对发起请求的客户端名称后确认。系统允许后,客户端才能通过 VpnService 建立本地 VPN 接口。它和订阅的远程代理是两层:看到系统 VPN 状态只证明接管已启动,不能证明节点连通。

手机上的无线网络「代理」设置通常只针对当前无线连接,也不等同于客户端启动的 VPN。正常使用 VpnService 时,不必再给无线网络填一个本地代理。接管后用目标应用实际测试,而不只测浏览器。若客户端提供应用范围设置,确认该应用是否被排除或没有列入允许范围;工作资料中的应用还应在对应资料环境内核对。

处理另一套 VPN 与始终开启设置

同一用户或资料环境内,另一款 VPN 可能已占用系统接管。若授权后立刻停用,打开 Android「设置」搜索「VPN」,检查当前连接与「始终开启的 VPN」指向哪款应用。企业安全连接、DNS 工具和本地过滤工具也可能使用 VPN 接口。受设备管理约束时先确认使用政策,不要直接关闭工作连接。

如果以前开启过「阻止未使用 VPN 的连接」,客户端停下时系统也可能阻止普通联网。排查时先确认开关由谁管理,以及恢复网络是否允许改动它。它和规则里的拒绝出站作用不同:前者在系统层挡住未经过 VPN 的连接,后者由客户端处理已经接入的请求。两者混在一起时,容易出现没有客户端记录却仍然打不开网页的情况。

区分后台中断、切网与订阅更新

锁屏后掉线时,先记下断开条件:熄屏、清理最近任务、电量变低,还是无线切到移动数据。唤醒后检查系统 VPN 状态、客户端通知和新连接记录。只有切网时失败,应先在两种网络分别验证,不要先取消所有省电限制。若系统确实在后台停止客户端,再按品牌系统可用的电池设置,仅调整该客户端的后台权限。入口与现象可查VpnService 授权与省电白名单。

订阅定时更新与连接保持也不是同一项功能。若客户端仍能联网,但锁屏期间没有更新配置,回到前台手动刷新一次,查看加载结果。手动成功才有必要检查后台任务限制;手动同样失败,应转查订阅地址、网络和解析错误。最后在无线和移动数据各做一次短测试,并保留一份能用的配置,避免在出门途中只能依赖一次远程更新恢复连接。

iOS:商店安装、订阅导入与 VPN 状态

通过平台入口安装并梳理已有 VPN

从iOS 下载区进入 Clash Plus 的商店页面并按提示安装。安装前,先看商店页面列出的系统要求,并确认设备安装权限是否受家庭或组织管理限制。若手机已有工作 VPN,先记下它的名称、用途和当前状态。能否安装客户端和能否添加个人 VPN 是两件事,安装完成并不意味着组织允许切换设备的网络配置。

第一次打开后先停留在配置管理界面。设备之前没用过这类客户端时,不必为让浏览器或其他应用接入而填写无线网络的 HTTP 代理。无线网络代理针对特定网络与支持该设置的流量,换热点或者使用蜂窝数据后就不是同一条路径。日常应以客户端建立的系统 VPN 作为测试入口,避免两套代理设置干扰判断。

确认订阅内容,而不只确认链接已保存

使用客户端提供的导入入口添加订阅地址。若改用存放在「文件」里的配置,先确认文件已经下载到设备,且客户端能通过文件选择界面读取它。来自桌面端的配置尤其要注意规则集本地路径、仅在一端可用的协议以及合并配置所依赖的扩展。能显示配置名称只说明条目已建立,选中后能列出规则和策略组,才说明内容至少已被载入。

订阅服务若提供多个导出格式,应选与当前客户端兼容的选项。不要从聊天窗口预览卡片反复转发地址,也不要截图带地址的编辑界面。添加失败时,先看错误发生在拉取还是解析:拉取失败查地址、网络和服务状态;解析失败则着重看响应是不是网页、是不是错误格式,或者配置引用了客户端不支持的字段。

添加系统 VPN 并核对实际生效项

加载配置、选定策略组成员后,在客户端发起连接。首次启动可能触发 iOS 添加 VPN 配置的提示,核对发起方后按系统要求确认。之后可在系统设置中搜索「VPN」,查看当前使用的连接是否与客户端一致;部分系统还把相关入口放在「通用」的设备管理区域。客户端界面显示已启动而系统状态不一致时,先回到客户端停止,再检查是否有其他 VPN 接管。

系统显示 VPN 已连接,只能说明连接已建立到系统网络层。用 Safari 和实际需要联网的应用各发起一个新请求,有连接记录时核对选中的出站。若只是 Safari 表现异常,还应记录当前网络是否启用了其他隐私或过滤功能,先用另一应用比较,不要仅凭一个地址检测页面就宣布全局失效。系统管理的流量与客户端能观察到的请求也不一定完全相同。

分辨热点认证、蜂窝切换和自动连接

酒店或校园热点需要网页登录时,先断开 VPN,完成认证后用普通网页确认网络可用,再重新连接。若只有蜂窝数据无法更新订阅,先确认系统的蜂窝数据设置允许客户端联网,再用同一地址和同一配置做对照。无线和蜂窝的解析及访问条件可能不同,某一网络报错不能直接归因于配置文本损坏。

如果每次断开后 VPN 又自动连上,检查是否配置了按需连接,或是否由设备管理策略拉起。允许调整时,每次只关掉一个自动连接入口并复测。切网后的旧会话可能仍指向不可用的路径;用新的网页请求复查后,再观察原应用是否需要重新打开。若必须回到工作 VPN,先停止个人连接并确认系统显示正确的配置,再进入工作应用。

Linux:发行版包、桌面代理与路由

先区分桌面客户端与独立内核

有图形桌面的设备,可在Linux 下载区先看 Clash Verge Rev,再对照 FlClash。按发行版的包管理体系和实际提供的格式选包;Debian、Ubuntu 一般使用 DEB,采用 RPM 的发行版应选择适配的 RPM。安装前用下面的命令核对架构和发行版。安装包写的 AMD64 通常对应系统显示的 x86_64,ARM64 通常对应 aarch64。架构合适不代表依赖齐全,还应看发行版要求。

uname -m
cat /etc/os-release

用发行版的软件安装器或包管理器安装本地文件,让它报告缺失依赖。不要为了略过报错而强行跨发行版安装。Mihomo 独立内核更适合服务器、路由器或不需要图形界面的环境;它不会替桌面环境设置代理,也不提供桌面客户端的订阅管理界面。只是想让当前桌面会话使用配置时,先完成客户端选型,不必额外注册一个独立内核服务。

以当前桌面用户导入并选中配置

从应用菜单正常启动客户端,在配置管理界面添加远程地址或读取本地文件。不要用提升权限的方式启动整个图形程序来试图修复导入错误;那样可能使配置落进另一套用户目录,或让后续普通用户无法写入。解析后检查当前配置和策略组。若出现文件不存在,先看配置引用路径是否属于旧机器或另一个用户,再区分远程规则集下载失败和本机读取权限问题。

启用系统代理后,在所用桌面环境的网络设置中核对代理地址。GNOME、KDE 和其他桌面环境的入口与传播范围不完全相同;终端进程也不会因为桌面的代理开关而必然继承代理变量。若浏览器有效而终端无效,先用命令自己的代理参数进行一次临时测试,不要先把代理写进所有登录会话的启动文件。容器和虚拟机有各自的网络边界,里面的回环地址并不是宿主机的本地代理。

逐项确认 TUN 所需条件

需要让不读取代理的应用进入客户端时,关闭桌面系统代理后单独测试 TUN。先确认当前客户端支持该功能,按其提示启用所需服务与权限。启用后用下面的只读命令查看接口与路由策略。最好在启用前后各运行一次,用实际差异判断接口有没有建立、路由规则有没有变化。只查看主路由表可能漏掉策略路由;接口存在也不说明目标请求已经进入它。

ip -brief link
ip rule show
ip route show table all

软件安装在受限环境里时,可能没有访问 TUN 设备或更改路由的权限。此时先明确限制来自系统、容器还是打包方式,不要给整个客户端放开不相关权限。远程管理主机更要谨慎:修改默认路由可能中断当前管理会话。没有可用的本地控制台和恢复路径时,先采用应用级代理,等能独立恢复网络后再测试接管。

检查解析路径与后台实例

能访问某个地址却打不开对应域名时,先对比系统解析与目标应用所用解析。在使用 systemd-resolved 的系统上,可用 resolvectl status 查看接口对应的 DNS;没有该服务的发行版,应通过实际的网络管理工具查看。配置文件中的 DNS 并不是所有程序的解析入口。浏览器内置解析、VPN 下发的解析、系统解析和客户端解析可能各走一段,找出出错的是哪一段再改。

最后确认有没有旧的命令行内核或用户服务仍在运行。桌面启动项和系统服务可以分别拉起进程,退出窗口不一定会停掉后台实例。若本地监听报冲突,先确认旧实例是否仍承担其他任务,再停用它或改端口。需要回退时,先按原方式停止接管,恢复桌面代理设置,然后重试普通网络;不要先删除整个配置目录,否则会丢掉判断问题前后的依据。

配置常见问题:更新、规则与 DNS

订阅更新失败,是否要删除原配置?

先保留还能使用的配置。手动刷新一次,记下错误发生在连接、服务器响应还是本地解析。连接超时先换到已知可用的网络验证;如果客户端支持更新请求的出站选择,应确认新设备从未连接时也能取得配置。认证失败要向订阅提供方确认地址是否变更;收到网页或空响应时,不要通过改文件后缀尝试修复,先确认取得的是正确内容。

更新成功但规则未生效时,核对当前选中项、更新时间和客户端是否重新载入了配置。手工编辑订阅生成的内容,可能在下次更新时被覆盖。需要长期追加规则,应使用当前客户端支持的覆写方式;没有这类功能时,保留单独的本地副本,并明确它不会自动跟随订阅更新。更多现象可对照FAQ。

怎样判断流量进来了,但规则选错?

用已知目标发一个新请求。没有连接记录时应先查入口、端口或应用范围;已经进来却走错路径,则检查当前模式和命中的第一条规则。规则模式按顺序匹配,宽泛规则放在窄规则之前,会使后者没有机会命中。命中规则只是选定出站;若规则指向策略组,还要查看组里实际选中的成员。

下面是适用于 mihomo 的最小直连测试配置。请另存为本地配置,不要覆盖订阅。它只在回环地址监听混合端口,用域名后缀规则拒绝测试域名 example.org,其余请求由末尾规则直连。若端口已经被占用,换成可用端口并同步测试工具;若图形客户端覆写本地端口,以界面实际显示值为准。

mixed-port: 7890
bind-address: "127.0.0.1"
allow-lan: false
mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,example.org,REJECT
  - MATCH,DIRECT

通过本地代理分别访问 example.org 和 example.com,对照拒绝与直连结果。这个测试不需要远程节点,只用于确认显式使用本机代理时的入口和规则顺序。若两边同时失败,先确认测试进程确实使用当前监听;若两边都成功,检查是否仍在用旧配置、全局模式或已有连接。测试结束后切回原配置。

启用 Fake-IP 后出现解析异常,先查哪里?

先确认应用的 DNS 请求是否经过客户端。Fake-IP 使用临时映射地址保留域名信息,再由客户端对接入的连接按规则出站。看到映射地址本身并不是故障。真正需要排查的是:应用获得了该地址,但后续连接绕开了客户端;或者本地服务应使用真实地址,却进入了不适合它的解析路径。不要因为看到映射地址就先改掉所有上游 DNS。

只影响局域网设备时,先比较直接访问设备地址与使用设备名的结果,再检查是否需要对相关域名做解析例外。fake-ip-filter 决定哪些查询不走这类地址映射,nameserver-policy 则用于给特定域名选择解析服务器,两者不替代流量分流规则。改动后用新请求测试,留意系统和应用缓存是否保留了旧结果。具体对照见DNS 走向检测与配置。

有延迟结果,为什么应用还是连不上?

延迟测试只验证节点到某个测试目标的结果,不证明任意目标、协议和应用都能工作。先用同一节点测试实际目标,再用同一目标比较另一个节点,最后比较同一应用在不同网络下的表现。HTTPS 能打开也不代表语音或实时应用所需的 UDP 路径正常。观察连接记录、错误类型和关掉接管后的结果,比反复刷延迟更有用。

恢复时先关闭本次开启的接管方式,回到原来的代理和 DNS 设置。确定基础网络恢复后,再加载最后一份成功的配置。若还要继续定位,回到快速上手从导入、选组、连接和验证重新走一遍,每一步都留下可观察的结果;第一次结果不同的那一步,就是下一轮应集中检查的位置。