Pure Clash

Pure Clash 0.3.1

A lightweight native Mihomo desktop client built with Rust and Zed GPUI

  • By prime-zt
  • Open Source
  • Updated Oct 22, 2026
Download for Windows

About Pure Clash

Pure Clash manages configuration subscriptions, proxy groups, connections, and real-time traffic through a clean, fast native interface, while securely controlling an independently running Mihomo kernel—without rewriting proxy protocol stacks or rule engines in Rust.
Currently supports Windows x64 and Linux x64 (Wayland / X11); macOS directories and resource boundaries are reserved but not yet implemented.

Features

  • Kernel Lifecycle: Validates configurations using the same version kernel with -t before startup; child processes are guarded by Job Objects (Windows) or PR_SET_PDEATHSIG (Linux), ensuring the kernel is recycled if the main process exits abnormally; supports manual start/stop and complete cleanup before tray exit.
  • Config & Subscriptions: Built-in default configuration (DIRECT outbound only), URL subscriptions, and local YAML import via native file picker; all sources undergo structural pre-check and kernel -t validation before atomic saving and activation.
  • Offline Geo Data: Each installation package includes GeoSite.dat, GeoIP.dat, and Country.mmdb, allowing recovery without internet access; can be explicitly updated in the settings page.
  • Proxy Groups & Latency Test: Grouped display of subscription nodes; Rule/Global/Direct modes switched in real-time via controller; supports latency testing for single nodes or entire groups, with results color-coded by threshold.
  • Connections & Real-time Traffic: Polls controller connection snapshots every second, displaying process, destination, chain, rule, and up/down traffic; supports closing single or all connections; overview page shows real-time speed and active connection count.
  • System Proxy: Windows writes to current user Internet Settings and broadcasts changes via WinINet. Atomically saves original user settings before enabling, and automatically restores them after disabling, stopping the kernel, or abnormal exit.
  • TUN Mode: Windows elevates kernel privileges via UAC and uses the bundled wintun; automatically rolls back and provides reasons if TUN fails to take effect.
  • System Integration: Tray icon (synced with status and multi-language), single-instance lock, close to tray, light/dark themes, and Chinese/English interface.
  • Ultra-low Memory Footprint: The desktop client itself typically consumes less than 50 MB of memory (excluding the Mihomo kernel).

What's new in 0.3.1

What's Changed
- 一些小优化 by @dev2people in https://github.com/prime-zt/pure-clash/pull/10
New Contributors
- @dev2people made their first contribution in https://github.com/prime-zt/pure-clash/pull/10
Full Changelog: https://github.com/prime-zt/pure-clash/compare/v0.3.0...v0.3.1

Full release notes »

Technical details

Publisherprime-zt
Version0.3.1
Release date2026-10-22
LicenseGPL-3.0-only
Installer typenullsoft
Architecturex64
Package IDprime-zt.pure-clash
Install scopeCurrent user

Install Pure Clash from the command line

Install with Windows Package Manager
winget install --id=prime-zt.pure-clash -e
Update to the latest version
winget upgrade --id=prime-zt.pure-clash -e
Uninstall
winget uninstall --id=prime-zt.pure-clash -e
Silent install with the offline installer
"pure-clash-0.3.1-windows-x64-setup.exe" /S

clashclash-metamihomonetworkproxyvpn

Pure Clash version history

0.3.0 Oct 9, 2026

Full Changelog: https://github.com/prime-zt/pure-clash/compare/v0.2.8...v0.3.0

0.2.3 Sep 2, 2026

Full Changelog: https://github.com/prime-zt/pure-clash/compare/v0.2.3...v0.2.4
Pure Clash v0.2.4
本版本新增订阅自动更新与进程匹配控制,并进一步完善配置应用、失败回滚和运行状态同步。
新增功能
- 订阅自动更新
- 支持为每个远程订阅单独设置自动更新间隔。
- 支持在添加订阅时直接设置更新间隔,也可以在配置列表中随时修改。
- 支持 0 或留空关闭自动更新。
- 正式版本支持 10~43200 分钟的更新间隔。
- 应用启动后自动检查到期订阅,主窗口关闭或后台自启模式下仍会继续运行。
- 智能配置应用
- 自动更新前会下载、校验订阅内容,并通过 Mihomo -t 完成最终配置检查。
- 订阅内容未变化时跳过配置重载,避免不必要的内核操作。
- 激活中的订阅优先通过 controller 热重载配置,尽量不重启内核和不中断现有连接。
- 热重载失败时自动回退为内核重启。
- 非激活订阅只更新本地文件,不影响当前运行中的内核。
- 强制匹配进程名
- 设置页新增“强制匹配进程名”开关。
- 开启后使用 find-process-mode: always,为每条连接匹配发起进程并显示进程名。
- 关闭后恢复 Mihomo 默认的进程匹配行为。
- 运行中的内核支持通过 controller 热切换,无需主动重启。
- 配置页体验改进
- 新增自动更新状态、最近一次更新失败提示和更新间隔显示。
- 新增订阅自动更新间隔的行内编辑器。
- 新增中英文界面文案支持。
- 输入框支持程序回填和语言切换后的占位文案更新。
修复与优化
- 修复强制进程匹配配置与 app.json、local.yaml、runtime.yaml 状态可能不同步的问题。
- 完善配置写入失败时的原子回滚处理,避免损坏当前可用配置。
- 修复订阅自动更新在写入 runtime 失败时仍保留新订阅内容的问题。
- 优化自动更新的时间记录逻辑,失败尝试会被记录并顺延下一次更新,避免短时间内重复请求订阅服务器。
- 优化自动更新与手动配置操作之间的互斥处理,降低并发修改配置造成状态覆盖的风险。
- 自动更新失败不再打断用户操作,仅在配置列表中显示失败状态并写入运行日志。
- 启动时自动将进程匹配开关同步到本地 Mihomo 基线配置。
- 增加 controller 配置热重载专用超时,适应较大的配置和 Geo 数据加载场景。
验证
- cargo test:74 个测试通过,4 个测试忽略
- cargo fmt --check:通过
- cargo check --release:通过

Frequently asked questions

Is Pure Clash free?

Yes. Pure Clash is free and open-source software released under the GPL-3.0-only license.

What is the latest version of Pure Clash?

The latest version is 0.3.1, released on Oct 22, 2026.

Is it safe to download Pure Clash?

The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with 2fd5d338bbe09d7a1f6939e50cc5159f57c164d0199d04a299de132fe3c06ffa.

Which Windows versions does Pure Clash support?

Pure Clash runs on Windows and is available for 64-bit (x64) systems.

How do I install Pure Clash silently?

Run the offline installer with "pure-clash-0.3.1-windows-x64-setup.exe" /S, or install it with Windows Package Manager: winget install --id=prime-zt.pure-clash -e --silent.

How do I uninstall Pure Clash?

Open Settings › Apps › Installed apps, find Pure Clash and select Uninstall. From the command line, run winget uninstall --id=prime-zt.pure-clash -e.