Clash Nyanpasu  新手必看 | 常见问题·故障排查

Nyanpasu 是基于 Tauri 的跨平台 Clash 图形客户端，支持 Windows、macOS 与 Linux，并提供 TUN 网络卡模式。定位为更现代的 Mihomo/Clash GUI。

官方主页/文档与 GitHub Releases 提供安装包：
• Windows 7+：安装版 ..._x64-setup.exe，另有便携版（见第 7 条）；
• macOS 10.15+：Intel/Apple Silicon 包；
• Linux：.deb/.rpm 与 .AppImage（AppImage 有功能限制，见第 8 条）。

打开 Nyanpasu → 配置/Profiles 新建远程订阅（粘贴订阅 URL）并设为当前 → 在 代理/Proxies 选择策略组/节点 → 回到首页开启 系统代理（必要时再开 TUN）。

• Rule（规则）：按规则分流，日常推荐；
• Global（全局）：全部走同一节点，便于排障/特定场景；
• Direct（直连）：不走代理。

可结合策略组在特定业务与地区间快速切换。

需要。请先安装 Microsoft Edge WebView2 Runtime，再运行安装包或便携版。自 v1.5.0 起不再提供 MSI 安装器；如便携版仍异常，建议改用安装版。

部分服务商按 User-Agent 下发配置。Nyanpasu 默认 UA 为 clash-nyanpasu/vX.Y.Z；若不兼容，可在订阅项把 UA 改为服务商支持的类型（如 clash-meta），或联系服务商添加识别。

便携版为自动打包产物，跳过 WebView2 检测且不修改注册表，因此：系统通知/自定义协议导入等功能受限；服务注册（nyanpasu-service）会被移除或受限。建议追求稳定性的用户使用安装版。

新版提供跨平台服务模式（Windows/macOS/Linux，AppImage 除外）；Linux .AppImage 目前不支持服务模式与内核更新，且 TUN 授权受限（需 sudo 运行）。

在 设置 → 系统设置 启用 TUN。
• Windows：以管理员身份运行；
• macOS：在「Clash Core 设置」里点锁授予权限并重启内核；必要时手动 chmod +sx/chown 核心二进制；
• Linux：以 sudo 运行或按发行版授权。若仍异常，先退回“系统代理”对比并查看日志。

Nyanpasu 继承了「代理链」：在配置生效前进行二次处理，可用 Merge 合并规则、JavaScript 或 Lua 对配置做筛选/修改/覆盖（如为特定策略组增加图标、注入规则集等）。

自 v1.6.0 起分离 config_dir 与 data_dir；Windows 允许迁移配置目录以便云同步。你可在托盘或设置页直接打开目录；日志位于 data_dir/logs。

Debian/Ubuntu 可下载 .deb 本地安装；Arch 有社区维护的 clash-nyanpasu / clash-nyanpasu-bin / clash-nyanpasu-git（使用 paru 等 AUR 助手）。AppImage 可直接运行但有功能限制（见第 8 条）。

在订阅项启用「通过系统/内核代理更新」，或临时切 Global 后再刷新；更换网络（Wi-Fi/移动），并确认订阅未过期或未被限制。

在设置中更改本地监听端口（HTTP/SOCKS/Mixed/DNS 等）并重启；同时关闭其它占用相同端口的代理/VPN/浏览器扩展或加速器。

打开终端执行：sudo xattr -r -d com.apple.quarantine /Applications/Clash\ Nyanpasu.app，再重启应用；如仍有权限问题，参考第 9 条的手动授权步骤。

软件不提供任何节点；需导入你的订阅或自建节点。项目开源并基于 Clash/Mihomo 内核生态进行图形化与增强。