Windows
Windows 用户可在桌面版与经典 WPF 版之间选择。桌面版采用新一代跨平台界面,WPF 版保留经典桌面操作方式。两者都应先核对系统要求,再按自己的使用习惯选择;不需要为了导入同一份订阅同时运行两个实例。
已有配置时,先备份订阅分组、路由与个人设置,再更换客户端。安装后检查本地监听端口和托盘中的系统代理状态,避免浏览器仍指向旧实例。系统代理只影响遵循该设置的应用;单独配置过代理的程序,需要在程序内部核对入口。出现端口占用时应先关闭旧实例,而不是连续改动多个端口。
围绕订阅管理、路由分流与系统代理,按平台选择客户端,再逐项完成配置。
CONFIGURATION LAYERS
图形客户端负责整理配置,内核负责处理连接。把订阅来源、流量入口和出站规则分开检查,比同时修改多处设置更容易定位问题。
订阅地址用于获取一组服务器配置,不等于单个服务器地址。在 v2rayN 中新建订阅分组,填写便于识别的备注,再粘贴完整地址并执行更新。不同来源分别建组,后续才能独立刷新、停用或排查。与逐条手工填写服务器参数相比,订阅更适合持续维护一批配置,但更新也可能移除来源已删除的条目。需要长期保留的手动配置应单独管理。遇到更新失败,先核对日志中的请求错误,再判断是否需要通过已有代理更新。
路由决定请求直连、代理还是阻断,DNS 决定域名如何解析,两者需要配合。可以先使用预设路由,再添加少量明确的域名规则。私有地址通常保留直连,避免局域网设备访问被带入远端出站。与只切换一个全局开关相比,规则分流能保留本地网络访问,也能为特定域名单独指定路径。规则常按顺序匹配,宽泛条件不宜放在精确条件之前;涉及 IP 匹配时,还要核对域名策略和解析结果,不能只看预设名称判断实际行为。
geosite:cn
配合可用的域名规则数据使用。
geoip:private
为私有地址选择直连出站。
应用先把请求交给本地入站,内核再依据路由选择出站。系统代理只是让遵循系统设置的应用找到这个入口,并不会自动接管所有程序。与直接修改整份配置文件相比,先在图形界面核对监听地址、端口和当前服务器,更容易发现入口不一致的问题。阅读 JSON 时,可以用 tag 对照 routing 中的引用,确认规则指向实际存在的出站。下方片段仅展示 Xray 的直连与阻断出站结构,不包含代理服务器参数,也不能独立作为完整配置运行。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{ "tag": "block", "protocol": "blackhole" }
]
}
directv2rayN 的图形界面与底层内核是不同层次。切换内核前,先确认当前配置使用的协议、传输方式和扩展字段,再核对目标内核能否识别。多内核入口的作用是适配不同配置需求,不代表某个内核在所有网络中都更快。与只比较内核名称相比,检查生成配置和启动日志更有判断依据。切换后应重新启动相关连接,再验证常用应用与 DNS 行为。已有自定义 JSON 不宜直接跨内核复制,Xray 与 sing-box 的字段结构需要分别理解。
CLIENT DOWNLOADS
桌面端选择 v2rayN;安卓端优先了解 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。安装包架构与配置协议是两件事,先选对设备架构,再检查订阅兼容性。
Windows 用户可在桌面版与经典 WPF 版之间选择。桌面版采用新一代跨平台界面,WPF 版保留经典桌面操作方式。两者都应先核对系统要求,再按自己的使用习惯选择;不需要为了导入同一份订阅同时运行两个实例。
已有配置时,先备份订阅分组、路由与个人设置,再更换客户端。安装后检查本地监听端口和托盘中的系统代理状态,避免浏览器仍指向旧实例。系统代理只影响遵循该设置的应用;单独配置过代理的程序,需要在程序内部核对入口。出现端口占用时应先关闭旧实例,而不是连续改动多个端口。
macOS 用户先在“关于本机”中确认芯片类型,再选择 Apple Silicon 或 Intel 安装包。把应用移入应用程序文件夹后再启动,方便后续管理。系统弹出安全提示时,应先确认文件来源和提示内容,再到“隐私与安全性”中处理对应的打开授权。
首次配置不要一次开启所有接管方式。先导入订阅、选择服务器,再设置系统代理并用浏览器验证。若浏览器可访问而其他应用失败,检查应用是否使用独立代理或忽略系统设置;若所有请求都失败,再查看内核日志和网络权限。退出客户端前清除不再使用的代理设置,可减少下次启动时入口状态不一致的问题。
安卓端优先选择使用 Xray 内核的 v2rayNG;需要使用 V2Fly 内核配置时,可了解 v2flyNG。主流较新设备通常选择 arm64,无法确认设备架构时再查看通用安装包。两款应用是独立客户端,安装其中一款不会自动共享另一款的订阅与路由设置。
导入配置后,首次连接需要确认系统的 VPN 授权。连接状态表示本地接管已建立,并不等于远端服务器一定可用。后台容易断连时,检查电池优化、后台运行和省电策略;按应用分流时,还要确认目标应用是否包含在接管范围内。不要让多个同类 VPN 连接同时争用系统入口,排查时先保留一个活动连接。
Linux 桌面用户按发行版的软件包体系选择 deb 或 rpm,再核对处理器是 x64 还是 arm64。包格式相同不代表所有发行版的依赖环境都相同,安装时仍应阅读包管理器给出的依赖提示。桌面快捷方式、托盘支持与系统代理入口,也可能随桌面环境而变化。
完成安装后,先手动启动并确认订阅更新和浏览器访问正常,再添加登录后自启动。图形桌面的系统代理通常不会自动传递给终端工具,终端或开发工具需要单独检查其代理设置。若窗口已打开但连接无法建立,优先查看内核是否启动成功、监听端口是否可用,以及配置目录是否具备正常读写权限,不要直接以提高运行权限代替排查。
FIRST CONFIGURATION
初次配置先建立一条可验证的连接,再增加自定义路由与其他接管方式。每次只修改一个环节,保留能够回退的设置。
STEP 01 / IMPORT
准备由配置提供方交付的完整订阅地址。在 v2rayN 的订阅分组设置中新增分组,填写备注与地址,保存后执行更新。若拿到的是单条分享链接,应使用对应的导入入口,不要把单条链接误填成订阅地址。安卓端在 v2rayNG 的订阅设置中完成同类操作,具体菜单名称以当前界面为准。
更新完成后,检查分组中是否出现预期的配置,再选择一个条目作为当前服务器。订阅只分发连接参数,并不附带服务器服务;免费客户端与订阅服务应分别理解。地址中可能包含访问凭据,不应贴到公开评论或截图中。若分组为空,先看更新日志,确认是请求失败、返回内容无法识别,还是来源本身没有可用条目。
STEP 02 / ROUTE
桌面端先选择适合当前网络的路由预设,再启用自动配置系统代理。路由预设控制进入内核后的请求如何出站,系统代理决定哪些应用把请求交给本地监听,两者不能互相替代。需要访问局域网设备时,应核对私有地址规则,避免把本地访问误送到代理出站。
初次配置可以先用遵循系统代理的浏览器验证,不必同时启用更多接管方式。安卓端则需要确认 VPN 授权,并检查按应用代理的范围。已有浏览器代理扩展、其他代理客户端或网络过滤工具时,应逐项检查是否发生入口冲突。暂时保留最少的活动配置,确认可用后再逐步恢复日常设置,比同时切换多个模式更容易找到差异。
STEP 03 / VERIFY
连接后先打开常用网页,再访问一个应当直连的站点或局域网服务,分别验证代理路径和直连路径。不要仅凭托盘图标、连接按钮或一次测试结果判断全部功能正常。若只有特定域名失败,查看该请求命中的路由、解析服务器与解析结果;若所有站点都失败,先回到系统代理、本地监听和内核启动状态。
记录能够复现问题的应用、域名和发生时间,再对照日志中的错误。排查顺序保持从入口到出站:应用设置、本地端口、当前服务器、路由、DNS。每完成一次修改就重复同一项测试,避免结果无法比较。结束使用时清除系统代理或关闭对应接管方式,再退出客户端;如果退出后网页打不开,首先检查系统是否仍保留指向本地的代理地址。
PROJECT V / CORE / CLIENT
客户端名称、内核名称和协议名称经常同时出现,但它们负责的事情不同。理解这三层关系,才能判断某项设置应在图形界面修改,还是需要查阅对应内核的配置说明。
Project V 是围绕代理通信与网络配置形成的开源项目生态,V2Ray 是其中广为使用的核心项目。V2Fly 延续相关社区维护,Xray 从这一技术谱系发展出独立的实现与扩展。它们具有部分共同概念,但支持能力、字段含义和更新节奏并不完全相同。看到一份标为 V2Ray 的教程时,仍需确认示例面向的具体内核,不能仅凭名称相近就直接套用。
VMess、VLESS、Trojan 属于连接协议层面的概念,传输方式与安全层又是另外的配置维度。协议被客户端列出,不代表任意字段组合都能工作;客户端是否能够导入、内核是否支持,以及服务端参数是否匹配,都需要分别满足。排查握手或配置加载错误时,保留原始参数含义比反复切换协议名称更重要。
v2rayN 面向桌面环境,提供订阅、服务器、路由和系统代理的图形管理入口,并支持对接 Xray、sing-box 等内核。v2rayNG 面向安卓设备,使用 Xray 内核处理连接;v2flyNG 同样面向安卓设备,提供基于 V2Fly 内核的另一种选择。三款客户端均为开源项目,但不是同一应用在不同设备上的简单改名,界面操作、导入支持和后台行为存在区别。
客户端负责把用户设置组织成内核能够理解的配置,内核负责协议处理、路由与实际连接。sing-box 有自身的配置结构,不应把 Xray JSON 原样当成它的配置使用。选择客户端时,先看操作系统与当前配置需求,再看界面和维护习惯。频繁更换客户端不能解决订阅源失效或服务端参数不一致的问题。
开源意味着项目代码按相应许可证公开,使用、修改与再分发仍需遵守各自的许可条件。客户端、内核及其依赖可能采用不同许可证,具体应阅读对应项目随附的许可文件。代码公开不意味着所有分发文件、订阅来源和网络环境都具有相同的可信度,也不意味着所有配置默认适合当前设备。使用者仍需了解安装来源与配置内容。
这三款客户端可免费使用,但运行客户端与取得远端服务是独立事项。订阅地址中可能含有账户标识,服务器配置也可能包含认证信息。分享排查日志前,应移除订阅地址中的敏感参数、认证字段和个人访问记录。文档中的配置片段只用于解释结构,不能替代由服务提供方交付的有效连接参数。
客户端与内核由各自社区持续维护,界面调整、协议支持和配置兼容性可能分别变化。更新前先阅读变更说明,备份订阅分组、自定义路由和必要的个人设置。更新后先确认客户端能正常启动,再验证内核加载、订阅更新、常用网页和局域网访问。不要把软件更新、订阅刷新与路由重写合并成一次操作,否则出现问题时很难区分原因。
当前配置稳定可用时,可以围绕实际需求安排更新,而不是只比较名称或发布时间。遇到教程中的菜单与界面不同,先按设置对象查找对应功能,再核对客户端与内核的文档。本站提供下载选择和中文配置说明,不提供订阅账户或远端服务器;连接可用性仍取决于本地网络、服务器状态以及双方参数是否一致。
CONFIGURATION NOTES
从具体症状进入文档。先确认请求经过哪个入口,再沿解析、规则和出站逐层检查,不把单个错误笼统归结为客户端问题。
讲解 V2Ray dns 模块的 servers、domains 与 expectIPs 写法,说明境内域名走本地解析、境外域名走远端解析的分流思路,以及防污染的实用配置。
重点区分“域名交给谁解析”与“连接经哪个出站发出”。域名规则、解析结果筛选和 IP 路由并非同一环节。修改前先记录当前解析路径,再用同一域名复测,避免仅更换解析服务器却没有改变实际请求路径。
阅读文章 →代理已开启但网页加载失败时,按系统代理状态、端口占用、节点可用性、时间同步、路由模式与 DNS 的顺序逐项核对,定位问题所在。
连接图标只能说明部分本地状态。文章从应用是否把请求交给客户端开始,逐步排除监听、远端连接与解析问题,并说明每一步应观察的结果。保留同一个测试目标,能更清楚地判断一次设置变更是否真正生效。
阅读文章 →逐段解读 V2Ray 配置 JSON:log、inbounds 本地监听、outbounds 出站与 freedom/blackhole、routing 规则匹配顺序,配合可对照的示例片段。
适合已经使用图形客户端、希望进一步理解生成配置的用户。先建立入站接收、路由匹配、出站处理的完整关系,再阅读具体字段。尤其注意 tag 引用与规则先后顺序,避免语法有效却没有命中预期出站。
阅读文章 →