Skip to content

Configuration

Jump to bottom
Juwan-Hwang edited this page Apr 10, 2026 · 7 revisions

配置说明

应用设置

Zephyr 的设置分为 6 个区域，均通过侧边栏「设置」页面管理。

常规设置

设置项 说明 默认值
语言 界面语言（English / 简体中文） 跟随系统
主题模式 Light / Auto / Dark Auto
关闭时最小化到托盘 关闭窗口时隐藏到系统托盘而非退出 开启
DNS 覆写 启用自定义 DNS 服务器配置 关闭
节点名称滚动 超长节点名自动滚动动画 开启
开机自启动 登录时自动启动应用 关闭
主题颜色 5 种预设色 + 自定义取色器 Purple
应用不透明度 10% - 100% 滑块调节 100%

主题颜色

名称 色值
Purple（默认） #8b5cf6
Blue #0A84FF
Green #34C759
Orange #FF9500
Pink #FF2D55
Custom 任意 HEX 颜色

DNS 覆写

启用后弹出独立配置面板，可设置：

  • 主 DNS 服务器 — 如 https://dns.alidns.com/dns-query
  • 备用 DNS 服务器 — 如 https://doh.pub/dns-query

DNS 配置会注入到 Mihomo 核心配置的 dns 字段中。

网络与路由

设置项 说明
统一延迟 所有节点使用统一延迟测试 URL
IPv6 支持 启用 IPv6 连接
局域网连接 允许局域网设备通过代理
Geo 数据库更新 更新 GeoIP/GeoSite 数据文件

内核管理

设置项 说明
当前版本 显示已安装的 Mihomo 内核版本
检查更新 从 GitHub 获取最新版本并更新
自动检查更新 启动时自动检查内核更新
配置文件夹 打开应用数据目录

系统工具集

设置项 平台 说明
UWP 环回免除 Windows 仅 允许 UWP 应用（如 Microsoft Store）通过代理
订阅客户端伪装 全平台 自定义 User-Agent 绕过机场嗅探

客户端伪装选项

类型 说明
Clash Verge 使用 Clash Verge 的 User-Agent
Mihomo Party 使用 Mihomo Party 的 User-Agent
Flclash 使用 Flclash 的 User-Agent
Custom 自定义 User-Agent 字符串

版本号从 GitHub API 实时获取最新值。

端口转发

管理 TCP/UDP 隧道规则：

参数 说明
协议 TCP / UDP
监听地址 本地监听端口（如 127.0.0.1:8080）
目标地址 转发目标（如 target.com:443）

高级设置

通过设置页底部的「高级设置」卡片进入。

自定义启动参数

向 Mihomo 内核传递额外命令行参数（textarea 输入，每行一个）。

安全限制：以下参数被禁止（防止安全绕过）： -d、-f、-ext-ctl、--external-controller、-secret、--secret

动态配置引擎

实时编辑 Mihomo 核心的完整运行时配置：

  • 递归渲染 — 自动展开所有嵌套键值对
  • 类型感知控件 — 布尔值 Toggle、数字输入、字符串输入、数组编辑器
  • 实时生效 — 修改后立即 PATCH 到核心 + 持久化到 run_config.yaml
  • 折叠展开 — 嵌套对象可折叠/展开

运行模式

通过首页三段式滑块切换：

模式 Mihomo 配置 说明
Rule mode: rule 按规则分流（默认）
Global mode: global 全部走代理
Direct mode: direct 全部直连

系统代理

工作原理

Zephyr 通过修改系统代理设置实现全局代理：

平台 实现方式
Windows 注册表 HKCU\...\Internet Settings（原子写入 + 回滚）
macOS networksetup 逐网络服务设置
Linux GNOME gsettings（原子写入）
Linux KDE kwriteconfig5/6 + DBus 通知
Linux XFCE xfconf-query

安全验证

  • 仅允许回环地址（127.0.0.1、::1、localhost）
  • 拒绝 127.0.0.1.evil.com 等欺骗性主机名
  • 最大长度 512 字符
  • Windows bypass 默认包含私有地址范围

托盘菜单

右键系统托盘图标显示完整菜单：

菜单项 说明
显示窗口 显示主窗口
系统代理 切换系统代理开关
TUN 模式 切换 TUN 开关
Rule / Global / Direct 切换运行模式（● 标记当前）
订阅子菜单 切换活跃配置文件
代理子菜单 按组浏览并切换节点（每组最多 15 个）
退出 停止核心 + 清除系统代理 + 退出

托盘图标状态

状态 图标
默认 默认图标
系统代理激活 黄色图标
TUN 模式激活 红色图标

托盘菜单与主窗口状态双向实时同步（通过 Tauri 事件系统）。

数据存储

目录结构

AppData/Zephyr/
├── config.json          # 应用设置（JSON）
├── profiles/            # 配置文件目录
│   ├── config_a.yaml    # 订阅配置文件
│   ├── config_b.yaml
│   └── metadata.json    # 加密的订阅元数据
├── run_config.yaml      # 运行时配置（注入了控制器设置）
├── mihomo/              # 内核目录
│   └── mihomo(.exe)     # Mihomo 内核二进制
├── cache.db             # Mihomo 缓存数据库
└── logs/                # 内核日志

加密存储

以下数据使用 AES-256-GCM 加密：

  • 订阅 URL
  • 订阅使用量信息（sub_info）

密钥从机器指纹派生（PBKDF2, 100K 迭代），绑定到当前设备。

导航

外部链接

Clone this wiki locally