下载 vpn-tool
当前阶段提供源码方式运行，供开发与内测使用。面向普通用户的正式安装包（macOS）正在打包与签名中，完成后会在本页公布下载链接与校验值。
正式安装包准备中
本页暂不提供 .dmg / .exe 安装包下载，也不提供任何第三方下载镜像。请勿从其他来源获取安装包，以免被植入后门。安装包上线后，本页会给出官方直链与 SHA256 校验值。
Source run
源码方式运行（开发 / 内测）
需要本机已安装 Node.js 与 npm。桌面端为 Electron 应用，从源码启动即可体验完整界面与连接流程。
cd client/desktop
npm install # 国内网络可加：--registry=https://registry.npmmirror.com
# 并设 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
npm start建议在终端中启动（继承完整 PATH），避免图形化启动器找不到 wg-quick。
CLI
命令行客户端（进阶）
不需要图形界面时，可用 Go CLI。需 Go 1.27+，同样从源码构建。
cd client
# 登录（token 落盘复用）
go run ./cli -server https://api.vpntool.vip login -email you@example.com -password 'your-password'
# 查看账号、订阅与流量
go run ./cli -server https://api.vpntool.vip me
# 生成设备配置到 ~/.vpntool/wg0.conf
go run ./cli -server https://api.vpntool.vip up -name mac
# 起隧道 / 断隧道
sudo wg-quick up ~/.vpntool/wg0.conf
sudo wg-quick down ~/.vpntool/wg0.confRequirements
平台与系统要求
| 平台 | 最低版本 | 当前状态 |
|---|---|---|
| macOS | 13 Ventura | 可用（源码方式运行） |
| Windows | 10 / 11 | 计划中 |
| Android | 9.0 | 计划中 |
| iOS | 15 | 计划中 |
系统要求
- 管理员权限：首次建立隧道时，系统会要求输入一次登录密码。
- 磁盘可用空间 ≥ 400 MB。
- 网络要求：可访问
api.vpntool.vip（TCP 443，登录与配置下发）；可访问网关 UDP 51820（隧道数据）。 - macOS 上需要 WireGuard 工具：从 App Store 安装 WireGuard，或
brew install wireguard-tools。