Windows
查看 Clash Nyanpasu、Clash Plus 与 Clash Verge Rev 等桌面选项。安装前确认系统架构，首次运行先导入配置并验证系统代理；需要接管更多应用时，再检查服务权限和 TUN 设置。已有其他代理软件运行时，应先避免端口与系统代理设置相互覆盖。
前往下载 →规则分流从配置到连接的设置路径
阅读技术参考 →Clash Nyanpasu 将配置管理、代理模式和内核运行状态放在图形界面中。开始使用时，先确认配置能够加载，再检查流量如何进入内核，最后查看规则把连接交给哪个策略。下面的窗口是设置示意，帮助理解各项功能的分工；具体菜单名称与可用选项以安装的客户端为准。
当前模式
规则全局直连
系统代理已开启
允许局域网连接已关闭
示意窗口，仅用于说明设置含义。
代理模式决定进入内核的连接如何选择出口。日常使用可先选择规则模式，让域名、地址和规则集按配置分流；全局模式把连接交给全局策略，适合临时验证出口；直连模式则用于对照网络状态。切换模式不会自动修复失效的订阅，也不会改变应用是否遵循系统代理。与同样使用 mihomo 的其他图形客户端相比，分流结果主要取决于内核与配置，而不是界面名称。排查时一次只改一项，更容易判断变化来自哪里。
导入远程配置
粘贴订阅链接导入
自动更新订阅已开启
导入后的下一步选择当前配置
订阅管理把远程链接转换为可加载的本地配置。导入前应确认链接返回 Clash 兼容的配置，而不是登录页面、错误提示或其他客户端专用格式。导入后还要选中这份配置，查看策略组是否出现，再按需要开启自动更新。远程更新可能覆盖直接修改的内容，长期保留的调整应通过客户端支持的覆写或合并机制处理。不同客户端的订阅入口与合并方式并不完全一致，迁移时应核对最终生效配置，不能只比较订阅名称是否相同。
规则示例 · Proxy 需预先定义
DOMAIN-SUFFIX,github.com,Proxy
GEOIP,CN,DIRECT
MATCH,Proxy匹配顺序从上到下，先匹配先生效
规则负责识别连接，策略组负责决定出口，两者需要用准确的名称关联。示例先将指定域名交给 Proxy，再匹配中国大陆地址的直连规则，最后用 MATCH 处理剩余连接。这里的 Proxy 是策略组名称，并非自动创建的保留字。规则写得更具体并不代表一定生效，还要看它前面是否已有范围更大的匹配项。相同配置在不同客户端之间迁移时，应同时核对规则集、数据库与内核支持情况；遇到走错出口，优先查看连接记录中的实际命中规则。
TUN 模式按应用需求启用
可选网络栈
gVisorSystemMixed
自动路由
系统代理通过操作系统的代理设置引导应用连接，适合浏览器等遵循该设置的软件。TUN 则借助虚拟网络接口与路由接管更多流量，适用于不读取系统代理的应用，但通常需要相应权限，并且要检查 DNS 与其他虚拟网卡是否冲突。网络栈的选择应依据系统和应用兼容性，而非认为某一项必然更快。不同图形客户端对服务安装和权限申请的封装有所区别；首次配置建议先用系统代理验证可用性，再单独启用 TUN 对照测试。
mihomo
mihomo Alpha
Clash Rust
示意选项；实际支持范围取决于客户端构建。
客户端界面与代理内核承担不同任务：前者管理配置和操作入口，后者解析规则、建立连接并处理协议。日常使用优先考虑与订阅兼容的 mihomo 稳定构建；Alpha 用于体验尚在验证的变更，切换前应阅读发布说明并保留原配置。其他内核并不保证支持相同字段，不能仅凭名称相近就直接替换。相较固定绑定单一内核的客户端，可切换内核便于定位兼容问题，但也增加了组合差异；出现加载失败时应先检查日志中的未知字段或协议提示。
设置顺序比开关数量更重要。订阅成功导入，只说明配置已经保存；内核启动成功，才表示配置能够被解析；应用连接出现在记录中，才说明流量已经进入客户端。最后还需要确认命中的规则与预期出口一致。把这几层分开检查，通常比同时切换模式、DNS 和网络栈更有效。
已有配置也可以继续使用，但应先备份再迁移。涉及远程规则集、外部文件或覆写脚本时，要确认新客户端支持对应机制。界面中的设置与订阅文件可能共同影响最终配置，遇到冲突时以实际加载结果为准。需要理解 Fake-IP、策略组和规则提供器等概念，可继续查阅名词解释。
Clash 客户端下载入口
查看全部客户端 →先选操作系统，再确认处理器架构和安装方式。Clash Nyanpasu 是桌面客户端，手机和平板需要选择对应平台的生态客户端；平台入口表示下载中心提供该系统的选型资料，并不代表每款软件都有同名的移动端。下载页集中列出可用安装包、系统要求与维护状态，具体分发范围以页面所列内容为准。
macOS
按 Apple Silicon 或 Intel 处理器选择适用安装包，并核对客户端要求的系统范围。若需要网络扩展、后台服务或路由权限，应阅读系统弹窗中的具体说明。更换客户端前先退出原程序，避免多个程序反复修改同一份系统代理设置。
前往下载 →Android
在 Clash Plus、Clash Meta for Android、FlClash 和 Surfboard 等选项之间，结合订阅格式与使用习惯选择。首次连接通常需要确认系统 VPN 授权；连接在锁屏后中断时，还应检查电池优化与后台运行限制。配置迁移前先确认目标客户端支持原订阅协议。
前往下载 →iOS
下载中心提供 Clash Plus 的 App Store 入口与官网 clashplus.io 信息。安装后先导入兼容配置，按系统提示允许添加 VPN 配置，再检查策略选择。桌面端的文件路径、脚本与权限设置不能直接照搬到手机，迁移时应以移动端实际支持的功能为准。
前往下载 →Linux
桌面环境可查看 Clash Verge Rev 与 FlClash，按发行版的软件包格式和依赖要求安装。服务器或路由器用户可另外查阅 mihomo 内核包，但内核本身不等于完整图形客户端。桌面托盘、系统代理与服务管理的行为会随发行版变化，遇到启动问题先查看日志。
前往下载 →选型时不要只比较界面外观。同一份订阅可能包含不同内核才支持的协议或字段，客户端能安装并不代表配置一定兼容。优先选择仍在维护、系统要求明确且适配当前配置的方案；归档客户端适合了解历史行为，长期使用前应评估兼容性与维护状态。更详细的功能差异见客户端横向评测。
订阅导入与连接检查
查看完整教程 →首次配置沿着“配置可用、流量接入、出口正确”这条路径进行即可。客户端负责读取配置和建立代理连接，订阅中的服务器、凭据与有效期则由订阅提供方决定。安装软件后仍需准备可用配置；若链接已经过期，应先处理订阅本身，而不是反复重装客户端。
-
导入订阅，选中配置
打开配置或订阅管理入口，粘贴完整链接并执行导入。确认列表中出现配置后，将其设为当前使用项，再查看策略组是否已经加载。若提示解析失败，先分辨链接返回的是配置文件还是网页内容，并检查是否需要更新访问凭据。订阅链接通常包含私人访问参数，排查时不要将完整链接公开到截图或讨论区。
导入完成后，可以先保留原有规则，避免在连接尚未验证时同时添加覆写。对于多份配置，应给出能够识别用途的名称，并确认每次切换后当前配置标识已经改变。这样后续观察连接记录时，才能知道正在测试哪一套规则。
-
选择规则模式，启用接管方式
在代理模式中选择规则，再按应用需求开启系统代理。进入主要策略组，确认已经选择可用出口或适合的自动选择组。此时先用浏览器测试；如果应用没有出现在连接记录中，说明它可能没有遵循系统代理，可以再查阅 TUN 配置。TUN 的作用是改变接管范围，不是让所有网络问题自动消失。
初次启用 TUN 时，应留意权限提示和其他 VPN、虚拟网卡软件的状态。每次只修改一个设置，并保留能够正常连接时的组合。需要恢复原状态时，先关闭刚启用的接管方式，再核对系统代理与路由是否已恢复。
-
访问目标，核对规则与出口
访问需要测试的网站或应用，在客户端连接记录中查看请求域名、命中规则和所用策略。页面能够打开只是第一步，还要确认本应直连的连接没有误走代理，本应交给指定策略组的连接也命中了正确规则。延迟测试只能反映特定测试请求的表现，不能替代下载、视频或业务应用的实际体验。
出现问题时记录最小复现条件：哪个应用、什么操作、使用哪份配置，以及日志中的具体报错。对外分享日志前，先移除订阅链接、访问凭据与私人地址。将这些信息整理清楚，比单独描述“无法上网”更容易定位到 DNS、规则、出口或权限中的具体一层。
开源项目与内核关系
查看项目仓库 ↗理解软件来源，也要分清界面、内核与订阅三个层次。Clash Nyanpasu 的源代码和开发记录可以在公开仓库查阅；实际使用中，客户端构建、内核能力与订阅内容共同决定功能表现。本页以功能路径介绍为主，不用未经确认的下载量、评分或性能数字代替选型依据。
项目沿革与公开开发
Clash Nyanpasu 属于 Clash 图形客户端生态，采用 Tauri 构建桌面界面。公开仓库可以查看源代码、问题讨论与发布记录，适合核对一项功能是否已经实现，以及某个行为是否正在调整。项目历史应沿着提交记录和发布说明查阅，不宜仅凭名称相似就判断它与其他客户端的继承关系。
遇到界面操作问题，可以先在仓库讨论中搜索现象与报错。提交反馈时，应说明操作系统、复现步骤和相关日志，而不是附上完整私人配置。开源让实现过程可以被查阅，但仍应结合自己的系统环境进行验证，不能把某位用户的测试结论直接视为所有设备的结果。
图形客户端与 mihomo
图形客户端负责订阅管理、设置入口、进程控制与状态展示；mihomo 负责解析配置、匹配规则和处理连接。两层之间有明确分工，所以更换界面不一定改变相同配置的分流结果，而更换内核则可能影响协议、DNS 与规则字段的兼容性。所谓 Meta 与 mihomo 的关系，也需要放在内核演进的背景中理解。
如果页面设置能够保存，但内核无法启动，应优先查看配置解析和运行日志。若内核运行正常、应用连接却没有出现，则应检查流量接管方式。把问题放回对应层级，有助于判断应该调整客户端选项、订阅内容，还是查阅内核文档，减少不必要的反复安装。
订阅格式与生态兼容
订阅是一种配置分发方式，不等于客户端自带连接服务。链接可能返回完整 Clash 配置，也可能只是其他格式的服务器信息。即便文件能够解析，其中的协议、规则集与覆写方式也可能依赖特定内核或客户端扩展。迁移时应先核对格式，再检查配置引用的外部资源是否可以访问。
同一链接在不同客户端中表现不同，可能来自请求方式、配置转换或功能支持范围，而非链接本身随机失效。建议保留一份已知可用的配置作为对照，并记录是否启用了自动更新。需要修改长期规则时，先了解覆写机制，避免下次订阅更新把本地调整覆盖。
发布说明与更新边界
客户端更新、内核更新和订阅更新不是同一件事。客户端更新可能调整界面或权限处理，内核更新可能改变协议与配置行为，订阅更新则通常改变服务器与分流内容。更新前阅读相关说明，并备份自己的覆写和必要设置；遇到变化时分别核对这三个来源，才能找到真正的影响因素。
稳定使用时应以兼容性为先，不必仅因出现测试构建就立即切换。若为验证问题而使用 Alpha，应保存原来的安装与配置恢复路径，并记录切换前后的差异。页面顶部不展示具体发布编号，安装包与可用分发信息统一到下载中心查看，避免把首页介绍当作实时发布记录。
获取源代码
已安装 Git 时，可复制以下命令到终端。克隆得到的是项目源代码；仅需安装使用的用户，直接前往下载中心选择客户端。
git clone https://github.com/libnyanpasu/clash-nyanpasu.git规则配置与网络原理
查看全部文章 →完成基础连接后，再按问题选择进阶资料：分流结果不符合预期，先看规则顺序；测速数字与体验不一致，先区分握手延迟和传输带宽；地址归类发生变化，则检查数据库与规则集。以下文章按发布日期倒序排列，分别解释这些容易混在一起的概念，便于带着具体问题查阅。
GeoIP 与 GeoSite 数据库更新指南：mihomo 的 geodata 模式与规则匹配要点
梳理 GeoIP、GeoSite 两类数据文件的来源与格式区别，说明 mihomo 中 geodata-mode、自定义更新地址与自动更新的设置方法，以及数据过旧时的典型症状。
阅读数据库更新指南 →Clash 节点延迟测速原理：URL Test 数值与实际网速为何对不上
解释客户端延迟测试测的是什么、测试地址与超时设置如何影响数值，以及握手延迟、带宽与线路拥塞之间的区别，帮助读者正确看待测速结果。
了解延迟测试的边界 →Clash 规则分流实战：本地直连与境外走代理的 rules 和 rule-providers 写法
以常见分流场景为线索，拆解规则自上而下的匹配顺序、策略组引用方式与 rule-providers 远程规则集的组织方法，避免规则写反导致流量走错出口。
查看规则组织方法 →如果还不能确定问题属于哪一类，可以先到常见问题对照现象，再回到教程复查导入、模式与接管步骤。技术参考适合比较协议和内核差异，名词解释适合快速理解配置字段；把操作步骤与原理资料分开阅读，排查时更容易保留清晰的判断路径。