zh Troubleshooting and FAQ

故障排除与常见问题

故障排除

“无法打开 V2Mac” / “Apple 无法验证…” DMG 未经公证。在 系统设置 → 隐私与安全性 中点击 仍要打开，运行 xattr -dr com.apple.quarantine /Applications/V2Mac.app，或用 Homebrew 安装。

已连接但打不开网页（“No answer through this server”） 内核在运行，但服务器不通。测试分组的真实延迟（⌘T）并选择有响应的服务器，或开启自动选择服务器。在日志面板（⇧⌘L）查看内核错误。在受限网络上，可点击 Settings → Connection 中 TLS fragment 下的 Find Settings…；对于 Cloudflare 后的服务器，可尝试 Find Clean IP。

“Port 10808 is in use” 其他应用（或其他代理客户端）占用了端口。通知中提供 Use Port N，也可在 Settings → Proxy 修改端口。

服务器报 “unknown authority” 服务器使用自签名证书。仅在信任该服务器时，在 Settings → Connection 中开启 Allow insecure servers。

添加规则后内核无法启动 规则中的某个 geosite: 或 geoip: 列表不存在，日志会给出名称。删除或修正该规则；规则窗口只提供存在的列表。

应用规则不生效 TUN 模式下无法识别应用，请使用主机或 IP 规则。不用 TUN 时，应用必须使用系统代理或 V2Mac 端口。System Proxy 关闭时，你手动指向该端口的应用会跳过规则。

浏览器忽略主机规则 浏览器使用 QUIC（UDP 443），会隐藏主机名。在规则窗口中开启 Block QUIC。

V2Mac 退出或崩溃后无法上网 Kill Switch 会一直阻断，直到 V2Mac 解除。打开 V2Mac 点击 Allow Traffic，或重启 Mac。

系统代理圆点为红色 其他应用修改了系统代理设置。将 System Proxy 关闭再打开。

TUN 每次都要密码 ad-hoc 版本（DMG、Homebrew）每次应用会话询问一次。Apple 签名版本使用只需批准一次的助手。

订阅更新失败 尝试另一条路线（连接时用 Update via Proxy）。Clash YAML 和 sing-box 订阅可以使用；如果提示没有服务器，说明其中的服务器类型 V2Mac 无法使用（TUIC、WireGuard）。

报告问题 提交 issue，附上 macOS 版本、V2Mac 版本（Settings → About）和日志（日志面板中的 Copy All）。请先删除服务器地址和密钥。如果 V2Mac 崩溃了，请同时附上 Settings → General → Show Crash Reports 中最新的 V2Mac 或 xray .ips 文件。

常见问题

V2Mac 是 Mac 上的 V2Ray 客户端吗？ 是的。它运行 V2Ray 内核的后继者 Xray-core，可读取 V2Ray 和 Xray 的链接与订阅。

支持 VLESS REALITY 和 XTLS Vision 吗？ 支持，可从链接导入或在服务器编辑器中设置，传输支持 TCP、WebSocket、gRPC、HTTPUpgrade、XHTTP 和 mKCP。

如何让所有应用（包括没有代理设置的）走代理？ 打开 TUN。

能替代 Proxifier 吗？ 可以。支持按应用和主机的规则、从 Proxifier、Clash、sing-box、v2rayN 和 Shadowrocket 导入，以及 Block QUIC。见路由。

局域网中的其他设备能使用吗？ 可以：Settings → Proxy → Allow connections from LAN，最好设置用户名和密码。将其他设备指向你 Mac 的局域网地址和端口。

支持 Intel Mac 或旧版 macOS 吗？ 不支持。需要 Apple Silicon 上的 macOS 26 或更高版本。

V2Mac 会收集数据吗？ 不会。见设置参考。

如何防止 Chrome 中的 WebRTC 和 DNS 泄漏？ 使用同一作者的免费扩展 noleaker，代理设为 127.0.0.1:10808。

服务器保存在哪里？如何迁移到另一台 Mac？ 保存在 ~/Library/Application Support/v2mac。使用 Export Backup… 和 Restore Backup…。