适合第一次在 Windows 或 macOS 上使用 v2rayN 的读者。先确认安装包和内核能运行,再验证一个节点和本地代理端口,最后开启系统代理与登录自启。每一步单独验证,便于分清是程序没启动、端口没监听,还是应用没有使用代理。
首次运行顺序:选包、启用节点、验证代理
以下以 v2rayN 7.x 桌面版为例。不同小版本和界面构建的菜单排布可能不同,尤其是 Windows 托盘菜单与 macOS 界面的入口。首次运行时先关闭其他正在使用的代理客户端,暂不开启 TUN,也不必启用局域网连接。
确认架构
Windows 到「设置」→「系统」→「关于」查看系统类型,区分 x64 与 ARM64。macOS 在 Apple 菜单 →「关于本机」查看芯片或处理器:Apple 芯片对应 ARM64,Intel 处理器对应 x64。客户端和随包内核应选同一目标架构。
展开安装包
Windows 便携压缩包要完整解压到固定目录,再运行其中的
v2rayN.exe;只把主程序拖出压缩包会丢失配套文件。macOS 压缩包解开后,将v2rayN.app整体移到「应用程序」,再从那里打开。添加测试节点
手上有单条分享链接时,复制后在主窗口通过「服务器」菜单中的剪贴板导入项添加。手上只有订阅地址时,使用「订阅分组」→「订阅分组设置」添加分组,再更新订阅。列表出现条目后,选中其中一个并设为活动服务器。
核对监听端口
打开「设置」→「参数设置」,核对本地监听端口,再看主窗口日志中内核是否成功启动。记下实际端口以及它接收的是 HTTP、SOCKS 还是混合代理,不要用节点编辑窗口里显示的远端端口代替。
接入系统代理
在客户端的系统代理菜单中选「自动配置系统代理」。Windows 可从托盘图标的右键菜单进入。随后在使用系统代理的浏览器中打开网页;若浏览器另有代理扩展或独立设置,应先排除这些变量。
程序和内核的位置:区分权限、路径与架构
主窗口能打开,只说明 v2rayN 界面已经启动。真正处理连接的是内核进程;导入条目后仍需确认活动节点使用的内核能被找到和执行。先查启动日志,再决定是否更换安装包或更新内核。
按平台检查应用位置
Windows:保留整套目录
- 便携版可放在当前账户可写的固定目录。不要在压缩包预览窗口内双击程序,也不要只复制
v2rayN.exe。 - 常见 7.x 目录布局将内核放在程序目录下的
bin中,例如bin\xray\xray.exe。如果文件不在,先确认下载的是带内核的包,或使用客户端提供的内核更新入口补齐。 - 运行时缺失提示和写入权限错误是两类问题。前者按提示核对所需运行时和架构;后者检查程序或数据目录是否可写,不把「以管理员身份运行」当成默认处理方式。
macOS:保留应用包结构
- 不要把
v2rayN.app内的可执行文件单独移动或改名。内核实际路径以当前发行包和启动日志为准,不套用 Windows 的文件层级。 - 若日志显示
bad CPU type in executable,需要核对报错的是客户端还是内核,再换成匹配本机架构的包;反复导入订阅不会改变执行文件架构。 - 若系统阻止启动,先阅读具体提示,并确认下载来源及单位设备管理要求。不要为启动单个应用关闭系统保护。
移动或升级前先退出旧实例,备份当前版本使用的配置目录;更换位置后从新路径手动启动一次,再验证原有快捷方式和自启项。
备份时不要只留主程序,也不要把日志当作配置备份。订阅地址可能含访问令牌,节点条目也可能含连接凭据。向他人提供报错信息时,保留错误类型和必要路径即可,删去订阅地址、节点凭据和路径中不必要的账户名。
内核选择:以活动节点的协议参数为准
订阅是获取一组条目的入口,内核才负责解释并运行单个条目。订阅刷新成功,并不证明每条配置都与选定的内核兼容。在「设置」→「参数设置」中核对对应协议的内核类型;如果节点编辑窗口提供单节点内核选项,也检查是否已有单独指定。
沿用条目对应的内核
推荐保留导入后已确认的协议与传输参数。例如,条目明确为 VLESS + REALITY 时,使用支持该组合的 Xray 内核。不要把连接失败直接归因于内核,也不要把 REALITY 改成 TLS 来试通。
适合:首次配置,服务端参数已有明确说明
对单条配置验证替代内核
若维护方明确说明某条 VMess 配置兼容 V2Ray 和 Xray,可保留已知配置,再对单条切换并比较启动日志。能识别协议名称,不等于能识别该条目使用的传输和安全选项。
适合:已有可复现问题,需要隔离内核兼容性差异
本地端口和系统代理:分别确认有没有监听、有没有接入
本地监听端口供同一台电脑上的应用连接;远端端口供内核连接服务器。两者可以不同。开启系统代理只是让遵循系统设置的应用找到本地入口,不会替内核修复远端连接,也不意味着所有应用的流量都经过该入口。
- 日志报端口占用:先退出另一款代理客户端或旧的 v2rayN 实例。如果占用进程需要保留,可为 v2rayN 选择空闲端口,重启内核后重新配置系统代理,并同步改掉应用中手填的旧端口。
- 端口已监听,浏览器仍失败:Windows 检查「设置」→「网络和 Internet」→「代理」;macOS 检查「系统设置」→「网络」→当前网络服务的「详细信息」→「代理」。这里只核对系统实际设置,不必再手动写一份。若应用要求填写 HTTP 代理,不能给它填一个只接收 SOCKS 的端口。
- 退出后网页打不开:检查系统是否仍指向已经停止监听的本地端口。可在退出前先选择客户端的「清除系统代理」;如果原先有单位或学校指定的代理,应恢复原设置,而不是统一关闭。
登录自启:验证启动路径和代理状态
先确认手动启动时可以浏览网页,再设置登录自启。桌面客户端的自启通常发生在用户登录后,不等同于设备通电后、登录前就提供代理。自启也只负责拉起程序,不能证明内核已启动,或系统代理已恢复到所需模式。
- Windows 可先在「设置」→「参数设置」中查找「开机自动启动」选项。若该构建未提供对应入口,也可按 Win + R 打开
shell:startup,放入指向当前程序位置的快捷方式。两种方式选一种,避免重复启动。 - macOS 可在「系统设置」→「通用」→「登录项与扩展」中将位于「应用程序」的 v2rayN 加入登录时打开的列表;部分版本把这页称为「登录项」。如果移动过应用,应核对列表指向的是新位置。
- 注销再登录,确认客户端只启动一次,活动节点仍是预期条目,本地监听端口与系统代理设置一致。若开机时网络尚未就绪,等网络恢复后复测一次,再判断是自启失败还是连接建立得较晚。