什么时候直接使用 Xray-core
直接运行内核,适合想阅读配置、管理进程或观察转发过程的用户。日常只需要导入和切换节点,可以先用v2rayN或v2rayNG的界面完成。
内核、配置和远端服务是三件事。安装内核不会自动获得服务器地址或凭据;配置通过检查,也不能证明远端可达。先把本机监听、请求转发和日志对应起来,再接入你有权使用的远端配置。
下载与版本检查
2026 年 11 月 9 日核对,官方最新正式版为 v26.11.9。发行说明列出 XDRIVE 传输及 Google Drive 后端优化,并更新默认 Chrome 指纹。本页只验证本机 HTTP/SOCKS 入口的教程不使用 XDRIVE,也不需要添加云盘凭据或改动传输配置。已有远端配置先核客户端实际调用的内核与服务端要求,再决定是否采用新功能;不据指纹更新承诺连接成功或隐私效果。
历史安全背景:2026 年 10 月 31 日发布的 v26.10.31。当时官方将其列为紧急安全更新:默认关闭 MPTCP,并说明 v26.10.29 已撤回。此前下载了 26.10.29 的读者应重新查看本次发行说明,不再把它作为推荐安装版本。
据项目发行说明,此次调整针对 Linux 内核 MPTCP 监听风险;项目同时提醒更新 Linux 内核。它也提醒 Android 客户端允许局域网连接的 SOCKS/HTTP 入站可能涉及风险。本文不独立断言你的设备受影响,也不把内核升级等同于系统漏洞已修复;按系统发行方的更新说明处理。本页示例继续只监听 127.0.0.1,不需要扩大监听范围或开启 MPTCP。
版本背景:v26.10.29 曾包含接口绑定、IPv6 进程路由和 Geodata 下载等调整;这里保留历史差异说明,不建议继续使用已撤回版本。v26.10.21 的证书信任更新也是历史背景,升级不能省略证书校验。
进入 Xray-core 官方 Releases,阅读所选版本说明,然后下载匹配系统与处理器架构的压缩包。Windows、Linux 与 macOS 包不能混用;Intel/AMD 电脑与 ARM 设备也要分别选择。
- 解压到自己容易找到的目录,并保留随包文件;不要只凭文件名从第三方网盘下载。
- 在解压目录打开终端。下文假设命令已加入 PATH;否则 macOS/Linux 用
./xray,Windows 用.\xray.exe代替xray。 - 执行
xray version和xray help run,确认运行的是刚下载的程序。
本版本桌面常见包包括 Windows x64 的 Xray-windows-64.zip、Windows ARM64 的 Xray-windows-arm64-v8a.zip,macOS Intel 的 Xray-macos-64.zip 和 Apple Silicon 的 Xray-macos-arm64-v8a.zip,Linux x64 的 Xray-linux-64.zip 与 ARM64 的 Xray-linux-arm64-v8a.zip。架构匹配不等于操作系统版本一定兼容;先在独立目录确认能运行,再替换现有程序。对应 .dgst 文件用于核对摘要,可参考下载文件的 SHA-256 检查。
系统无法运行时,先核对架构、操作系统要求和可执行权限,再考虑配置。已有客户端捆绑的内核与单独下载的版本可能不同,不应只根据客户端版本推断内核能力。
保存本机 HTTP 和 SOCKS 配置
在程序目录新建 UTF-8 文本文件 config.json,保存以下完整 JSON。这里用两个不同端口,方便区分 HTTP 和 SOCKS 请求;若端口已被占用,可同时修改配置与后面的验证命令。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
},
{
"tag": "local-http",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} }
]
}listen 固定为 127.0.0.1,只接受本机连接;不要为了“连不上”直接改成公网监听。本例 SOCKS 不启用 UDP,HTTP 入站用于本机应用。唯一出站 freedom 直接连接目标,没有连接远端代理,也不会改变出口位置。
检查配置并启动进程
先执行检查命令;检查通过后再执行启动命令,两者不要同时输入:
xray run -test -config ./config.json
xray run -config ./config.json-test 只验证配置能否加载,不启动监听。出现错误时按提示检查 JSON 标点、路径和当前版本支持的字段。启动命令会持续运行,终端暂时没有新输出并不代表失败。保留这个终端,在另一个终端验证;结束演示时用 Ctrl+C 停止。
如果启动时报告地址已被使用,说明该端口已有其他进程。优先停止自己的重复实例或换一个空闲端口,不要结束不认识的系统进程。
分别请求两个代理入口
以下请求访问文档示例域名,限制最长等待时间,不更改系统代理。macOS/Linux 使用 curl;Windows PowerShell 使用 curl.exe,避免同名命令别名。
curl --noproxy localhost --proxy http://127.0.0.1:10809 --head --max-time 20 https://example.com
curl --noproxy localhost --proxy socks5h://127.0.0.1:10808 --head --max-time 20 https://example.com--noproxy localhost 明确限定绕过列表,示例目标仍走指定入口;socks5h 把目标域名交给内核解析。观察命令是否连接本机端口、是否拿到目标的 HTTP 响应头。具体状态码由目标实时返回,不预设固定结果。
HTTP 代理可能先显示 CONNECT 隧道响应,随后才是目标响应。拿到页面响应只证明这次本机转发成功;它不能证明远端节点、系统所有应用或 UDP 工作正常。
验证记录:2026 年 10 月 2 日,官方 Linux amd64 版 Xray 26.3.27 运行此配置得到 Configuration OK,HTTP 与 SOCKS 两次示例请求均完成并收到目标 HTTP 200。测试后已停止本机进程。该记录覆盖这个版本、环境和当次请求;其他系统、目标与远端配置仍需分别验证。
以上是保留的历史验证记录,不是 v26.11.9 的实测结论。本次版本同步核对了官方发布状态、发行说明与下载资产;升级后仍需用你实际运行的新版重复配置检查和请求验证。
根据错误检查配置与监听
| 现象 | 优先检查 |
|---|---|
| 连接本机端口被拒绝 | 进程是否运行,命令端口是否与配置一致,启动日志是否报错。 |
| 配置检查失败 | 实际文件路径、JSON 格式、字段与运行版本;保留完整错误行。 |
| 本机已连接,目标超时 | 当前直连网络、目标状态和域名解析;这不是远端代理故障。 |
| 只有某个应用无效 | 应用是否使用该入口,以及它需要 HTTP、SOCKS 还是其他方式。 |
需要更多信息时临时把 loglevel 改为 info 并重启,复现一次后恢复。日志可能包含访问域名与地址;反馈问题时提供版本、命令和必要错误,遮盖凭据及个人路径。更多连接分层思路可见 故障排查。
接入远端配置与日常维护
本机实验之后,按真实服务提供的协议、服务器地址、身份和传输参数填写出站。保持原来的本机监听配置,每加一部分就检查并请求一次。
修改前备份原文件,修改后重复配置检查与单次请求验证。更新内核时阅读发行说明,保留可回退版本,并重新检查已有配置。日常客户端管理可用图形工具;路由定位用 NextTrace,DNS 对照用 doggo。
从旧版本迁移时,先备份当前程序、配置和启动方式;把新版解压到独立目录,用新版执行 xray version 与 xray run -test -config ./config.json。通过后停止自己的旧实例,再按原入口启动新版并完成请求验证。不要同时运行两个争用相同端口的进程。
若使用 v2rayN 或 v2rayNG,先检查客户端实际调用的内核版本和官方更新入口;独立内核发布不代表客户端安装包已经同步。升级失败时保存错误并恢复原启动方式,但不要为了恢复连接而关闭证书验证;官方已撤回的 v26.10.10、v26.10.17、v26.10.29 也不应作为长期回退目标。
如果旧配置在 freedom 出站里使用 fragment 或 noises,v26.10.29 的配置解析源码会给出弃用迁移警告,分别指向 streamSettings.finalmask.tcp 下的 fragment 与 streamSettings.finalmask.udp 下的 noise。这是迁移提示,不能直接把整个旧对象机械改名后认定等价;先备份并按对应字段文档调整,再检查与验证。本页最小示例未使用这些字段,因此无需为了消除这类警告凭空新增它们。
本次升级后先用 xray version 核对实际执行文件,再完成配置检查和原用途验证;客户端捆绑内核须通过该客户端支持的更新方式处理,不能把独立 Xray 发布号直接写成客户端版本。安全更新失败时先停止有问题的实例、保存错误和配置备份,不把恢复已撤回版本作为长期解决方案。
常见问题
Xray-core 与 v2rayN 是同一种软件吗?
不是。Xray-core 是处理连接和转发的内核;v2rayN 提供图形操作界面,并可调用内核。内核本身没有节点列表和一键导入界面。
为什么这个示例的出口 IP 没有变化?
示例只有 freedom 直连出站,用来验证本机监听与请求转发。它没有远端代理出站,出口没有变化属于设计行为。
可以让局域网设备连接这里的 SOCKS 端口吗?
本例明确只监听 127.0.0.1,其他设备无法连接。局域网共享涉及监听地址、认证和防火墙;不要直接把无认证入口开放到公网。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。