Total Pageviews

Thursday, 20 August 2026

Zephyr,一款 Mihomo GUI

 

Zephyr: A modern, lightweight, and secure Mihomo / Clash Meta GUI client built with Tauri and Rust.

 

安全至上 · 极简美学 · 轻量高效

Stars Release License Platform Downloads Security Rust Tests JS Tests Tauri Rust OpenSSF Best Practices

简体中文 | English


快速上手

五分钟,从零到通:

  1. 下载 — 前往 GitHub Releases 获取最新版本
  2. 安装 — 运行安装程序(便携版则解压即可)
  3. 导入 — 通过 URL或文件添加订阅
  4. 选节点 — 从列表中选定一个代理节点
  5. 开代理 — 开启系统代理或 TUN 模式

至此,你的流量已通过所选节点转发。

透明声明:本项目全部内容由 AI 生成(包括这段文字)。安全措施已部署——详见安全设计——但安全性、稳定性与性能均不应被视为已经充分验证。使用前请自行评估风险。如发现安全问题,欢迎提交 Issue。


截图

Zephyr 主页 - macOS 浅色模式 Mihomo 代理客户端界面

更多截图


Zephyr 深色模式 - 代理节点管理界面 Zephyr 设置页面 - 系统代理与 TUN 配置

何以 Zephyr?

Zephyr 起于一念之不忿。市面上的 Mihomo GUI,竟无符合我审美的。故动手“vibe coding”。

视觉体验。 毛玻璃卡片,渐变图标,深色模式,动画细节,疏密有致的排版。一个代理客户端,应当是设计出来的,而非拼凑出来的。

安全边界。 订阅、配置、脚本、文件、更新、深链——每一处入口都有明确的约束。纵深设防。

规则能力。 Prism Engine 带来声明式规则补丁、智能节点选择与脚本沙箱。更强的能力,更少的复杂。

完整功能清单见 FEATURES.md


社区成长

Zephyr 正受到开发者与用户的关注。

Star History Chart

功能特性

核心能力

  • Mihomo 核心管理 — 启动、停止、重启代理核心
  • 多配置管理 — 创建、编辑、切换 YAML 配置
  • 订阅管理 — URL、文件、拖拽导入,Base64 自动解码
  • 代理模式切换 — 规则、全局、直连三种模式
  • 系统代理 — Windows / macOS / Linux 原生系统代理管理
  • TUN 模式 — 系统级代理
  • 连接与流量 — 实时连接列表、连接关闭、上下行速度、历史趋势

Prism Engine

Zephyr 内置基于 clash-prism-* crate 的规则引擎,用以增强 Mihomo 的配置能力:

特性 说明
声明式规则补丁 .prism.yaml 支持 $prepend$append$filter$override__when__ 条件
规则库管理 增删改查、分组、导入、自动应用、文件监听
智能节点选择 基于延迟、成功率、稳定性的 EMA 评分与自适应调度
Failover 节点故障时自动切换,支持阈值、冷却与回退策略
脚本沙箱 QuickJS 执行环境,设有时间、内存、字符串长度、循环与递归等资源限制
插件系统 插件发现、加载、生命周期钩子及细粒度权限控制
Override 系统 Prism DSL + JavaScript 双引擎配置覆写,全局/逐配置作用域,拖拽排序,导入/导出
KV 存储 持久化键值存储

安全设计

Zephyr 采用纵深防御策略:

层级 防护手段 实现方式
加密 机器绑定加密 以硬件指纹派生密钥加密订阅元数据;代理配置支持可选加密(v2.3.7+)
网络 SSRF 防护 订阅与规则 URL 下载前进行 DNS 验证;重定向至内网地址将被拦截
网络 DNS 防泄漏 TUN 模式自动注入 dns-hijack,将全部 DNS 流量劫持至 Mihomo
配置 配置清洗 递归移除危险 YAML 字段,限制 provider 路径遍历
脚本 权限控制 脚本执行受资源限制与权限限制双重约束
输入 输入验证 IPC 命令入口进行长度、格式及 UTF-8 安全校验
限流 双重限流 常规命令固定冷却 + Prism 命令滑动窗口
文件 文件安全 安全权限、UUID 临时文件、压缩包路径遍历防护、符号链接拒绝、压缩炸弹检测
更新 更新完整性 SHA256 校验 + Minisign Ed25519 签名验证、可信主机限制、原子更新与自动回滚
深链 深链安全 限制 clash:// 协议入口与 URL scheme
构建 CSP 与加固 限制脚本与连接来源,release 启用 LTO、strip、panic=abort

系统集成

  • 系统托盘状态图标与快捷菜单
  • 全局快捷键:窗口唤出、系统代理、TUN、代理模式切换
  • clash:// 深链订阅导入
  • Windows UWP 环回免除
  • Mihomo 核心、GeoIP / GeoSite 数据及 Zephyr 客户端更新
  • 开机自启、系统通知、配置目录打开

网络优化

  • 三层优化体系:Mihomo 配置默认值(tcp-concurrent、keep-alive、fake-ip 持久化)+ OS TCP 调优(Fast Open、ECN、buffer)+ DNS 优化
  • 独立 UI:手动 Apply / Revert / Status 查看
  • Linux 持久化至 /etc/sysctl.d/

轻量模式

  • 关闭窗口时销毁 WebView 释放内存,仅保留系统托盘
  • 设置入口:Settings → General → Lightweight Mode

UI / UX

  • 透明无边框窗口,自定义标题栏
  • UI 缩放:1x – 1.5x 界面缩放,适配不同分辨率
  • 虚拟滚动日志,分级过滤,正则搜索
  • CodeMirror 6 编辑器,支持 Prism DSL 语法高亮与补全
  • 代理节点卡片 3D 交互效果
  • 主题系统:预设主题与自定义颜色
  • i18n:14 种语言(en、zh、ja、ko、ru、es、fa、tk、my、ar、ur、sw、tr、vi),RTL 布局支持,CLDR 复数规则验证
  • 前端事件总线、集中式状态与缓存层

技术栈

层级 技术 说明
桌面框架 Tauri v2 轻量桌面应用框架
后端 Rust 1.92+ IPC、系统集成、核心管理、安全边界
前端 原生 JavaScript 无前端框架依赖
样式 UnoCSS presetWind4 即时原子化 CSS 引擎
编辑器 CodeMirror 6 Prism DSL 编辑体验
规则引擎 clash-prism-* 规则补丁、插件、脚本沙箱、智能选择
包管理 pnpm workspace apps/* + packages/* monorepo
代理核心 Mihomo Clash Meta 内核

安装

系统要求

平台 架构 最低版本
Windows x64 / ARM64 Windows 10 1809+
macOS x64 / ARM64 (Apple Silicon) macOS 10.13 (High Sierra)+
Linux x64 / ARM64 glibc 2.31+(Ubuntu 20.04+、Debian 11+、Fedora 34+)

硬件:约 300MB 内存,约 50MB 磁盘空间(完整版)

下载

前往 GitHub Releases 下载对应平台的安装包。

类型 说明 适用场景
Full 含 Mihomo 核心及 GeoIP / GeoSite 数据 首次安装、离线使用
Lite 体积更小,不含核心资源 已有本地核心资源
Portable 解压即用,数据存储于程序目录 U 盘携带、多设备使用

便携版使用

  1. 下载 Zephyr_x64-portable.zip / Zephyr_arm64-portable.zipZephyr-linux-x64-portable.tar.gz / Zephyr-linux-arm64-portable.tar.gz
  2. 解压至任意目录
  3. 在目录中创建名为 .portable 的空文件(首次运行时会自动创建)
  4. 运行可执行文件

便携版限制:不支持开机自启及客户端内更新。详见 PORTABLE.md


从源码构建

前置要求

  • Rust 1.92 或更高版本
  • Node.js 20.18.1 或更高版本
  • pnpm 10 或更高版本
  • 对应平台的 Tauri 系统依赖

开发模式

pnpm install
pnpm run dev

构建

pnpm run build

验证命令

pnpm run typecheck
pnpm run test
pnpm run lint
pnpm run check:i18n

桌面包亦可单独执行:

pnpm --filter @zephyr/desktop typecheck
pnpm --filter @zephyr/desktop test
pnpm --filter @zephyr/desktop lint
pnpm --filter @zephyr/desktop build:css

Rust 侧验证:

cd apps/desktop/src-tauri
cargo check
cargo test
cargo clippy --all-targets --all-features
from  https://github.com/Juwan-Hwang/Zephyr

No comments:

Post a Comment