Skip to content

Installation

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

安装指南

版本选择

Zephyr 提供两种发行版本：

版本 文件特征 适用场景
完整版 (Full) *-setup-full.exe / *-full.dmg / *-full.AppImage 包含 Mihomo 内核和 GeoIP/GeoSite 数据，首次安装推荐
精简版 (Lite) *-setup-lite.exe / *-lite.dmg / *-lite.AppImage 不含内核文件，体积更小，适合已有内核的用户（如更新客户端）

下载

从 GitHub Releases 下载对应平台的最新版本。

Windows

版本 格式
完整版 Zephyr_x.x.x_x64-setup-full.exe
精简版 Zephyr_x.x.x_x64-setup-lite.exe

同时提供 MSI 格式（-full.msi / -lite.msi）

macOS

架构 完整版 精简版
Apple Silicon (M1/M2/M3/M4) Zephyr_x.x.x_aarch64-full.dmg Zephyr_x.x.x_aarch64-lite.dmg
Intel Zephyr_x.x.x_x64-full.dmg Zephyr_x.x.x_x64-lite.dmg

同时提供 tar.gz 格式

Linux

格式 完整版 精简版
DEB (Debian/Ubuntu) Zephyr_x.x.x_amd64-full.deb Zephyr_x.x.x_amd64-lite.deb
AppImage (通用) Zephyr_x.x.x_amd64-full.AppImage Zephyr_x.x.x_amd64-lite.AppImage
RPM (Fedora/RHEL) Zephyr_x.x.x_amd64-full.rpm Zephyr_x.x.x_amd64-lite.rpm

安装步骤

Windows

  1. 下载 *-setup-full.exe
  2. 双击运行安装程序
  3. 按向导完成安装（支持中英双语）
  4. 首次运行可能需要 Windows Defender 确认

macOS

  1. 下载对应架构的 *-full.dmg
  2. 打开 DMG 文件
  3. 将 Zephyr 拖入 Applications 文件夹
  4. 首次打开可能需要在"系统偏好设置 → 安全性与隐私"中确认

TUN 模式提示：启用 TUN 时 macOS 会请求管理员权限，这是正常行为。

Linux

DEB (Debian/Ubuntu)：

sudo dpkg -i Zephyr_x.x.x_amd64-full.deb
sudo apt-get install -f  # 修复依赖

AppImage (通用)：

chmod +x Zephyr_x.x.x_amd64-full.AppImage
./Zephyr_x.x.x_amd64-full.AppImage

RPM (Fedora/RHEL)：

sudo rpm -i Zephyr_x.x.x_amd64-full.rpm

系统要求

项目 最低要求
操作系统 Windows 10+ / macOS 10.13+ / Ubuntu 20.04+
架构 x86_64 (amd64) / arm64 (Apple Silicon)
内存 100MB 以上
磁盘空间 完整版 ~50MB，精简版 ~15MB

首次使用

  1. 启动应用 — 主窗口自动显示
  2. 添加订阅 — 点击侧边栏「订阅」→「添加」，输入订阅 URL
  3. 选择节点 — 在代理页面点击节点卡片切换
  4. 开启系统代理 — 首页打开「系统代理」开关
  5. （可选）启用 TUN — 首页打开「TUN 模式」开关实现全局透明代理

Windows 用户：如需代理 UWP 应用（如 Microsoft Store），前往设置 → 系统工具集 → 点击「UWP 环回免除」。

导航

外部链接

Clone this wiki locally