Xray-core 是什么?Xray 内核与 V2Ray 的关系

先说结论

Xray-core 是 XTLS 项目的代理内核,从 v2fly-core 分叉而来,是 VLESS、REALITY、XHTTP 的原始实现。它只读 JSON 配置、不处理订阅,多数人通过 v2rayN、v2rayNG 这类客户端间接用到它。

Xray-corev26.3.27仍在更新

XTLS 项目的代理内核,VLESS、REALITY、XHTTP 等协议的原始实现。

类型
代理内核
内核
Xray(自身,从 v2fly-core 分叉而来)
支持系统
Windows、macOS、Linux、安卓、iPhone / iPad(有条件)、鸿蒙(有条件)、路由器
许可证
MPL-2.0
TUN 模式
支持
订阅与配置格式
JSON 配置文件
最新版本发布于
2026-03-27(核验时已发布 195 天)
版本核验时间
2026-10-09 09:07 UTC(来源:GitHub 官方接口)
项目状态依据
GitHub 仓库未归档,最新发布 v26.9.30(2026-09-30,标为 pre-release;Xray 近期版本多标为 pre-release),标 latest 的是 v26.3.27(2026-03-27)。

协议支持(以官方文档为准;↗ 表示客户端没有单列、随它内置的内核;没写的标“待核实”)

  • VMess:支持
  • VLESS:支持
  • Reality:支持
  • Trojan:支持
  • Shadowsocks:支持
  • SSR:资料待核实
  • Hysteria2:支持
  • TUIC:资料待核实
  • WireGuard:支持
  • AnyTLS:资料待核实

官方文档里写明的注意事项

  • REALITY 只能与 RAW、XHTTP、gRPC 这几种传输组合使用。
  • TUN 入站在 Android 和 iOS 上不能独立运行,需由外部应用传入 TUN FD。
  • Hysteria 协议本身没有认证;与非 hysteria 传输层搭配时无法代理 UDP,文档不推荐这样用。
这张卡片的资料来源(8 条,核验于 2026-10-09)
  1. README:Project X 起源于 XTLS 协议,提供 Xray-core 与 REALITY;许可证 MPL-2.0;Xray-core 1.0.0 由 v2fly-core 分叉;列出 OpenWrt、Asuswrt-Merlin、Windows、Android、iOS/macOS/tvOS、Linux、HarmonyOS 的图形客户端。(github.com)
  2. 官方文档出站协议列表:Shadowsocks、Trojan、VLESS、VMess、WireGuard、Hysteria 等;传输安全含 REALITY 与 TLS。(xtls.github.io)
  3. 官方文档 Hysteria 出站:settings 示例 version 为 2;协议本身无认证,非 hysteria 传输层下无法代理 UDP。(xtls.github.io)
  4. 官方文档 TUN 入站:支持 Windows、Linux、macOS、FreeBSD;Android 与 iOS 需外部应用传入 TUN FD,不能独立运行。(xtls.github.io)
  5. 官方文档 REALITY:只能与 RAW、XHTTP、gRPC 传输方式一起使用。(xtls.github.io)
  6. 发布页资产含 android、freebsd、linux(含 mips、arm 多种)、macos、windows 等;v26.9.30 于 2026-09-30。(github.com)
  7. GitHub API 显示 releases/latest 为 v26.3.27(2026-03-27),v26.9.30 为 pre-release。(api.github.com)
  8. GitHub API 显示仓库 archived=false,许可证 MPL-2.0。(api.github.com)

Xray-core 是个没有窗口的程序:它读取一份 JSON 配置,按配置里的入站、出站和路由,把流量转发给节点。v2rayN、v2rayNG 这类图形客户端里,往往就藏着它。这一页讲它和 V2Ray 的渊源,说明哪些客户端会调用它,xray下载与 xray github 发布页怎么读,以及为什么多数人不必单独安装。

Xray-core 是什么:只有命令行和 JSON 的代理内核

按 README 的自述,Project X 起源于 XTLS 协议,提供 Xray-core 与 REALITY。档案卡里把它概括为 VLESS、REALITY、XHTTP 这几个协议的原始实现。它是内核,只管转发,不管订阅:内核读取的是 JSON 配置,订阅的拉取与更新由图形客户端负责。

搜索时会碰到几个相近的叫法:

叫法 指什么
Xray-core 内核程序本身,仓库在 XTLS 组织名下
Xray 日常简称,多数时候指同一个内核
Project X 项目名,档案里登记的别名
XTLS GitHub 组织名,也是 README 自述的项目起源

内核、客户端、订阅三层怎么分,可以先读 代理内核 这一条词典,再读 Xray 内核词条。

和 V2Ray 的渊源:从 v2fly-core 分叉出来的另一条线

README 写明,Xray-core 是从 v2fly-core 分叉而来。分叉之后,两条线各自有文档站:

想查什么 去哪里 说明
Xray 这一线的配置与协议 Xray 官方文档 出站、入站、传输方式都在这里
V2Fly 这一线的配置与协议 V2Fly 文档 旧教程里“V2Ray 配置”多半指这一线
两者的整体关系 V2Ray 是什么 梯子岛站内的梳理页

读旧教程时,先看清它讲的是哪条线。两边的配置字段是否完全通用,梯子岛没有逐项核对,所以只能说:以你所用内核的文档为准。VLESS 这个协议本身的来龙去脉,见 VLESS 协议是什么。

哪些客户端会调用它,普通用户为什么通常不用单独装

档案里确认的有两个:

  • v2rayN:内核可选 Xray 与 sing-box 等,发布包里已内置。
  • v2rayNG:内核是 Xray-core,另支持 v2fly core。

README 的图形客户端清单还覆盖 OpenWrt、Asuswrt-Merlin、Windows、Android、苹果系统和 HarmonyOS 等平台,具体名单以 README 为准,梯子岛这里不逐个转述。

单独用内核和通过客户端用,差别主要在谁来干活:

做法 谁处理订阅和更新 你要自己做的事
通过图形客户端 客户端 导入订阅、选节点、开关连接
单独运行内核 没人,内核不处理订阅 自己写 JSON、自己更新、自己看日志排错

所以对多数人来说,选对客户端,比单独研究内核更划算。

xray下载与 xray github:发布页怎么读

官方入口有三个:GitHub 仓库、发布页 和 文档站。梯子岛的 GitHub 仓库导航 把多款客户端和内核的官方仓库放在了一起。

读发布页时,按这几步来:

  1. 资产按系统命名,覆盖安卓、FreeBSD、Linux、macOS、Windows,Linux 一侧还分 mips、arm 等多种架构。选与你设备对应的那一个。
  2. Latest 标记的是稳定版。按档案核对,Xray 近期的版本不少标着 pre-release,被标 Latest 的反而更早一些。
  3. 想用预发布,先读它的更新说明,弄清改了什么。
  4. 苹果系统上内核不能独立运行,只能嵌入第三方应用使用,所以别在发布页里找 iPhone 的安装包。

配置时容易踩的几处边界

边界 官方文档怎么说 对你意味着什么
REALITY 的传输方式 只能与 RAW、XHTTP、gRPC 这几种传输组合使用 配 Reality 节点时传输方式超出这个范围,就脱离了文档,参考 传输方式有哪些
TUN 入站 写明支持 Windows、Linux、macOS、FreeBSD;安卓和苹果系统不能独立运行,需外部应用传入 TUN FD 手机上的整机代理由客户端应用提供,不是内核自己能做
Hysteria 出站 示例版本填 2;与非 hysteria 传输层搭配时无法代理 UDP,不推荐这样用 用 Hysteria2 节点就按文档的组合来,协议背景见 Hysteria2 协议是什么
TUIC、AnyTLS、ShadowsocksR 出站协议列表里没有 文档没有明说“不支持”,梯子岛标为资料待核实

Reality 本身的原理,见 Reality 协议是什么。

手里这份 Xray 内核,来源怎么核对

  1. 看网址:github.com,组织名 XTLS,仓库名 Xray-core。
  2. 看状态:仓库页面没有归档提示,近期仍有发布。
  3. 看资产名:系统和架构要与设备对应。
  4. 看客户端里的内核信息:各客户端放内核信息的位置不同,找到后确认写的是 Xray,而不是别的名字。
  5. 别信“整合内核”:群文件、网盘和论坛附件里打包好的内核,都不算官方来源,风险见 修改版客户端的风险。

谁需要直接接触 Xray 内核

你的情况 要不要单独接触 接着看
在电脑上日常使用 不用,装客户端即可 v2rayN 是什么
在安卓手机上使用 不用,装客户端即可 v2rayNG 是什么
想读懂客户端的报错和配置字段 读文档就够,不必安装 Xray 官方文档
在没有图形界面的 Linux 上做客户端侧代理 可以考虑命令行运行 Linux 梯子怎么用
想在路由器上用 先看路由器插件的取舍 路由器翻墙的取舍
在 Mihomo 与 Xray 之间犹豫 先看两种内核的取舍 Mihomo 与 Xray-core 对比

下一步:先选客户端,再回头读内核文档

  1. 在电脑或手机上日常用,就从 客户端选择工具 筛一款,内核交给它。
  2. 想弄懂 VLESS、Reality 这些名词,读 VLESS 协议是什么 与 协议矩阵,看哪些客户端支持。
  3. 想自己调配置,先对照官方文档,再回到 节点链接怎么读 弄清每个字段。
  4. 还没有订阅:到 机场导航 对照资料自己挑,梯子岛不替你决定买哪家。

这篇没有覆盖的

  • 梯子岛没有 Xray 与其他内核在速度、资源占用上的对比数据,不替你判断谁更合适。
  • TUIC、AnyTLS、ShadowsocksR 官方文档没有列出,是否支持资料待核实,不代表一定不支持。
  • 鸿蒙上只确认到 README 列有对应客户端,好不好用没有核实,本文不下结论。
  • 具体配置字段请查官方文档,这一页不附可以整段照抄的配置样例。

本文引用的官方来源

  1. Xray-core(github.com)
  2. Xray-core 官方下载入口(github.com)
  3. Xray-core 官方文档(xtls.github.io)
  4. V2Fly(V2Ray)文档(www.v2fly.org)

以上链接均为官方页面,梯子岛在 2026-10-10 核对过;个别网站会拦截自动化访问,用浏览器直接打开即可。平台规则可能随时调整,以官方页面当前内容为准。

Xray-core常见问题

Xray 和 V2Ray 是同一个东西吗?

不是同一个。Xray-core 的 README 写明它从 v2fly-core 分叉而来,之后两条线各自维护,各有自己的文档站。旧教程里说的 V2Ray 配置,要先弄清指的是哪一条线,字段是否通用,以你所用内核的文档为准。

装了 v2rayN 还要另外装 Xray 吗?

一般不用。Wiki 的发布文件介绍写明 v2rayN 的发布包里已经内置了 Xray、sing-box 和 mihomo。除非你想单独在命令行里运行内核,或者需要替换内置内核,否则客户端装好之后,内核也就随之到位了。

Xray 支持 Hysteria2 吗?

官方出站文档里有 Hysteria 出站,示例的版本填的是 2。文档同时提醒,与非 hysteria 传输层搭配时无法代理 UDP,不推荐这样用。具体怎么配,以官方出站文档为准,别拿其他协议的配置思路硬套。

手机和路由器上能直接用 Xray 吗?

要看平台。TUN 入站文档写明安卓和苹果系统不能独立运行,需要外部应用传入 TUN FD,所以手机上是通过客户端应用间接使用。路由器方面,README 列出了 OpenWrt、Asuswrt-Merlin 的图形客户端。

xray下载该选发布页里的哪个文件?

发布页的资产按系统和 CPU 架构命名,覆盖安卓、FreeBSD、Linux、macOS、Windows 等。选与你设备对应的那个,对不上就回发布页重选。Latest 标记的是稳定版,近期的新版本不少标着预发布。

Xray 能直接读订阅链接吗?

不能。内核读取的是 JSON 配置,订阅的拉取和更新由图形客户端负责。所以拿到订阅链接后,应该把它交给 v2rayN、v2rayNG 这类客户端,而不是塞给内核本身。

接着读

文中出现的术语

相关专题

接下来去哪儿?

找官方入口去网址导航,想核对仓库和版本看GitHub 项目导航;需要现成的机场,机场目录收了 28 家的价格与线路资料,性价比机场、便宜机场、VPN 机场分别有专项页。