Windows
适合常见桌面与笔记本电脑。安装前先确认系统架构，完成安装后从订阅页面导入配置，再开启系统代理。若内核无法启动，可检查安全软件拦截、端口占用与配置语法。
前往下载
核心配置
从订阅导入到稳定分流
每项设置都对应一个明确的网络范围。先理解系统代理、TUN、规则模式与 DNS 的职责，再调整开关，比反复更换节点更容易定位问题。
配置一
把订阅地址转换为可管理配置
订阅导入不是简单保存一段网址。客户端会请求远端内容、解析代理节点与策略组，再生成可选择的本地配置。粘贴地址后应先确认请求成功，然后选中刚导入的配置，最后检查策略组是否出现。若列表为空，应优先核对地址完整性、网络权限和订阅服务状态，而不是连续重复添加同一个地址。
Clash Nyanpasu 将配置管理、更新时间与启用状态放在同一处，适合保留日常配置和排查用备用配置。更新前可记录当前策略选择，更新后再检查规则组名称是否发生变化，避免新配置覆盖原有选择后误判为连接故障。
- ×只完成导入，没有选中配置，代理列表仍不会切换到新内容。
- ✓导入、启用、选择策略组依次确认，问题出现时能够判断停在哪一步。
导入订阅
配置管理
https://example.com/subscription
日常规则配置
已选择，可手动更新
配置二
用 TUN 模式覆盖更多应用流量
系统代理主要影响主动读取系统代理设置的程序，部分终端命令、游戏启动器和独立网络组件可能绕过它。TUN 模式通过虚拟网络接口接管更广的流量范围，适合出现浏览器可以访问、终端却无法连接的情况。启用前应保存正在进行的网络任务，并留意系统是否要求授予网络扩展或管理员权限。
TUN 并非所有问题的通用开关。若规则本身写错、DNS 返回异常或订阅已经失效，扩大接管范围不会修复根因。更稳妥的顺序是先确认配置能启动，再检查系统代理，最后根据应用范围决定是否启用 TUN，并在切换后重新测试目标程序。
- ×同时改动 TUN、DNS 和代理模式，出现异常后难以确定是哪项设置造成。
- ✓一次只切换一个网络层设置，并用同一个网站或命令重复验证结果。
网络接管
系统设置
系统代理浏览器与桌面应用
TUN 模式虚拟网络接口
局域网连接按需单独开启
配置三
让不同请求进入对应策略组
规则模式会按配置中的域名、IP、进程或规则集合逐条匹配，并把请求交给指定策略组。它适合日常使用，因为本地服务、直连网站与需要代理的请求可以分别处理。全局模式则把大部分请求交给同一代理策略，更适合短时间验证节点是否可用，不宜用来判断规则配置是否正确。
排查分流时先查看命中的规则，再检查该规则指向哪个策略组，最后确认策略组当前选择。仅在代理列表中更换节点，无法修复请求被错误送入直连组的问题。Clash Nyanpasu 的规则与策略入口相互独立，按“请求—规则—策略组—节点”的顺序检查会更清楚。
- ×目标网站打不开时立刻切换全局模式，长期掩盖规则命中错误。
- ✓先找出命中规则与目标策略组，再决定补充规则还是调整组内选择。
规则片段
规则模式
DOMAIN-SUFFIXexample.org代理GEOIPLAN直连MATCH其余请求节点选择
配置四
把域名解析纳入同一排查链路
DNS 决定域名先被解析成哪个地址，规则则决定后续连接采用什么策略。网页提示域名无法解析、同一节点只有部分网站失败，或关闭客户端后解析仍异常时，都应单独检查 DNS。先确认客户端内核正常运行，再比较系统 DNS 与配置内 DNS 的结果，避免把解析问题误认为节点质量问题。
修改 DNS 后需要考虑系统缓存、浏览器缓存和客户端缓存。测试时应关闭旧连接并重新发起请求，必要时刷新系统解析缓存。若配置启用了增强模式，还要核对模式名称、监听端口以及是否与其他本地 DNS 工具冲突，逐层缩小范围比频繁更换整份配置更有效。
- ×看到连接超时就认定节点失效，没有先区分解析失败与连接失败。
- ✓分别验证域名解析、规则命中和代理连接，保留每一步的明确结论。
DNS 设置
按配置启用
启用 DNS
增强模式fake-ip
配置来源当前订阅
平台入口
按设备选择Clash 客户端
首页只提供平台导航。进入下载页后，可比较同一平台下的 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 等客户端，再按处理器架构与系统类型选择安装包。
macOS
下载时需区分 Apple 芯片与 Intel 处理器。首次启动若出现系统安全提示，应在系统设置中确认应用权限；启用 TUN 时还可能需要允许网络扩展，操作后重新测试连接。
前往下载Android
适合手机、平板和部分电视设备。安装后需要创建本地 VPN 连接，系统省电策略可能在后台停止客户端，因此长期使用时应检查后台运行权限和电池优化设置。
前往下载iOS
通过应用商店进入 Clash Plus 安装页面。首次连接时系统会请求添加 VPN 配置，确认后再导入订阅；若切换网络后无法访问，可断开旧连接并重新建立本地 VPN 会话。
前往下载Linux
提供图形客户端与面向服务器、路由器环境的 Mihomo 内核入口。桌面用户可优先选择图形界面；命令行部署则应先阅读服务管理、配置路径和文件权限说明。
前往下载
开源生态
客户端、内核与配置的关系说明
判断一个 Clash 客户端是否适合长期使用，不能只看界面。更重要的是理解图形客户端怎样调用内核、配置怎样决定流量路径，以及项目更新怎样传递到本地安装。
项目历史与定位
Clash Nyanpasu 属于 Clash 图形客户端生态，主要承担配置导入、策略选择、系统代理控制、TUN 开关、日志查看与内核管理等工作。图形界面降低了直接编辑配置文件的操作成本，但实际网络行为仍由所使用的内核和当前配置共同决定。因此，界面显示“已连接”只说明客户端进程处于工作状态，并不等同于订阅、规则、DNS 和目标节点全部正常。
使用过程中应把客户端视为配置与内核的管理入口。遇到故障时，先确认客户端是否启动，再检查内核日志和配置加载结果，之后才是策略组与节点连接。按层次排查，可以避免把订阅失效、规则误配或本地端口冲突全部归结为客户端本身。
开源协作与可审阅性
代码公开意味着功能变更、问题报告和修复过程可以在项目仓库中被追踪。用户可以查看提交记录、发行说明和已知问题，维护者也能通过可复现的日志与操作步骤定位问题。提交反馈时，建议说明操作系统、安装方式、当前代理模式、问题发生前后的操作以及经过处理的日志片段，避免只写“不能使用”这类难以复现的描述。
开源协作并不代表每项问题都会由客户端直接解决。订阅内容由相应服务提供，节点状态由线路决定，系统网络权限由操作系统管理。清楚区分责任边界，才能把问题提交到正确位置，也能减少在多个设置页面之间无目标地切换。
Mihomo 内核关系
Mihomo 负责读取配置、建立代理连接、执行规则匹配、处理 DNS，并向图形客户端提供运行状态。Clash Nyanpasu 则把这些能力组织成可操作的界面。策略组、规则集合、混合端口、TUN 和 DNS 增强模式等概念，本质上来自内核配置；客户端中的开关通常会转换为对应配置或启动参数。
这也解释了为什么同一份配置在不同客户端中的主要分流结果通常接近，而系统代理写入方式、权限请求、托盘操作和更新流程可能不同。迁移客户端时，先备份订阅地址与自定义配置，再逐项恢复，不应直接假定所有界面开关名称和默认行为完全一致。
更新与变更检查
客户端、内核和订阅配置有各自的更新周期。客户端更新可能改变界面与系统集成方式，内核更新可能增加配置能力或调整兼容行为，订阅更新则可能改变节点、策略组和规则。日常使用无需把三者同时更新；更稳妥的做法是一次处理一层，并在变更后验证启动、订阅、规则与目标网站。
更新前可记录当前使用的策略组和关键开关，更新后先查看发行说明，再执行一次基础连接测试。如果出现问题，保留旧配置和明确的复现步骤，有助于判断是本地设置、上游配置还是新功能变化造成。本站下载页负责整理平台入口，教程与故障排查页则分别处理首次配置和异常定位。
项目仓库克隆命令
git clone https://github.com/LibNyanpasu/clash-nyanpasu.git
常见问题精选
先确认问题发生在哪一层
多数连接问题可以分为客户端启动、配置加载、系统接管、规则匹配、DNS 解析和节点连接六层。先找到层级，再选择对应处理方法。
导入订阅后为什么代理列表仍然为空？
浏览器可以访问，终端命令为什么没有走代理？
系统代理只对主动读取系统设置的程序生效，部分终端工具需要单独设置代理环境变量，或者通过 TUN 模式接管。排查时先确认终端工具使用的协议与端口，再决定配置环境变量还是启用 TUN。不要在同一次测试中同时修改系统代理、环境变量和 DNS，否则很难判断哪个设置真正生效。完整流程可查看故障排查。
规则模式与全局模式应该怎样选择？
规则模式根据域名、IP 或规则集合决定直连与代理，适合日常使用；全局模式把大部分请求交给同一代理策略，适合短时间验证节点连通性。若全局模式可访问、规则模式失败，应检查目标请求命中的规则和策略组，而不是长期停留在全局模式。有关 MATCH、GEOIP、策略组等概念，可到术语表继续查阅。
开启 TUN 后无法上网，应先关闭哪些设置？
先关闭 TUN 并确认基础系统代理能否恢复，然后检查管理员权限、虚拟网络接口、DNS 配置和其他 VPN 软件是否冲突。不要直接删除全部配置，因为配置内容可能没有问题。恢复基础连接后，再单独开启 TUN 复测；若日志提示接口创建失败或权限不足，应先处理系统层问题。更多症状对应步骤见故障排查。
配置文章
近期的排查与进阶说明
文章按具体症状拆解检查顺序，重点说明应观察什么、怎样缩小范围，以及哪些设置不应同时改动。