只在 Windows 上使用、想沿用经典界面,先选 WPF 版;要在不同桌面系统之间保持相近的操作习惯,选跨平台桌面版的 Windows 包。首次安装和换包升级都按三个结果验收:主界面能打开、内核能监听本地端口、重新登录后只启动预期的那一份。
WPF 版与跨平台桌面版怎么选
WPF 与跨平台桌面版的差别首先在界面框架、发行包和运行依赖,不是代理协议的区别。VMess、VLESS 等配置能否使用,要看所选内核、内核版本和配置内容。遇到协议报错,先读内核日志,不要仅凭界面版本判断。
WPF 版
推荐采用 Windows 专用的 WPF 界面。已经习惯经典版布局时,优先选与系统架构匹配的 WPF 包;是否需要单独安装运行库,以该包的说明和实际启动提示为准。
适合:只在 Windows 上使用,或从旧版经典界面迁移。
跨平台桌面版
在多个桌面系统上提供相近的界面布局,但下载时仍然要选 Windows 对应的发行包。跨平台不等于同一个文件能在所有系统运行,也不意味着可直接混用旧版配置目录。
适合:经常在不同桌面系统间切换,或已经熟悉新版布局。
到 Windows「设置」→「系统」→「关于」查看「系统类型」。列出基于 x64 的处理器且操作系统为 64 位时选 x64;ARM 设备优先核对是否有对应版本的 ARM64 包。不要把 x64 和 ARM64 当成同一种“64 位”。
安装与解压:先固定程序目录
下载项如果标为安装程序,按安装界面执行;如果是压缩包,用资源管理器完整解压。不要在压缩包预览窗口里直接点主程序,也不要只把 v2rayN.exe 拖到桌面。主程序启动和内核启动依赖的文件并不完全相同,漏解压时可能出现“界面能开,选了节点却不通”。
固定位置
在资源管理器的地址栏输入
%LOCALAPPDATA%,把便携包完整解压到下面一个独立的程序目录,例如%LOCALAPPDATA%\Programs\v2rayN-WPF。不要把需要写入配置的便携包放在受保护的系统目录或同步盘里;桌面上只放快捷方式。检查旧进程
如果电脑上已有一份 v2rayN,先在旧版托盘菜单中清除由它设置的系统代理,再退出旧版。关闭窗口可能只是缩到托盘;必要时打开「任务管理器」→「详细信息」,确认旧的
v2rayN.exe已退出。启动主程序
在新目录内打开
v2rayN.exe,或从安装程序创建的入口启动。先确认界面可正常打开,再导入配置。若系统弹出运行库错误,记下完整的框架名、版本和架构,按下一节处理。核对本地端口
在主界面打开「设置」→「参数设置」,查看本地监听端口;部分版本把这一项放在「Core: 基础设置」。选择一条已有的可用配置后,先检查内核日志是否报端口冲突,再检查实际监听结果。
双击打不开:区分运行库缺失与安全拦截
如果错误框写着必须安装或更新 .NET,先看 Framework、Version 和 Architecture 三项。如果主程序能打开,但启用配置后才报某个内核文件找不到,则优先核对是否完整解压、下载包是否附带所需内核,以及该文件是否被隔离。两种情况不能用同一套处理步骤。
缺少 .NET 运行库
- 框架示例
Microsoft.WindowsDesktop.App对应 .NET Desktop Runtime- 版本示例
- 错误提示
8.0.0时,选对应的受支持8.0维护版本,不要假定更高主版本能替代 - 架构依据
- 按错误框的
Architecture项选,例如x64,不要只看操作系统位数
从微软官方渠道获取对应运行库。安装后重开程序;如果仍报错,重新读取提示,确认缺的是哪个框架。
下载后出现威胁提示
- 查看入口
- 「Windows 安全中心」→「病毒和威胁防护」→「保护历史记录」
- 核对项目
- 展开记录,查看检测名称、受影响的文件路径和处理状态
- 处理顺序
- 保持隔离,核实下载来源和对应发行包;来源不明或告警持续时,停止使用该文件
怀疑误报时,可向安全软件提供方提交判定;不要关闭实时保护或把整个程序目录加入排除项。
如果提示的是 Microsoft.NETCore.App,它对应 .NET Runtime;如果提示的是 Microsoft.WindowsDesktop.App,仅安装同版本的基础 .NET Runtime 不足。若没有错误框,也没有隔离记录,可打开「事件查看器」→「Windows 日志」→「应用程序」,按刚才的启动时间找 .NET Runtime 或 Application Error 记录。先记下异常模块和错误码,再决定是补依赖还是重新获取发行包。
界面能开但网页不通:分层检查端口
先确认内核有没有启动,再确认应用有没有把请求交给代理。下面用 127.0.0.1:10808 举例;实际端口以当前版本的设置和日志为准。如果界面分别列出 HTTP 与 SOCKS 端口,应用手动配置时要同时匹配协议和端口,不能只挑一个能连上的数字。
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
TcpTestSucceeded : False:本次 TCP 探测未连到该地址和端口。核对端口数字,回到内核日志检查配置加载失败或监听失败;暂时不用换订阅。TcpTestSucceeded : True:该地址和端口可以建立本地 TCP 连接,不代表远端已连通。若怀疑旧实例占用,拿OwningProcess到「任务管理器」→「详细信息」对照 PID,确认监听者是谁。- 确认是预期内核在监听后,再看托盘菜单的「系统代理」设置。使用系统代理的浏览器与设置了独立代理的应用不一定走同一路径。若退出后连平时直连的网站也打不开,检查 Windows「设置」→「网络和 Internet」→「代理」是否还指向已停止的本地端口;受单位管理的代理设置先向管理员确认。
如果本地端口和系统代理都正常,但只有特定访问失败,再进入无法连接诊断,按内核日志和访问症状继续排查。
开机自启、托盘窗口与升级常见问题
勾了开机自启,重启后为什么没弹窗口?
先到任务栏的隐藏图标区找 v2rayN,再到「任务管理器」→「详细信息」查进程。登录后出现托盘图标但没有主窗口,通常是最小化启动。若进程确实没有运行,在 v2rayN 的「设置」→「参数设置」中关闭并重新开启「开机自动启动」,保存后注销并重新登录测试。这里验证的是当前用户登录后的启动,不是未登录时作为系统服务运行。
换目录后,怎么登录时还启动旧版?
先在旧版关闭自启,再退出;然后在新版开启。若过去手动创建过启动快捷方式,按 Win + R 输入 shell:startup,查看快捷方式属性里的「目标」,只移除确认指向旧目录的那一项。重新登录后,从任务管理器右击进程并选择「打开文件所在的位置」,确认实际路径。
每次更新都要用管理员身份运行吗?
便携包的日常启动先用普通用户权限。如果提示拒绝写入,先检查实际程序目录和配置目录是否可写,再把便携包迁到当前用户目录。若是运行库或安装程序本身请求提升权限,按来源可靠的安装程序提示处理;不要为了绕过目录权限给主程序永久设置管理员启动。
升级后列表空了,是不是订阅过期?
先确认启动的是哪份程序。新目录里的界面为空,可能只是读取了另一份配置。先退出新版,从旧版确认列表与订阅分组是否仍在;有导出或备份功能时优先用它迁移,否则从可信来源重新导入。迁移后确认分组、当前选中的配置和本地端口,再清理旧目录。