V2Ray Mac客户端 v2rayN 下载与配置教程

订阅 → 添加订阅
  地址       https://example.com/api/v1/client/subscribe?token=xxxx
  备注       示例订阅
  更新间隔   1440 分钟
  自动更新   开启

订阅链接是节点配置的分发方式：客户端按设定间隔拉取一份节点列表，本地只保存链接本身，节点增删由订阅方在服务端完成。v2rayN 支持添加多条订阅并分别设置更新间隔，也可以关闭自动更新改为手动刷新；v2rayNG 的订阅入口在侧边栏，导入后可长按重命名。导入失败通常集中在三类原因：链接本身已失效、拉取时网络不通、返回内容不是标准节点列表。排查时先在浏览器打开链接确认有返回，再看客户端更新日志里的具体错误。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      { "type": "field", "domain": ["geosite:cn"], "outboundTag": "direct" },
      { "type": "field", "ip": ["geoip:cn"], "outboundTag": "direct" },
      { "type": "field", "network": "tcp,udp", "outboundTag": "proxy" }
    ]
  }
}

路由决定一条连接走代理还是直连，规则按从上到下的顺序匹配，命中即停止，所以直连规则要写在兜底代理之前。域名规则用 geosite:cn 覆盖常见国内站点，IP 规则用 geoip:cn 兜住域名解析后的地址；domainStrategy 设为 IPIfNonMatch 时，域名规则不命中才会解析出 IP 再匹配一次。改动规则后需要重载配置或重启内核才会生效，日志里会打印实际命中的规则标签，可以用它验证分流是否符合预期。

内核设置
  当前内核    Xray-core
  备选内核    V2Fly-core
  切换路径    设置 → 内核设置 → 选择内核文件
  生效方式    重启内核后生效

图形客户端本身不处理代理流量，真正建立连接的是内核：v2rayN 与 v2rayNG 默认搭配 Xray-core，也支持切换到 V2Fly-core。两者共享 VMess、VLESS 等协议基础，配置格式高度一致，Xray 在 REALITY、XTLS Vision 等新特性上跟进更快，V2Fly 对旧配置的兼容更保守。切换内核只影响本机的解析与出站实现，节点能否使用仍取决于服务端配置；遇到某个协议在新内核下报错，可以先用另一个内核验证问题出在配置还是内核差异。

{
  "log": {
    "loglevel": "warning",
    "access": "none",
    "error": ""
  }
}

运行日志按时间顺序记录三件事：配置加载、与节点握手、连接按规则出站。看日志先找第一条 error，它上方的几行通常提供上下文；failed to parse 指向配置语法问题，connection refused 表示目标不可达，context deadline exceeded 多为超时。把 loglevel 调到 warning 可以过滤日常噪音，调成 debug 则能看到完整的握手过程，排查完记得调回。日志面板支持清空与导出，对照出问题的时间点定位会更直接。