Repository navigation
zh Connecting
双击服务器、按 Return，或使用连接栏或菜单栏面板中的连接按钮。V2Mac 会启动 Xray-core，并在 127.0.0.1:10808 提供本地代理（SOCKS5 和 HTTP 共用端口）。
让流量经过它有三种方式：
| 方式 | 经过代理的流量 | 需要 |
|---|---|---|
| 手动代理 | 只有你设置为 127.0.0.1:10808 的应用 |
无 |
| System Proxy | 遵循 macOS 代理设置的应用（浏览器和大多数应用） | 批准助手 |
| TUN | 所有应用和所有 DNS 查询 | 批准助手 |
连接栏的地址菜单可复制 127.0.0.1:10808、socks5://…、http://… 以及终端用的 export 命令。
在连接栏或菜单栏面板中打开 TUN。一个虚拟网卡会承载整台 Mac 的流量，包括没有代理设置的应用和 DNS。选择会被记住；连接时切换会重启连接。
- 服务器配置从不以 root 运行。一个固定的小型 root 进程（forwarder）把隧道流量交给以你的身份运行的普通内核。
- Apple 签名版本使用特权助手：V2Mac 先说明，然后你在 系统设置 → 通用 → 登录项与扩展 中批准一次。
- ad-hoc 版本（DMG 和 Homebrew）每次应用会话在 macOS 对话框中要求输入一次管理员密码。V2Mac 不会看到或保存密码。如果关闭了该对话框，TUN 开关会变成 授予权限：点击即可再次请求。
- TUN 模式下无法识别应用，因此应用规则不生效；主机和 IP 规则生效。见路由。
- TUN 失败时（Settings → Connection）：保持本地代理运行（默认），或停止连接。
Proxy 开关（连接栏）、System Proxy（菜单栏面板）或 Settings → Proxy 会把所有网络服务（Wi-Fi、以太网…）的 Web、安全 Web 和 SOCKS 代理指向 V2Mac。本地地址和 *.local 不走代理。断开或退出时会关闭。
开关旁的圆点显示系统当前设置：绿色为 V2Mac 的端口，红色为其他设置，灰色为未设置代理。
Settings → Connection → Kill switch（默认关闭）。在需要连接期间，Mac 只能访问你的服务器：其他一切都被拒绝，内核重启或 V2Mac 崩溃时也一样。它在自己的 anchor 中使用 macOS 防火墙（pf），不改动你的防火墙规则。
- 始终允许：回环、TUN 接口、DHCP、DNS 和局域网。
- 开启时，Direct 模式、绕过的地区和“without proxy”下载都无法访问互联网。
- 若 V2Mac 意外退出，阻断会保留。下次启动会显示“Kill switch is blocking all traffic”和 Allow Traffic。重启 Mac 也会清除。
每次连接和切换服务器后，V2Mac 会通过服务器询问公共 IP 服务（ipwho.is、ipinfo.io 或 Cloudflare）流量从哪里出去。然后你会看到：
- 连接栏和菜单栏面板中的国旗、城市、国家和 IP；
- 菜单栏图标上绿色徽标中的两字母国家代码。
若没有服务响应，连接栏显示“No answer through this server”：内核在运行但流量不通。Direct 模式下跳过检测。检测和徽标都可在 Settings → Connection 中关闭。
开启 Switch servers without restarting（默认）时，选择另一个分享链接服务器会在运行中的内核内替换：已打开的连接在旧服务器上结束，新连接走新服务器，流量计数继续。完整 JSON 配置、TUN 模式和任何设置变更都会重启内核。
Settings → Connection → Automatically select a working server（默认关闭）。
- 连接时，V2Mac 测试活动服务器所在分组，选择真实延迟最低的。
- 每 30 秒通过代理检查连接。连续两次失败后重新测试分组，并按分组顺序切换到第一个响应的服务器。
- 每 3 分钟，只有当另一服务器快至少 100 ms 且 25% 时才切换。在低电量模式下跳过此项，只在服务器失效或变慢时切换。
- 可选切换条件：延迟连续两次超过上限（默认 1000 ms），或在有流量时下载速度在若干分钟（默认 2）内低于下限（默认 100 KB/s）。
- 手动选择的服务器会保持，直到它失败。
V2Mac 会在崩溃后（带退避）、睡眠后和网络变化后重启内核（Settings → General），如果退出时处于连接状态，下次启动会重新连接。
均在 Settings → Connection，默认关闭：
- TLS fragment： 将 TLS hello（或前几个包）分片并暂停发送。在某些受限网络有效，在另一些网络会导致握手失败。
- Noise packets： 连接前发送随机 UDP 包。
- Custom DNS： 自定义 DNS 服务器（默认 Cloudflare 和 Google DoH）以及内核的 IPv4/IPv6 偏好。
-
Allow insecure servers： 用于链接中带
allowInsecure的服务器。V2Mac 会在连接时固定服务器出示的证书，因为 Xray 已不再支持跳过校验。
Settings → WARP 可注册免费的 Cloudflare WARP 设备（MASQUE）。可输入 WARP+ 许可证密钥，然后：
- Add WARP to Servers： 将“Cloudflare WARP”作为独立服务器加入 Custom Configs。
- Send traffic out through WARP： 将 WARP 串接在活动服务器之后，网站看到的是 Cloudflare 地址。路由和规则不变。
已连接时注册会经过代理，因为 WARP API 常被封锁。部分服务器会拒绝 WARP 流量。
开启 Count traffic usage（Settings → General）后，面板和连接栏显示本次会话的流量。点击可查看会话和总计的下载与上传，以及 Reset Total。