Windows
桌面版采用跨平台界面，WPF 版保留经典桌面操作方式。先按使用习惯选择界面，再查看安装要求。已有配置的用户应先备份订阅分组、自定义路由与本地端口，不宜把整个程序目录直接覆盖到另一种界面版本。
首次启动后，先检查设置中的本地监听端口，再决定是否启用系统代理。程序可以正常打开，并不代表内核已经启动；遇到运行环境提示，应按安装页说明补齐所需组件，再处理节点导入。
V2Ray 客户端 · 配置参考
V2Ray百科v2rayN 客户端下载与配置文件参考
按系统选择开源客户端，从订阅导入到 config.json 字段参考，逐项核对本地端口、出站协议与分流规则。
配置工作台为字段节选示意。省略认证、服务端端口及直连出站定义，不能直接作为完整配置运行。
Project V / 开源代理生态
Xray · V2Fly / 内核家族
JSON / 配置结构
4 / 桌面与移动平台
CONFIGURATION / 字段索引
从配置结构定位设置项
客户端界面负责生成配置，内核按配置处理连接。先分清流量进入、选择出站和解析域名的边界，再修改对应字段；不必把所有参数同时展开。
{
"inbounds": [{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}]
}入站地址与本地端口
入站定义应用如何把连接交给内核。仅供本机使用时，监听地址通常设置为回环地址；端口则要与浏览器或调用程序一致。示例使用 SOCKS 入站，不能把该端口直接当作 HTTP 代理端口。遇到启动失败，应先检查端口占用，再确认客户端有没有生成同名入站。与只看系统代理开关相比，检查入站能区分“应用没有发送流量”和“内核没有成功监听”两类问题。修改监听范围前，还应明确哪些设备可以访问该入口。
在配置参考中查看 →{
"outbounds": [{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}]
}协议参数与传输层分开核对
出站定义连接离开内核的方式。代理出站需要服务端地址、端口和认证信息，直连出站则可以使用 freedom。VLESS 等协议名称并不能完整描述一个节点，还要核对传输方式以及 TLS 或 REALITY 相关参数。路由通过 tag 引用出站，因此名称必须逐字对应。与重复导入节点相比，按协议、传输、安全层逐项核对，更容易发现字段缺失。示例只展示直连出站，实际使用代理协议时应以服务端给出的参数和所选内核支持范围为准。
在配置参考中查看 →{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}]
}
}按顺序匹配域名与地址
路由规则自上而下匹配，命中后选择对应出站。应把明确的例外放在较宽泛规则之前，并确认 outboundTag 已在出站中定义。domainStrategy 决定路由匹配过程中何时尝试解析域名，不等于系统的 DNS 设置。示例把私有地址交给 direct，使用地理数据规则前还需确认相应数据文件可用。与直接切换全局模式相比，明确规则可以保留局域网访问，并为特定域名单独指定路径。排查时先缩小规则数量，再逐条恢复。
在配置参考中查看 →{
"dns": {
"servers": ["localhost"]
}
}区分系统解析与内核解析
DNS 配置影响内核需要解析域名时使用的解析器，但并不自动接管设备中每个应用的查询。示例中的 localhost 表示使用本机解析机制，不是手动填写一个公共解析地址。配置前应区分应用自行解析、系统解析和内核解析三条路径，再结合路由策略判断实际发生在哪一层。与仅更换解析器地址相比，检查解析请求的去向更有助于定位问题。若客户端提供 DNS 路由或查询策略选项，还需核对该设置在当前内核中的具体含义。
在配置参考中查看 →客户端订阅分组
备注 日常配置
自动更新 按需启用
更新后 检查所选节点
导出前 移除订阅地址与认证信息订阅属于客户端管理层
订阅地址由客户端读取，用于批量更新节点，不是 config.json 的通用顶层字段。导入时可按用途建立分组，并保留清晰备注。更新后应确认原来选择的节点是否仍然存在，手工改动的参数是否被重新生成。与逐个复制分享链接相比，订阅便于集中维护；但不同客户端对订阅格式和扩展参数的支持可能不同。分享截图、配置或排错日志前，应先移除订阅地址及认证内容。需要迁移设备时，优先区分节点信息与本机专属设置。
在配置参考中查看 →DOWNLOADS / 平台入口
客户端安装包按系统选择
桌面端使用 v2rayN；安卓端优先查看 v2rayNG，需要 V2Fly 内核时再比较 v2flyNG。安装入口与配置文档分开组织，便于先确定系统架构，再回到教程完成设置。
macOS
在“关于本机”中查看芯片信息，选择对应架构的安装入口。系统代理设置与客户端路由属于不同层次：前者决定应用是否把连接交给客户端，后者决定接收连接后使用哪个出站。
初次运行时留意系统弹窗说明，不要为了排错同时改动多项权限。若浏览器可以访问而其他应用仍按原路径连接，应检查该应用是否遵循系统代理，或是否配置了独立的网络选项。
Android
先查看 v2rayNG 的 arm64 与通用版入口；不确定设备架构时，再结合系统信息选择。v2flyNG 是另一内核家族的备选，是否适合现有节点，应根据协议与扩展参数判断，而不是仅比较应用名称。
连接时需要确认系统的 VPN 连接授权。应用分流、后台运行限制和电池管理都可能改变使用结果；前台可以连接但锁屏后中断时，应先检查系统对后台活动的限制，避免反复重新导入同一订阅。
Linux
根据发行版的软件包体系选择 deb 或 rpm，再区分 x64 与 arm64。桌面环境的系统代理支持程度可能不同，安装成功后应分别检查内核运行状态、桌面代理设置，以及目标应用自身的网络配置。
本地端口冲突、权限不足与依赖缺失是不同问题，应根据日志中的具体错误分别处理。图形客户端与其他代理程序同时运行时，先确认谁在监听目标端口，避免把另一程序的响应误认为当前配置已经生效。
QUICKSTART / 操作顺序
从订阅导入到连接验证
首次设置只建立一条能够解释的连接路径。先完成导入，再选择接管方式，最后验证结果。每次只改一个变量，通常比同时打开多个高级选项更容易找到问题。
01 / 导入
建立分组并导入节点
在客户端的订阅管理入口添加订阅地址，为分组填写可辨认的备注，然后执行更新。已有单个分享链接时，可使用剪贴板导入或二维码导入。两种方式的管理范围不同：订阅更新会重新获取分组内容，单个分享链接通常只生成一个本地条目。
导入完成后先打开节点编辑页，核对协议、服务端地址、端口与传输设置。订阅名称不是连接参数，节点显示名称也不能证明参数完整。若提示无法识别格式，先确认复制内容是否包含多余空格、说明文字或网页地址，再判断客户端是否支持该格式。
订阅地址可能包含访问凭据，不应贴到公开截图或讨论区。需要排错时，可以只记录协议类型和错误提示，认证内容保持私有。更新失败与节点连接失败属于两个阶段，前者应先检查订阅获取过程，而不是修改出站协议。
02 / 接管
选择系统代理与路由模式
选择一个节点后，再设置流量进入客户端的方式。桌面端可以先从系统代理开始，安卓端按界面提示确认 VPN 连接授权。系统代理只影响遵循该设置的应用；路由模式则作用于已经进入内核的连接，二者不能相互替代。
初次使用优先保留客户端提供的基础路由方案，确认局域网资源仍然可用，再添加特定域名规则。不要为了让一个应用生效而立即开放局域网监听，也不要把所有分流异常都归因于节点。先检查应用有没有把请求交给客户端，排查范围会更明确。
如需改动本地端口，应同步调整使用该端口的应用设置。HTTP 与 SOCKS 是不同的代理接口，即使监听地址相同，也不能随意互换。客户端提供混合端口时，应以该选项的实际说明为准，避免照抄其他设备上的端口号。
03 / 验证
分层检查日志与应用行为
启动连接后，先查看内核是否正常运行，再用目标应用发起请求。节点测试结果只反映特定测试方式，不能替代真实应用验证。应把“内核启动成功”“应用请求进入”“规则命中预期出站”“远端连接完成”分开判断。
若出现证书相关错误，检查系统时间、服务端名称与传输安全参数；若提示地址已被使用，则回到本地端口设置。排错时保留原有参数的备份，记录本次修改和对应现象。这样恢复设置时有明确依据，不会在连续尝试中丢失原始配置。
确认连接行为后，再考虑自动更新、开机启动或应用分流。切换网络、重启设备与锁屏恢复后，可以重复相同验证步骤。遇到只在某个应用发生的问题，优先检查应用自身的解析和代理设置，再决定是否需要修改全局配置。
PROJECT V / 内核与客户端
开源生态与配置边界
V2Ray、V2Fly、Xray 与图形客户端并非同一层的软件。区分这些名称，有助于判断一项功能由谁提供、一个报错来自哪里，以及迁移配置时需要保留哪些内容。
Project V 与内核家族
Project V 是围绕网络代理组件形成的开源生态，V2Ray 是其中广为使用的核心实现。V2Fly 延续 V2Ray 的社区开发，Xray 则从相关代码基础上发展出自己的内核路线。两者共享部分配置概念，但协议扩展、字段支持和默认行为会随各自演进出现差别。把它们统称为同一种内核，容易在导入配置或核对文档时忽略适用范围。
内核负责协议处理、传输建立、路由匹配和解析等工作；图形客户端负责把这些能力组织成节点列表、订阅分组和设置界面。界面中存在某个选项，不代表所有可选内核都以同样方式解释它。排查兼容问题时，应先记下当前客户端与正在使用的内核，再查对应字段说明，而不是只凭分享链接的开头判断整套配置。
三款客户端的职责
v2rayN 是面向桌面系统的开源图形客户端，提供节点导入、订阅更新、路由管理与系统代理操作。它让常见设置可以通过界面维护，同时也保留自定义配置的使用空间。切换内核或更改节点类型后，应重新核对生成的传输与安全层参数；保存了节点条目，并不等于远端具备相应功能。
v2rayNG 是面向安卓设备、使用 Xray 内核的开源客户端；v2flyNG 采用 V2Fly 内核，是另一条兼容路线的备选。两款应用的界面操作可能相近，但不能据此假定全部扩展字段都可互换。选择时先看现有配置要求，再看订阅格式、应用分流和后台运行体验。桌面与手机共用订阅时，本地监听和系统接管设置仍应分别维护。
开源许可与功能判断
V2Fly 内核采用 MIT 许可，Xray 内核采用 MPL 2.0；客户端及其依赖也各自受对应许可约束。开源意味着可以在许可范围内阅读、使用和修改代码，并不表示所有组件的发布节奏一致。许可说明用于理解软件的使用与分发条件，不能替代对具体功能、运行环境和配置内容的检查。
客户端提供的是连接工具，不会自动产生可用的远端服务。服务端地址、认证信息与相关参数需要由使用者自行准备。首页展示的示例地址仅用于解释字段，路由片段也只表达匹配逻辑。将示例用于学习时，应先辨认哪些是结构说明，哪些必须替换为已有服务的参数，避免把演示配置当成完整节点。
更新与配置维护
客户端界面、内核和路由数据文件可以独立变化。更新客户端后，某些字段可能被重新生成；更新规则数据后，同一个分类名称包含的域名或地址也可能发生调整。因此，应分别记录配置来源与自定义内容，重要规则保留可读备注。出现行为变化时，先对比生成配置和日志，再决定是否回退某项设置。
订阅适合集中更新远端参数，备份则应覆盖本机设置。二者不能互相替代：订阅不一定包含系统代理偏好、应用分流列表或手工路由规则。跨设备迁移时，把可复用的节点信息与设备专属的监听、权限、启动设置分开整理。本站配置参考按字段组织内容，教程按操作顺序展开，可根据当前问题选择阅读入口。
NOTES / 使用心得
配置操作与问题排查
从首次安装、规则优先级到证书报错，按具体问题查阅。文章中的参数说明与配置参考相互补充，修改前先确认所用内核与客户端设置范围。
V2Ray TLS 握手失败与证书报错排查：系统时间偏差、SNI 与 allowInsecure 设置
归纳 TLS 证书报错的常见原因，包括系统时间不同步、SNI 与证书域名不一致、伪装域名填写错误，并逐项给出客户端中的检查位置。
阅读文章 →V2Ray 自定义路由规则写法：domain、ip、geosite 匹配语法与规则匹配顺序
逐条讲解 domain、full、regexp、geosite、geoip 等匹配前缀的写法，说明 routing 规则自上而下的匹配顺序和 domainStrategy 对匹配结果的影响。
阅读文章 →v2rayN 首次安装后怎么设置：Windows 与 macOS 初始配置要点及常见问题
介绍 v2rayN 解压运行、系统代理模式、本地端口、开机自启等首次设置项，并说明运行库缺失、端口占用、权限弹窗等常见问题的处理方法。
阅读文章 →