vpn-tool

安装与连接教程

以 macOS 桌面客户端为例，从启动客户端到建立隧道连接，附真机界面截图。当前尚无正式安装包，请先按 下载页 的「源码方式运行」启动客户端。

Before you start

开始之前

请确认本机可访问 api.vpntool.vip（TCP 443），且网络未封禁 UDP 51820 出站——隧道数据走 UDP，若该端口被拦截，连接会失败。另需安装 WireGuard 工具（App Store 安装 WireGuard，或 brew install wireguard-tools）。

Steps

操作步骤

  1. 启动客户端并登录

    启动客户端后进入登录页，输入注册邮箱与密码，点「登录」。登录态保存在本机，下次启动免登录。密码错误会显示内联提示「邮箱或密码不正确，请检查后重试」。

    vpn-tool 客户端登录界面
    登录界面：输入注册邮箱与密码

  2. 确认订阅状态

    未订阅的账号，主控按钮置灰带锁，顶部出现引导横幅「账号未订阅，连接功能已锁定」。点横幅上的「立即订阅」在客户端内完成订阅（套餐与价格见 价格页）。订阅生效后，主控按钮变为可点击。

    未订阅状态：连接功能已锁定，提示立即订阅
    未订阅状态：连接功能锁定，点「立即订阅」完成订阅

  3. 点主控按钮建立连接

    已订阅状态下，点圆形主控按钮。系统会弹出授权框要求输入 Mac 登录密码——这是建立 WireGuard 隧道的必要提权，每次连接都会弹出，属 macOS 安全机制。

    已订阅且未连接状态，主控按钮可点击
    已订阅、未连接：主控按钮可点击

  4. 等待连接完成

    按钮显示旋转环并提示「正在连接…正在建立加密隧道…」即为连接中；变为稳定状态、顶部状态点转青即为已连接。再次点击主控按钮即可断开。

    连接中状态：按钮显示旋转环
    连接中：旋转环 + 呼吸状态点

  5. 选择出口节点（可选）

    底部「节点」一行默认「自动 · 最优节点」，由服务端自动选择最快节点；展开后可手动指定具体节点。

    节点选择列表，默认自动最优节点
    节点选择：默认「自动 · 最优节点」，可展开手动指定

  6. 验证是否生效

    连接成功后客户端会显示当前出口 IP。也可在终端验证：返回值应为网关出口 IP，而不是你的本地公网 IP。

    curl -s ifconfig.me      # 返回网关出口 IP，而非你的本地公网 IP

Troubleshooting

常见问题

现象原因处理
提示「无法验证开发者」macOS 对非 App Store 应用的拦截打开「系统设置 → 隐私与安全性」，找到关于 vpn-tool 的提示，点「仍要打开」后重启客户端
点连接提示找不到 wg-quick系统未装 WireGuard 工具从 App Store 安装 WireGuard，或 brew install wireguard-tools
wg-quick 报需要 bash 4 以上macOS 自带 bash 仅 3.2brew install bash 后重试
一直「连接中」后失败网络封禁 UDP 51820 出站换一个网络；确认防火墙未拦截 UDP 51820
登录提示「邮箱或密码不正确」凭据输入错误核对邮箱与密码，注意大小写
提示「未订阅，连接功能已锁定」订阅未激活或已到期在客户端完成订阅（见 价格页）
提示流量已用尽套餐流量额度用完续费后额度累加，立即可用
授权框反复弹出macOS 对提权命令的限制属正常现象
连接后无法上网DNS 或路由异常断开重连；查看官网状态公告

反馈问题时，请附客户端「复制诊断信息」按钮输出的内容。

Uninstall

卸载

退出客户端（菜单栏图标 → 退出）→ 打开「应用程序」把 vpn-tool 拖入废纸篓 → 清理本地配置与登录态：

rm -rf ~/.vpntool

若卸载后网络异常，重启一次系统即可恢复。