Clash Nyanpasu 下载

> 简体中文版本请展开页面底部的「简体中文」。

## Read Before Upgrading

- **With TUN on, the TUN stack chosen in Clash settings now takes precedence over a Profile's `tun.stack`.** Previously a stack written by the subscription won. If you relied on it, choose the stack in settings instead (the default is gVisor).
- **A Profile that sets a TUN stack the selected core rejects now fails to apply, with an error naming the value and the supported ones.** For example, `tun.stack: mixed` or `mips` under Clash Premium, which would otherwise make the core reject the whole config. This is checked even while TUN is off, because the core parses the key on load. Values Nyanpasu does not know are still passed to the core.
- **The stack selector only lists the stacks the current core reads**, and is hidden for clash-rs and Meow, which ignore the key. If the saved stack is not supported by the core you switch to, gVisor is used and a warning is written to the log; the saved setting is kept.
- **Service mode now requires nyanpasu-service 2.0.2.** An installed 2.0.1 service is upgraded once at startup. 2.0.2 fixes a stale pid record that made the service and the app fail on every start (#6033).

## Highlights

- **Mips (Mihomo IP Stack)**, mihomo's new user-space TUN stack, can be selected under mihomo and mihomo-alpha, together with its TCP congestion controller (CUBIC, Reno, BBR, BBRv3, or the core default). The controller is remembered when you switch to another stack and back (#6091).
- **Startup failures no longer crash the app.** A dialog names the file, the cause and the recovery steps, and can open the containing, backup or log folder. Corrupt local data and an unusable jobs journal are rebuilt instead of blocking startup.

## [2.0.1] - 2026-10-31


### ✨ Features

- **config:** Add the mips TUN stack and its congestion controller (#6098) by @greenhat616  in [#6098](https://github.com/libnyanpasu/clash-nyanpasu/pull/6098)

- **config:** Decide the TUN stack from each core's config features (#6097) by @greenhat616  in [#6097](https://github.com/libnyanpasu/clash-nyanpasu/pull/6097)

- **settings:** Offer the TUN stacks and mips options the core reads (#6099) by @greenhat616  in [#6099](https://github.com/libnyanpasu/clash-nyanpasu/pull/6099)

- **startup:** Report failures in a dialog instead of panicking (#6063) by @greenhat616  in [#6063](https://github.com/libnyanpasu/clash-nyanpasu/pull/6063)

- **windows:** Bundle the Windows App SDK bootstrapper with enableLoopback (#6043) by @greenhat616  in [#6043](https://github.com/libnyanpasu/clash-nyanpasu/pull/6043)


### 🐛 Bug Fixes

- **jobs:** Rebuild an unusable jobs journal instead of failing to start (#6069) by @greenhat616  in [#6069](https://github.com/libnyanpasu/clash-nyanpasu/pull/6069)

- **service:** Require service 2.0.2 (#6045) by @greenhat616  in [#6045](https://github.com/libnyanpasu/clash-nyanpasu/pull/6045)

- **startup:** Handle environment failures before and around setup (#6064) by @greenhat616  in [#6064](https://github.com/libnyanpasu/clash-nyanpasu/pull/6064)

- **startup:** Rebuild corrupt local data instead of failing to start (#6062) by @greenhat616  in [#6062](https://github.com/libnyanpasu/clash-nyanpasu/pull/6062)

- Align update link with header menu (#6109) by @keiko233  in [#6109](https://github.com/libnyanpasu/clash-nyanpasu/pull/6109)

- Prevent logo animation edge artifacts (#6041) by @keiko233  in [#6041](https://github.com/libnyanpasu/clash-nyanpasu/pull/6041)

- Prevent page title artifacts while scrolling (#6040) by @keiko233  in [#6040](https://github.com/libnyanpasu/clash-nyanpasu/pull/6040)

- Prevent sparkline stretching on new peaks (#6039) by @keiko233  in [#6039](https://github.com/libnyanpasu/clash-nyanpasu/pull/6039)


### 📚 Documentation

- **config:** Design core feature queries and the TUN mips stack (#6096) by @greenhat616  in [#6096](https://github.com/libnyanpasu/clash-nyanpasu/pull/6096)

- **design:** Add domain error design notes (#6083) by @greenhat616  in [#6083](https://github.com/libnyanpasu/clash-nyanpasu/pull/6083)

- Plan startup failure handling without setup panics (#6060) by @greenhat616  in [#6060](https://github.com/libnyanpasu/clash-nyanpasu/pull/6060)


### 🔨 Refactor

- **setup:** Report startup failures as domain errors (#6061) by @greenhat616  in [#6061](https://github.com/libnyanpasu/clash-nyanpasu/pull/6061)

-----------------



**Full Changelog**: https://github.com/libnyanpasu/clash-nyanpasu/compare/v2.0.0...v2.0.1

<details>
<summary><b>简体中文</b></summary>

## 升级前须知

- **开启 TUN 时，Clash 设置中选择的 TUN 堆栈现在优先于 Profile 中的 `tun.stack`。** 以前订阅写入的堆栈会覆盖设置。如果你依赖订阅指定堆栈，请改在设置中选择（默认为 gVisor）。
- **Profile 设置了当前内核不支持的 TUN 堆栈时，配置现在会生成失败，错误信息会列出该值与内核支持的值。** 例如在 Clash Premium 下写 `tun.stack: mixed` 或 `mips`，否则内核会拒绝加载整份配置。由于内核加载配置时就会解析这个键，TUN 关闭时也会检查。Nyanpasu 不认识的值仍会原样交给内核。
- **堆栈选择器只列出当前内核会读取的堆栈**，clash-rs 与 Meow 不读取该键，因此不再显示选择器。如果保存的堆栈不被切换后的内核支持，运行时改用 gVisor 并在日志中记录警告，保存的设置不变。
- **服务模式现在需要 nyanpasu-service 2.0.2。** 已安装的 2.0.1 服务会在启动时自动升级一次。2.0.2 修复了残留的 pid 记录导致服务与应用每次启动都失败的问题（#6033）。

## 主要变更

- **Mips（Mihomo IP Stack）**：mihomo 新增的用户态 TUN 堆栈，可在 mihomo 与 mihomo-alpha 下选择，并可设置 TCP 拥塞控制算法（CUBIC、Reno、BBR、BBRv3 或内核默认）。切换到其他堆栈再切回时，该设置会保留（#6091）。
- **启动失败不再导致应用崩溃。** 对话框会说明出错的文件、原因与恢复步骤，并可打开所在目录、备份目录或日志目录。损坏的本地数据与不可用的任务日志会被重建，不再阻止启动。
- 修复了 Logo 动画边缘、滚动时页面标题与流量迷你图拉伸的显示问题；更新链接与顶部菜单对齐。
- Windows 安装包随 enableLoopback 附带 Windows App SDK 引导程序。

完整的变更列表见上方英文部分。

</details>