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)
- 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)
- 官方文档出站协议列表:Shadowsocks、Trojan、VLESS、VMess、WireGuard、Hysteria 等;传输安全含 REALITY 与 TLS。(xtls.github.io)
- 官方文档 Hysteria 出站:settings 示例 version 为 2;协议本身无认证,非 hysteria 传输层下无法代理 UDP。(xtls.github.io)
- 官方文档 TUN 入站:支持 Windows、Linux、macOS、FreeBSD;Android 与 iOS 需外部应用传入 TUN FD,不能独立运行。(xtls.github.io)
- 官方文档 REALITY:只能与 RAW、XHTTP、gRPC 传输方式一起使用。(xtls.github.io)
- 发布页资产含 android、freebsd、linux(含 mips、arm 多种)、macos、windows 等;v26.9.30 于 2026-09-30。(github.com)
- GitHub API 显示 releases/latest 为 v26.3.27(2026-03-27),v26.9.30 为 pre-release。(api.github.com)
- 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 协议是什么。
哪些客户端会调用它,普通用户为什么通常不用单独装
档案里确认的有两个:
README 的图形客户端清单还覆盖 OpenWrt、Asuswrt-Merlin、Windows、Android、苹果系统和 HarmonyOS 等平台,具体名单以 README 为准,梯子岛这里不逐个转述。
单独用内核和通过客户端用,差别主要在谁来干活:
| 做法 | 谁处理订阅和更新 | 你要自己做的事 |
|---|---|---|
| 通过图形客户端 | 客户端 | 导入订阅、选节点、开关连接 |
| 单独运行内核 | 没人,内核不处理订阅 | 自己写 JSON、自己更新、自己看日志排错 |
所以对多数人来说,选对客户端,比单独研究内核更划算。
xray下载与 xray github:发布页怎么读
官方入口有三个:GitHub 仓库、发布页 和 文档站。梯子岛的 GitHub 仓库导航 把多款客户端和内核的官方仓库放在了一起。
读发布页时,按这几步来:
- 资产按系统命名,覆盖安卓、FreeBSD、Linux、macOS、Windows,Linux 一侧还分 mips、arm 等多种架构。选与你设备对应的那一个。
- Latest 标记的是稳定版。按档案核对,Xray 近期的版本不少标着 pre-release,被标 Latest 的反而更早一些。
- 想用预发布,先读它的更新说明,弄清改了什么。
- 苹果系统上内核不能独立运行,只能嵌入第三方应用使用,所以别在发布页里找 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 内核,来源怎么核对
- 看网址:github.com,组织名 XTLS,仓库名 Xray-core。
- 看状态:仓库页面没有归档提示,近期仍有发布。
- 看资产名:系统和架构要与设备对应。
- 看客户端里的内核信息:各客户端放内核信息的位置不同,找到后确认写的是 Xray,而不是别的名字。
- 别信“整合内核”:群文件、网盘和论坛附件里打包好的内核,都不算官方来源,风险见 修改版客户端的风险。
谁需要直接接触 Xray 内核
| 你的情况 | 要不要单独接触 | 接着看 |
|---|---|---|
| 在电脑上日常使用 | 不用,装客户端即可 | v2rayN 是什么 |
| 在安卓手机上使用 | 不用,装客户端即可 | v2rayNG 是什么 |
| 想读懂客户端的报错和配置字段 | 读文档就够,不必安装 | Xray 官方文档 |
| 在没有图形界面的 Linux 上做客户端侧代理 | 可以考虑命令行运行 | Linux 梯子怎么用 |
| 想在路由器上用 | 先看路由器插件的取舍 | 路由器翻墙的取舍 |
| 在 Mihomo 与 Xray 之间犹豫 | 先看两种内核的取舍 | Mihomo 与 Xray-core 对比 |
下一步:先选客户端,再回头读内核文档
- 在电脑或手机上日常用,就从 客户端选择工具 筛一款,内核交给它。
- 想弄懂 VLESS、Reality 这些名词,读 VLESS 协议是什么 与 协议矩阵,看哪些客户端支持。
- 想自己调配置,先对照官方文档,再回到 节点链接怎么读 弄清每个字段。
- 还没有订阅:到 机场导航 对照资料自己挑,梯子岛不替你决定买哪家。
这篇没有覆盖的
- 梯子岛没有 Xray 与其他内核在速度、资源占用上的对比数据,不替你判断谁更合适。
- TUIC、AnyTLS、ShadowsocksR 官方文档没有列出,是否支持资料待核实,不代表一定不支持。
- 鸿蒙上只确认到 README 列有对应客户端,好不好用没有核实,本文不下结论。
- 具体配置字段请查官方文档,这一页不附可以整段照抄的配置样例。
本文引用的官方来源
- Xray-core(github.com)
- Xray-core 官方下载入口(github.com)
- Xray-core 官方文档(xtls.github.io)
- 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 这类客户端,而不是塞给内核本身。
接着读
- 客户端 · v2rayN 是什么?Windows 客户端下载与使用门槛 2026
- 客户端 · v2rayNG 是什么?安卓 V2Ray 客户端的用法与下载
- 对比 · Mihomo 与 Xray-core 对比:Clash 系与 V2Ray 系内核
- 协议 · VLESS 协议是什么?VLESS 节点与 Xray 的关系
- 协议 · Reality 协议是什么?VLESS + Reality 的原理与客户端
- 术语 · Xray是什么意思
- 术语 · 代理内核是什么意思