FlowZ

January 5, 2026 · View on GitHub

简洁现代的跨平台代理客户端，基于 sing-box 核心，支持 VLESS、Trojan和hysteria2协议（当前主流最安全好用的协议），主打配置简单，规则明确，体验优良所见即所得。

image

✨ 功能特性

  • ✅ 支持 VLESS 、Trojan 和hysteria2协议
  • ✅ 多种代理模式（全局、智能、直连）
  • ✅ TUN 透明代理模式
  • ✅ 自定义域名路由规则
  • ✅ 系统托盘集成
  • ✅ 开机自启动和自动连接
  • ✅ 现代化的用户界面
  • ✅ 跨平台支持（Windows / macOS）

📋 系统要求

  • Windows 10 (1809+) 或 Windows 11
  • macOS 10.15+ (Catalina 或更高版本)

📥 安装

从 Releases 页面下载最新版本：

  • Windows: 运行 .exe 安装包
  • macOS (Apple Silicon): 打开 .dmg 文件并拖入 Applications
  • macOS (Intel): 需要从源码构建，参见下方说明

🛠️ 从源码构建

# 克隆仓库
git clone https://github.com/zhangjh/FlowZ.git
cd FlowZ

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 构建
npm run build

# 打包
npm run package:win   # Windows
npm run package:mac   # macOS

macOS Intel 用户需要修改 electron-builder.json 中的 mac.target.arch 为 ["x64"]。

mac下若打开提示“软件已损坏”，可在终端执行xattr -cr /Applications/FLowZ.app后再打开

🚀 快速开始

1. 配置服务器

  • 打开应用 → "服务器"标签
  • 选择协议（VLESS 或 Trojan）
  • 填写服务器信息
  • 点击"保存配置"

2. 连接代理

  • 返回"首页"
  • 点击"启用代理"
  • 等待连接成功

3. 选择代理模式

默认是TUN模式，全部流量都被代理软件拦截，至于是否需要真正走代理软件请求，取决于选择的代理模式：

  • 全局模式：所有流量通过代理
  • 智能模式：自动分流（推荐）
  • 直连模式：不使用代理 这种模式体验更佳，所有应用都可以实现代理，不需要手动配置，比如终端环境等。 如果不希望使用TUN模式，可以进入设置页面手动选择"系统代理模式"。
image

4. 自定义规则

手动配置某些域名规则的代理模式：代理、直连、阻止，支持通配符方式。 这是促进我研发本项目的主要驱动力之一，市面上的一些代理软件在规则配置和执行方面要么太复杂，要么压根不生效。

🔧 技术栈

  • Electron
  • React 18 + TypeScript
  • sing-box 核心
  • Tailwind CSS + shadcn/ui

📄 开源协议

本项目采用 MIT 协议开源。

💬 反馈与支持

如遇到问题或有功能建议，请在 Issues 页面提交。

⚠️ 免责声明

本软件仅供学习和研究使用，请遵守当地法律法规。使用本软件所产生的任何后果由使用者自行承担。