Clash NyanpasuWindows
适合需要系统代理、配置编辑与服务模式的桌面用户。下载前打开系统设置中的「系统 → 系统信息」，确认处理器架构，再选择对应安装包。首次启动先导入一份可用配置，确认端口未被占用，然后开启系统代理；需要 TUN 时再处理服务权限。
从 Clash for Windows 迁移时，保留原始配置及自定义规则备份。新客户端的配置目录、覆写入口和内核字段支持可能不同，建议逐项迁移，而不是直接覆盖整个应用数据目录。
前往下载 Windows 客户端FIG 1 / CONFIGURATION WORKSPACE
配置结构与分流功能
订阅提供配置，客户端组织配置，内核执行规则。分清三者的边界，再调整覆写、策略组与网络接管方式。
Clash Nyanpasu 面向桌面配置管理。导入远程订阅后，先确认配置能够加载，再检查代理组与规则目标。下列示例用于解释字段关系，不包含可直接连接的代理服务；示例中的 DIRECT 表示直连。移动系统的客户端选择见下方平台入口。
远程订阅与本地修改分层
Profile 是客户端管理的一份配置记录，可以来自本地 YAML，也可以来自远程订阅。直接编辑订阅正文，下一次更新时可能丢失改动。更适合长期保留的端口、DNS 与自定义规则，应放入独立覆写中，并检查最终生成的配置。不同客户端对列表字段的替换、追加与脚本处理方式并不相同，不能把所有合并都理解为简单拼接。切换 Profile 前保留可用副本，加载后查看日志，确认覆写字段处于预期层级。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info规则目标与策略组保持一致
策略组将规则目标与具体出口分开。规则引用组名，组内再选择可用出口，调整出口时就不必逐条修改域名规则。select 类型用于手动选择；其他组类型的行为应结合内核文档理解。组名需要与 rules 中的目标完全一致，大小写、空格和重命名都可能影响引用。下面以 DIRECT 展示最小结构，仅用于说明语法。迁移旧配置时，先检查组是否引用已删除的成员，再确认组之间没有循环引用，最后检查兜底规则是否指向有效目标。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT从具体条件到最终兜底
规则模式按顺序检查条件，通常由第一条命中的规则决定去向。因此，精确域名与局部例外应放在宽泛条件之前，MATCH 作为最后的兜底。规则写得正确但结果不符时，需要同时检查当前模式、目标策略组以及前方是否已有规则命中。GEOIP 等规则还依赖相应数据资源，不应只看一行文本判断结果。下面示例中的 PROXY 必须先定义为有效策略组；如果它仅包含 DIRECT，匹配到该组的连接仍会直连，不会凭空产生代理出口。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY接管方式与域名解析分别检查
系统代理主要服务于遵循系统代理设置的应用，TUN 则通过虚拟网络接口接管更多连接。启用 TUN 前，应先在普通代理模式下确认配置可用，再按客户端提示安装服务或授予权限。DNS 设置负责域名解析，fake-ip 是其中一种处理方式，并不等同于启用了 TUN。出现域名访问异常时，先检查解析路径、系统中其他网络软件与内核日志，避免同时修改多个开关。下列片段只展示开关层级，完整使用还需结合系统路由、权限与 DNS 配置。
tun:
enable: true
auto-route: true
dns:
enable: true
enhanced-mode: fake-ipFIG 2 / PLATFORM SELECTOR
Clash 客户端平台入口
桌面端与移动端分别选型。
安装包、架构与系统要求统一在下载页查阅。
Clash Nyanpasu 的桌面定位与 Clash 生态的多平台选择需要区分。Windows、macOS、Linux 用户可以根据桌面环境和配置习惯选择图形客户端；Android 与 iOS 用户应选择对应系统的应用，而不是尝试安装桌面程序。此处提供五个平台的下载导航，具体客户端以下载页清单为准。已有订阅也需要确认输出格式，不同应用对字段的支持范围可能不同。
macOS
先在「关于本机」确认 Apple Silicon 或 Intel，再选择安装包。安装后按系统提示完成启动授权；是否需要后台服务或网络相关权限，取决于所选客户端和接管方式。普通系统代理可用后，再逐步启用其他网络功能，便于定位权限或配置问题。
切换客户端前先退出旧应用并关闭其系统代理。若浏览器仍使用旧代理地址，应检查系统网络设置，而不是连续重复导入订阅。
前往下载 macOS 客户端Android
选择与设备架构匹配的 Android 客户端，安装后导入兼容的订阅配置。首次建立连接时，系统通常会请求 VPN 连接授权；这是应用建立本地网络接管通道的系统步骤，不代表订阅已经可用，仍需检查配置加载与规则目标。
后台运行受系统电池策略影响。如果切换应用后连接中断，先检查电池优化和后台限制，再排查配置。已有其他 VPN 应用运行时，应先确认系统的连接占用情况。
前往下载 Android 客户端iOS
iPhone 与 iPad 用户可在下载页前往 Clash Plus 的 App Store 页面。安装后按应用流程导入配置，并在系统提示时允许添加 VPN 配置。订阅链接需要来自可信来源，不要把包含访问凭据的完整地址发布到截图或公开讨论中。
桌面端的配置文件可以作为迁移参考，但不能据此假定所有脚本与覆写功能都能原样使用。导入后优先检查应用支持的字段和策略组，再进行自定义调整。
前往下载 iOS 客户端Linux
桌面用户按发行版的软件包格式选择图形客户端，并确认桌面会话所需依赖。服务器或路由器场景可查阅下载页的 mihomo 内核区；内核本身不提供完整的桌面配置管理界面，需要自行管理配置路径、启动参数和服务生命周期。
系统代理对不同桌面环境和命令行工具的作用范围不同。某个应用未走代理时，先确认它是否读取系统设置，再决定使用应用级代理参数还是其他接管方式。
前往下载 Linux 客户端FIG 3 / SOURCE & RUNTIME
开源项目与内核关系
GUI / PROFILE / CORE
客户端与 Clash 生态
Clash Nyanpasu 是 Clash 生态中的开源桌面图形客户端。Clash 既被用于指代早期项目，也常被用于描述兼容配置格式和相关客户端。阅读教程时需要区分项目名称与配置语法，不能把某个旧客户端的界面路径直接套用到所有应用。选择 Clash for Windows 替代方案时，重点比较配置迁移、内核支持和服务权限，而不是仅看名称是否接近。
图形界面与 mihomo 的分工
客户端负责订阅记录、界面操作、配置生成及系统集成，mihomo 负责读取配置并执行协议处理、规则匹配与 DNS 等逻辑。界面中显示了某个开关，并不意味着内核已经成功加载对应设置。配置问题应以生成后的内容与启动日志交叉判断；解析报错时先修正 YAML 层级，引用报错时检查组名，监听失败时检查端口占用，避免把不同层面的问题混在一起。
源码、许可证与问题记录
项目源码可在 Clash Nyanpasu 开源仓库查阅，项目采用 GPL-3.0 许可证。源码、发布说明与问题记录分别用于理解实现、确认变动和定位已知行为。提交问题时应写明系统、操作步骤、预期结果与相关日志，并删除订阅地址、认证信息及私人域名。可复现的最小配置，比包含大量无关字段的完整配置更便于排查。
客户端更新与配置更新
应用更新、内核更新、订阅更新是三个不同动作。应用更新可能改变界面或配置处理方式，内核更新可能调整字段支持，订阅更新则替换远程内容。更新前备份本地覆写与可用配置，更新后先确认原有基本功能，再尝试新增字段。不要在同一次排查中同时更换客户端、修改 DNS 和重写规则，否则难以判断究竟是哪一项产生了影响。
获取项目源码
需要本地 Git。克隆仅获取源码，构建步骤以仓库文档为准；日常使用选择下载页安装包。
git clone https://github.com/LibNyanpasu/clash-nyanpasu.gitREADING / RECENT NOTES
配置与平台文章
博客按单个操作主题展开。规则文章用于理解匹配顺序，平台文章用于处理系统权限，配置文章用于整理多份 Profile。若正在排查故障，先固定一份可用配置并保留原始日志，再按文章中的单一变量逐步调整；不要把不同系统的权限路径和客户端操作步骤混用。
Clash 自定义规则怎么写：rules 语法、匹配顺序与优先级详解
拆解 DOMAIN-SUFFIX、IP-CIDR、GEOIP、RULE-SET、MATCH 等规则类型的写法，说明自上而下首条命中的匹配机制与规则排序原则。
阅读文章 →macOS 安装 Clash Nyanpasu：网络扩展授权与钥匙串提示处理
针对 macOS 上「无法打开」、服务模式授权、网络扩展允许和钥匙串反复弹窗等问题，按系统设置路径逐项给出处理步骤。
阅读文章 →Clash Profile 是什么：配置文件基础概念与多配置切换管理
从 Profile 与 config.yaml 的关系讲起，说明本地配置、远程订阅与覆写脚本的分工，以及多份配置并存时的命名、切换和备份方法。
阅读文章 →