Windows
v2rayN / Desktop · WPF
桌面版采用跨平台界面,WPF 版保留经典桌面操作方式。下载前先看清包的类型,不要把两个入口理解为两套不同协议。已经有配置的用户,迁移前应保留订阅分组、路由设置与本地监听端口记录。
首次使用可先导入一条配置,选择活动服务器,再设置系统代理。若浏览器能连接而其他程序不能,先检查程序是否读取系统代理,而不是连续更换服务器。两版界面细节可能不同,操作时以当前菜单名称为准。
前往下载 Windows 客户端01 / CLIENT SHELF
先确认操作系统和处理器架构,再选择安装包。桌面端使用 v2rayN;Android 优先查看 v2rayNG,需要 V2Fly 内核时再比较 v2flyNG。安装包选择与连接参数是两项独立检查,装好客户端之后仍需导入可用配置。
v2rayN / Desktop · WPF
桌面版采用跨平台界面,WPF 版保留经典桌面操作方式。下载前先看清包的类型,不要把两个入口理解为两套不同协议。已经有配置的用户,迁移前应保留订阅分组、路由设置与本地监听端口记录。
首次使用可先导入一条配置,选择活动服务器,再设置系统代理。若浏览器能连接而其他程序不能,先检查程序是否读取系统代理,而不是连续更换服务器。两版界面细节可能不同,操作时以当前菜单名称为准。
前往下载 Windows 客户端v2rayN / Apple Silicon · Intel
在系统的“关于本机”中查看芯片信息。Apple Silicon 与 Intel 对应不同安装包,不能只按文件扩展名判断。将应用放入应用程序目录后,再处理系统给出的打开确认与网络权限提示,避免从临时位置反复启动。
系统代理与流量接管权限分别检查。若升级后出现连接行为变化,先看客户端是否启动内核,再看系统代理是否指向当前监听端口。需要处理开发者提示时,按系统设置中的安全提示操作,不建议为了启动应用而整体关闭系统安全机制。
前往下载 macOS 客户端v2rayNG / v2flyNG
v2rayNG 以 Xray 内核为主要使用方向,v2flyNG 提供 V2Fly 内核选项。两款应用的名称相近,但协议字段支持范围不能直接等同。选择前先确认配置是否包含 REALITY、特定传输方式或其他内核相关参数。
按设备架构选择 arm64 或通用包,安装后导入订阅,并确认系统 VPN 授权。这里的 VPN 授权用于应用接管设备流量,不代表客户端附带远端服务。若应用切到后台后连接中断,再检查电池优化、后台活动限制与其他 VPN 类应用是否冲突。
前往下载 Android 客户端v2rayN / deb · rpm
先看发行版的软件包体系,再区分 x64 与 arm64。deb 与 rpm 是安装包格式,不是连接协议;选择错误通常发生在安装阶段,而不是路由阶段。图形会话下的代理设置还可能受桌面环境影响,不能假定所有应用都会自动继承。
安装后确认本地监听端口与内核运行状态,再配置浏览器或桌面系统代理。终端程序可能需要单独设置代理参数。若只有某个程序失败,应先核对该程序的代理入口;需要更广的流量接管范围时,再评估当前客户端的 TUN 能力与权限要求。
前往下载 Linux 客户端02 / CONFIG INSPECTOR
客户端负责整理界面设置,内核负责执行连接与分流。下面将两层设置分开说明:订阅分组属于客户端管理数据;入站、出站、路由和 DNS 才是内核配置中的常见部分。代码均为局部示例,不应直接覆盖整份运行配置。
订阅用于批量获取连接配置,分组用于在客户端中区分来源。先建立分组,再填入订阅地址并更新,确认返回内容能被当前客户端解析。更新后检查节点名称、协议与传输字段,不要只看列表是否出现条目。分组名与自动更新间隔属于客户端设置,并不是通用内核字段。下方仅展示导入后可能生成的出站结构;示例不含远端凭据,不能据此建立代理连接。需要整理多个来源时,再设置过滤条件并保留原始分组。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{ "tag": "block", "protocol": "blackhole" }
]
}
路由按规则顺序决定流量使用哪个出站,通常先匹配的规则先执行。先处理私有地址,再添加明确的域名或地址规则,最后确认未命中流量的默认去向。规则中的出站标签必须与出站列表完全一致,否则规则看似存在也无法按预期工作。下方示例将私有地址交给直连出站,需要对应的地理数据文件。与只切换全局模式相比,规则分流可以保留局域网访问路径,但也需要检查域名解析时机和规则覆盖范围。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
内核选择应由连接参数决定,而不是只按客户端名称判断。先看协议、传输方式与安全层,再确认当前内核是否支持这些字段。涉及特定扩展时,不能假定另一内核可以直接读取同一配置。切换前保留现有设置,切换后查看启动日志和生成配置,确认实际运行的内核。下方日志级别可用于初步排查;临时提高详细程度后应及时恢复。运行日志可能包含地址与连接信息,分享之前需要移除敏感内容。
{
"log": {
"loglevel": "warning"
}
}
系统代理只影响愿意读取系统代理设置的应用,不能等同于全部流量接管。先使用本地代理入站验证连接,再评估是否需要 TUN。TUN 能力取决于客户端、配套组件、内核与系统权限,并不是给任意配置加一个开关即可获得。下方展示只监听本机的 SOCKS 入站,可供应用显式填写代理地址;它不是 TUN 配置。切换模式时留意其他代理软件、虚拟网卡与 DNS 设置,避免同时接管导致流量循环。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": true }
}
]
}
DNS 设置需要结合应用、系统和内核三个层面检查。客户端里填写了解析器,并不表示所有应用查询都会进入内核。先确认域名在哪里解析,再看解析器的访问路径是否依赖尚未建立的代理连接。下方展示通过本机环境解析的基础写法,适合解释字段位置,并不代表适用于所有网络。若地址访问正常而域名访问失败,应先对照解析结果与路由策略,避免只更换解析器却遗漏查询流量没有进入内核的问题。
{
"dns": {
"servers": ["localhost"]
},
"routing": {
"domainStrategy": "AsIs"
}
}
局域网共享需要监听地址、系统防火墙和其他设备代理设置同时正确。只监听回环地址时,其他设备无法连接;开放到全部接口后,还需要限制可访问的来源。下方为带认证的 HTTP 入站局部示例,凭据为教学假值,使用前必须更换。其他设备应填写电脑的局域网地址,而不是回环地址。共享仅适合受信任网络,不要将代理端口映射到公网;离开共享场景后,应关闭监听或恢复仅本机访问。
{
"inbounds": [
{
"tag": "lan-http",
"listen": "0.0.0.0",
"port": 10809,
"protocol": "http",
"settings": {
"accounts": [
{ "user": "example-user", "pass": "your-password" }
]
}
}
]
}
03 / OPEN-SOURCE ECOSYSTEM
客户端、内核、协议与远端服务是不同层次。理解这些边界,可以解释为什么相同订阅在不同应用中表现不同,也能减少把权限问题、解析问题和服务端参数混在一起排查的情况。
ORIGIN / PROJECT V
Project V 是理解 V2Ray 生态的起点。V2Ray 围绕入站、出站、传输、路由与域名解析组织代理能力,配置文件把这些模块连接起来。日常搜索中的“V2Ray 客户端”通常指负责管理这些能力的图形应用,并不总是指某一个固定内核。下载客户端之前,先分清正在选择的是管理界面,还是执行连接的程序。
V2Fly 延续了 V2Ray 的社区开发路线;Xray 则形成了另一条内核分支,并发展了自己的协议与传输扩展。两者具有共同背景,一些基础配置概念也相似,但不能据此认为所有字段都兼容。对照说明时,除了看字段名,还要看示例对应哪个内核,以及客户端实际调用的内核是否与说明一致。
CLIENT / THREE APPLICATIONS
v2rayN 面向桌面系统,承担订阅管理、服务器选择、路由编辑与本地代理设置等工作。跨平台界面让桌面用户可以沿用相近的操作思路,但操作系统权限、安装方式与系统代理机制仍有差别。迁移设备时,应先转移必要配置,再检查监听端口与接管模式,不要直接套用另一台机器的全部环境设置。
v2rayNG 与 v2flyNG 面向 Android,分别对应 Xray 与 V2Fly 的常见使用方向。它们都是开源客户端,主要差别应从内核能力、可识别字段和应用设置中判断。订阅地址可导入并不代表每条连接都可运行;解析成功之后,还需要检查协议、安全层、传输参数与系统授权。桌面和手机共享同一来源时,也应分别完成验证。
LICENSE / SOURCE CODE
V2Fly 内核采用 MIT 协议,Xray-core 采用 MPL-2.0 协议;客户端、内核与附带组件各自适用的许可应分别阅读。开源说明代码使用与分发的条件,不等于远端服务的资费说明,也不代表所有网络环境都具有相同表现。客户端可免费使用,连接所需的服务器与订阅则由用户自行准备。
开源生态的价值在于实现方式可以被讨论、检查与改进,问题也能围绕具体模块定位。不过,代码公开不能代替使用者对配置来源、网络权限与数据处理路径的判断。导入配置前,应了解服务器由谁提供;分享故障信息时,应移除订阅地址、身份标识与认证参数,只保留复现问题所需的字段结构。
UPDATE / COMPATIBILITY
客户端更新、内核更新和订阅更新分别改变不同内容。客户端更新可能调整界面、配置生成方式或系统集成;内核更新可能改变协议支持与字段处理;订阅更新主要替换远端连接信息。因此,出现变化时先记录改动发生在哪一层,再决定回看日志、恢复设置还是重新导入订阅,避免同时执行多项操作后失去判断依据。
升级前保留可恢复的客户端配置与自定义规则,升级后先测试原来可用的一条连接。基础访问正常之后,再检查分流、域名解析和局域网共享。不要只以界面显示“运行中”作为验证结果:内核启动成功只说明进程已经工作,实际请求是否走向预期出站,还需要结合应用代理设置与日志中的路由结果判断。
READING / CONFIGURATION PATH
04 / FIELD NOTES
按操作场景补充说明。修改前先定位当前问题属于监听、权限、配置生成还是远端连接,再进入对应文章。文章中的局部示例用于解释设置关系,实际参数仍需与使用环境一致。
开启允许局域网连接后,确认监听地址与端口、放行系统防火墙,再在其他设备上填写 HTTP 或 SOCKS 代理,完成同网段共享。
阅读局域网共享设置 →教你读懂内核启动日志里的报错行,逐类定位 JSON 语法错误、端口占用、未知协议字段与 geo 文件缺失等常见原因。
阅读内核启动排查 →同时导入多个订阅时,如何按来源建立分组、用关键字过滤节点、设置自动更新间隔,让节点列表保持清爽可控。
阅读订阅分组方法 →