VPN Bypass：macOS 菜单栏 VPN 分流工具

项目简介

VPN Bypass 是一个 macOS 菜单栏应用，用来决定哪些流量走 VPN、哪些不走。企业 VPN 客户端通常把所有流量都塞进隧道，导致流媒体卡顿、AirPlay 和 Chromecast 失效，个人流量也会经过公司网络；而多数客户端锁死了自己的分流功能，手动添加的路由在重连或 CDN 换地址后就失效了。

VPN Bypass 从菜单栏下拉菜单里帮你添加路由，并在 VPN 重连或网络变化后自动恢复。

主要功能

• 三种模式：Bypass 让列表中的目标绕过 VPN；VPN Only 只让它们走 VPN；Custom 为每条规则单独指定出口，按先匹配先生效处理。
• 37 个内置服务包：Telegram、WhatsApp、YouTube、Netflix、Spotify、Zoom、GitHub 等，也可以自己添加域名、通配符或子网。
• Lookups 查询：默认关闭，开启后可以看到你的 Mac 正在解析的域名（按频率排序），一键加入规则。
• Custom 模式多出口：一条规则可以直接出网、走指定的某个 VPN（同时有多个 VPN 时）、走 HTTP 或 SOCKS5 代理，或走某个 Tailscale 节点。
• 自动恢复：VPN 重连或网络变化后路由自动回来，域名地址轮换时重新解析。
• 客户端识别：可识别 GlobalProtect、Cisco AnyConnect、OpenVPN、WireGuard、FortiClient、Zscaler、Cloudflare WARP、Pulse Secure、Check Point 和 Tailscale 出口节点。
• 避免互相干扰：不碰 Tailscale 自己的网段、loopback 和其他隧道，网状 VPN 与本地代理可以继续工作。
• vpnb 命令行：通过只有本账户能打开的 socket 完成应用里的全部操作，密码从标准输入读取，不接受命令行传参。
• 无需内核扩展：没有需要批准的内核或系统扩展，由一个小的 root helper 负责路由，且只有本应用能与它通信。
• 可选 /etc/hosts DNS 绕过、路由校验、通知、登录时启动，以及配置导入导出。

安装与使用

通过 Homebrew 安装：

brew tap geiserx/vpn-bypass
brew install --cask vpn-bypass

也可以从 Releases 下载 DMG 手动安装。

安装后从「应用程序」打开 VPN Bypass，批准一次用于安装 root helper 的管理员提示，连接 VPN，然后在 Settings > Services 里打开某个服务，或在下拉菜单里输入一个域名。下拉菜单里的状态标签显示 ON、菜单栏图标出现箭头，就说明生效了。

更多文档见 geiserx.github.io/VPN-Bypass，包括路由模式、用法、工作原理、排错和开发说明。

注意事项

• 需要 macOS 13 或更高版本。
• 首次运行需要批准一次管理员提示，用来安装负责路由的 root helper。
• 若提示「应用已损坏」，处理办法见官方 Getting started 文档中的说明。
• 想让 AI agent 读写 VPN Bypass，可使用相关项目 vpn-bypass-mcp，它通过和 vpnb 相同的 socket 工作。
• 许可证为 GPL-3.0-or-later。

---

本作品整理自 GitHub 开源项目 GeiserX/VPN-Bypass，原作者 @GeiserX，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。