Xray 一键脚本安装教程（支持 CentOS、Ubuntu、Debian、及最新版系统）

欢迎来到 Xray 安装与使用教程，Xray 是一款功能强大的网络代理工具，支持多种协议与灵活的传输方式，具有较高的可定制性和良好的兼容性。通过本文，您将了解 Xray 的准备工作、安装方法、基础配置思路以及后续管理方式。无论您是初学者还是已有一定 VPS 使用经验的用户，都可以根据本文快速完成部署与使用。

需要说明的是，Xray 经过持续更新，目前更适合以“官方安装方式 + 按需配置”的思路来使用。

因此，本文在保留原有教程结构的基础上，对安装方式、术语表述、准备工作和注意事项进行了同步更新，文中的截图主要用于帮助大家理解安装流程与界面内容，属于参考示意，即使后续脚本提示文字或菜单细节有所变化，也不影响整体安装思路的理解。

本文将介绍 Xray 的准备工作、安装方法、配置查看与常用管理命令

一、Xray 简介与功能特点

Xray 是一款功能丰富、扩展能力较强的网络工具核心，支持多种协议、传输方式和路由能力，由于它配置灵活、生态成熟、可维护性较好，因此被不少用户用于 VPS 环境中的自建部署。

对于希望自己掌握服务端配置、日志排查以及后续维护工作的用户来说，Xray 是一个值得了解和使用的方案。

和早期很多“一键脚本即全部”的使用方式不同，现在更建议大家采用更稳妥的思路来理解 Xray：

• 安装：优先使用可靠、持续维护的安装方式完成部署；
• 配置：根据自己的使用场景编写或导入配置；
• 管理：通过 systemd 或相关命令查看状态、重启服务、查看日志；
• 排查：出现问题时从域名解析、端口放行、证书、配置文件、日志等方面逐步检查。

这种方式虽然比早期“纯菜单式脚本”多了一点理解成本，但胜在更清晰、更稳定，也更适合长期维护。

核心特点

• 支持多种协议与传输组合，配置灵活；
• 支持 Linux 环境部署，便于服务端长期运行；
• 可通过 systemd 管理服务状态，运维更方便；
• 支持配置文件方式进行精细化调整；
• 适合有 VPS、自定义域名和基础 SSH 操作能力的用户。

适合的使用人群

• 希望在 VPS 上自行搭建和管理服务的用户；
• 想根据自己的实际网络环境灵活配置传输方式的用户；
• 愿意了解日志、配置、证书等基础运维内容的用户；
• 希望后续继续学习更复杂规则配置的进阶用户。

如果您还想了解更多不同协议组合与传统多合一安装方式，也可以参考这篇：最新 V2Ray 多合一脚本，支持 VMESS+websocket+TLS+Nginx、VLESS+TCP+XTLS、VLESS+TCP+TLS，对于想对比不同部署思路的朋友来说，这篇文章也有一定参考价值。

二、Xray 安装前的准备工作

在开始安装 Xray 之前，建议先准备好以下内容，准备工作越完整，后续安装和排查问题就越省心。

1. VPS 服务器

首先需要准备一台属于自己的 VPS 服务器。建议优先选择网络质量稳定、后台管理方便、支持重装系统和查看实例信息的服务商。对于新手来说，尽量选择主流 Linux 发行版镜像，例如 Ubuntu、Debian、CentOS 等，后续操作和资料查找都会更方便。

这里本站推荐 搬瓦工 和 Vultr，这两家的 VPS 是经过国内网友多年实践与验证后较为常见的 VPS 提供商。

• 搬瓦工 VPS 购买教程参考：最新搬瓦工 VPS 注册与购买教程
• Vultr 购买教程参考：最新 Vultr VPS 注册与购买教程

如果您所使用的 VPS 运营商默认开启了安全组、防火墙或端口访问限制，请先在管理后台放行所需端口。常见情况下，涉及证书签发或 Web 服务验证时，通常需要检查 80 端口和 443 端口是否已正确放行，否则可能出现证书申请失败、域名验证失败或服务不可访问等问题。

2. 域名（按需准备）

如果您的方案需要通过域名访问，或者后续需要使用 TLS 相关配置，那么建议准备一个属于自己的域名。

域名并不是所有场景下都必须，但在很多需要 HTTPS、证书、伪装站点或更规范配置的场景中，域名会显得非常重要。

购买域名后，记得提前完成 DNS 解析，将域名或子域名正确指向当前 VPS 的公网 IP。常见主机记录可以设置为“@”或“www”，当然也可以根据自己的需要设置为“blog”“bbs”“app”等其他子域名形式，只要解析正确，后续都可以正常使用。

3. SSH 连接工具

安装 Xray 需要先通过 SSH 登录到服务器，因此还需要准备一个远程连接工具。

Windows 系统：Windows 用户可以使用 Xshell、PuTTY、Windows Terminal 等工具连接 VPS，选择自己熟悉的即可。

Mac OS X（苹果）系统：Mac 用户通常不需要安装第三方 SSH 工具，系统自带的终端即可满足使用需求。

打开终端后输入以下命令：

ssh root@ip_address -p ssh_port
# 例如：ssh root@192.168.0.1 -p 23456

其中，ip_address 需要替换为 VPS 的 IP 地址，ssh_port 需要替换为 VPS 的 SSH 端口。

回车后输入 VPS 的 SSH 密码，即可成功登录服务器。

登录完成后，就可以继续执行后面的安装命令。

4. 基础环境检查

在正式安装前，建议大家顺手确认以下几点：

• 系统时间是否正确；
• 域名是否已经解析到当前 VPS；
• 80 / 443 端口是否开放；
• SSH 可以稳定连接，不会频繁断开；
• 系统中是否已安装 curl、wget 等常见基础工具。

这些看似简单的小检查，往往能帮大家避免后面很多不必要的报错与折腾。

5. 如果不想自己搭建，也可以直接选择机场服务

对于有些朋友来说，自己购买 VPS、配置域名、放行端口、申请证书以及后续维护服务端，整个过程还是会显得比较繁琐，尤其是第一次接触这类环境时，更容易在安装和排查问题的过程中耗费较多时间。

如果您更希望省去自建和维护的步骤，直接使用现成可用的服务，那么这里也推荐 搬瓦工官方出品的 Just My Socks 机场服务，整体来说，这类成品服务更适合不想自己折腾服务器环境、希望开通后即可直接使用的用户。

搬瓦工机场（JMS）提供优质的 CN2 GIA 线路，国内三网直连，IP 被墙后可自动更换。

• JMS 注册教程：最新 Just My Socks 注册、购买以及使用教程
• JMS 套餐汇总：Just My Socks 在售套餐汇总与方案选择指南
• JMS 优惠码：最新 搬瓦工机场 Just My Socks 优惠码 发布页

搬瓦工机场 Just My Socks 上网套餐介绍：

三、Xray Linux 系统安装教程

目前更建议优先使用官方维护的 Linux 安装脚本来完成 Xray 的安装与升级，这样做的好处是安装路径、服务管理方式和后续维护都更清晰，兼容性也更稳一些。

登录 VPS 后，输入以下命令安装 Xray：

bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install

如果系统中尚未安装 curl，可以先执行以下命令安装：

CentOS / AlmaLinux / Rocky Linux

yum install -y curl

Ubuntu / Debian

apt update && apt install -y curl

安装完成后，Xray 主程序、配置文件以及 systemd 服务通常会自动部署到系统中，对于大多数用户来说，这一步已经完成了基础安装。

如果您习惯使用菜单式交互脚本，那么也可以继续把本文中的旧截图当作参考示意来理解交互流程。

比如下面这类截图中，输入数字“8”安装“Xray-VLESS+TCP+XTLS”的界面，主要是帮助大家理解“选择安装方案”这个步骤本身；即使当前实际安装方式改成了官方脚本，这类截图仍然可以作为流程参考。

参考示意：
输入数字“8”安装“Xray-VLESS+TCP+XTLS”

旧式菜单脚本中可通过输入对应数字选择安装方案，图中以输入数字“8”为示例

如果您在旧式菜单脚本中看到“请输入 y 继续安装”的提示，同样可以将其理解为“确认域名、证书或安装条件后继续执行”的步骤示意。

截图中的交互界面本质上是在提醒用户确认安装前提是否满足，比如域名解析是否完成、证书是否可用、对应端口是否已经放行等。

参考示意：
确认安装条件无误后，输入“y”继续安装

在确认域名解析、证书或相关安装条件无误后，可继续执行安装流程

安装过程中的常见情况

1. 安装过程中可能会自动下载 Xray 相关文件，并写入 systemd 服务；
2. 部分系统会提示安装依赖或更新基础组件，属于正常现象；
3. 如果过程中画面暂时停顿，只要 SSH 连接未断开，通常等待即可；
4. 若 SSH 连接中断，可重新登录后检查 Xray 是否已经安装成功，再决定是否重新执行安装命令；
5. 若域名、证书或端口存在问题，建议优先检查域名解析、防火墙和 80 / 443 端口开放情况。

安装完成后，可以执行以下命令检查服务状态：

systemctl status xray

如果服务正常运行，一般会显示 active（running）状态，此时说明 Xray 基础安装已经完成，接下来可以进入配置、验证与管理阶段。

四、Xray 配置查看与安装结果验证

Xray 安装完成后，真正决定是否能够正常使用的关键在于配置文件是否正确。

因此，安装完成并不代表全部工作结束，还需要确认服务状态、配置内容和访问效果。

通常情况下，Xray 的配置文件位于：

/usr/local/etc/xray/config.json

大家可以使用编辑器查看或修改配置文件，例如：

cat /usr/local/etc/xray/config.json

或者：

nano /usr/local/etc/xray/config.json

如果您使用的是菜单式旧脚本，通常在安装完成后，SSH 窗口中会直接显示一组用于客户端填写的参数信息。

下面这类截图仍然可以作为“安装完成后如何识别关键信息”的参考示意。

参考示意：
安装完成后查看 Xray 配置信息

安装完成后通常可看到协议、地址、端口、UUID、传输方式和 TLS 等关键信息

在实际配置过程中，大家通常会接触到以下这些字段：

• 协议（protocol）
• 地址（address）
• 端口（port）
• 用户 ID / UUID（id）
• 流控（flow）
• 加密方式（encryption）
• 传输协议（network）
• 伪装类型（type）
• 域名 / 主机名（host）
• TLS 设置（tls）

这些参数在客户端中都需要与服务端保持一致，只要其中某一项填写错误，就可能导致连接失败、握手失败、证书不通过，或者虽然连接成功但无法正常访问网页等情况。因此，在服务端安装完成之后，选择一个适合自己的客户端并正确导入配置，也是后续能否顺利使用的重要一步。

如果您还没有准备好客户端，或者希望在不同设备之间统一使用体验，也可以先参考这篇全平台说明：Hiddify 下载指南：全平台通用代理客户端 (含 iOS/Windows/Android)，对于需要同时在多个系统上使用配置的朋友来说会更方便一些。

如果您使用的是安卓手机，除了部分支持多协议的新客户端以外，v2rayNG 也是很多用户比较熟悉的选择之一。关于下载方式、官网地址以及 GitHub 与镜像资源，也可以参考：最新 v2rayNG 安卓客户端下载指南：官网 GitHub 与高速镜像 (支持 Xray/Reality)。

如果您希望在安卓端使用支持 Sing-box / Xray 双核的客户端，也可以参考：NekoBox for Android 下载指南：全协议支持 (Sing-box/Xray 双核)，方便后续在移动端导入和使用相关配置。

如果您使用的是 Windows 客户端，后续也可以结合自己常用的软件继续完善连接配置。关于桌面端客户端的使用与版本说明，还可以参考：V2RayN V4.12 版到底更新了什么内容？我们该怎么使用？。

如果您已经确定在 Windows 系统中使用 V2rayN，那么也可以继续参考更具体的实操内容：Windows 系统下 V2rayN 客户端 V7.13.2.0 版本配置教程，方便后续根据服务端参数完成客户端导入与连接设置。

安装完成后建议做的验证

• 确认 Xray 服务是否处于运行状态；
• 确认配置文件语法没有错误；
• 确认域名是否正确解析到 VPS；
• 确认服务器防火墙与云平台安全组已放行对应端口；
• 如果涉及伪装站点或 Web 服务，确认浏览器访问域名时能否正常打开；
• 将服务端参数填写到客户端后，检查是否可以正常建立连接。

对于需要域名和 TLS 的方案来说，如果在浏览器中打开域名后能够正常显示页面、证书无异常，同时客户端参数填写无误，那么通常说明整体配置已经比较接近可用状态。

五、Xray 常用管理命令

安装完成之后，后续最常用的其实不是“重新安装”，而是“查看状态、重启服务、查看日志和修改配置”。

下面整理一些比较常用的命令，方便大家后续维护。

启动 Xray

systemctl start xray

停止 Xray

systemctl stop xray

重启 Xray

systemctl restart xray

查看 Xray 运行状态

systemctl status xray

设置开机自启

systemctl enable xray

查看日志

journalctl -u xray -e --no-pager

测试配置文件是否存在明显问题

/usr/local/bin/xray run -test -config /usr/local/etc/xray/config.json

对于大多数用户来说，只要掌握上面几条命令，后续的日常维护基本就够用了。尤其是出现无法连接、配置改动后服务异常、证书更新后仍不可用等情况时，优先看状态和日志，往往比重复重装更有效。

如果您之前安装过其他相关工具，或者准备更换部署方案，需要先卸载旧环境的话，也可以参考：V2RayA 卸载图文教程：从检查到彻底清除的每一步，先把旧组件清理干净，再进行新的安装和配置会更稳妥。

六、Xray 方案怎么选？不同使用场景建议

很多朋友在接触 Xray 时，最容易困惑的地方不是“怎么安装”，而是“我应该选哪种方案”。

实际上，不同方案只是为了适应不同的网络环境、客户端支持情况和部署需求，并不存在绝对意义上的“万能方案”。

在实际使用中，可以按以下思路理解：

• 想先学会基础部署：建议先完成官方安装，再学习最基础的单一配置结构；
• 需要域名、证书、TLS：优先确认域名解析、80/443 端口和证书申请条件；
• 需要更规范的 HTTPS 场景：建议把 Web 服务、证书和 Xray 配置的关系理解清楚后再进行组合；
• 希望后续长期维护：优先选择自己能够理解和排查的方案，而不是单纯追求配置看起来更“高级”。

换句话说，适合自己的方案，往往比“听起来最强”的方案更重要，对新手来说，先把安装、配置、日志和排查流程跑通，比盲目追求复杂组合更实用。

如果您已经完成基础安装，后续还想继续了解更进阶的思路，例如伪装相关的使用方向，也可以延伸阅读：V2Ray 高级使用技巧之流量伪装，建议先完成基础部署，再去理解这些进阶内容会更容易一些。

七、Xray 常见问题与安装注意事项

1. 安装后无法启动
   优先执行 systemctl status xray 和 journalctl -u xray -e --no-pager 查看报错，不建议一上来就重复重装。
2. 证书申请失败
   通常优先检查域名解析是否正确、80/443 端口是否放行、服务器时间是否准确，以及是否存在其他程序占用了相关端口。
3. 浏览器打不开域名
   先检查 DNS 解析是否生效，再检查 VPS 防火墙和安全组设置，确认服务是否正在运行。
4. 客户端连接失败
   重点检查 address、port、UUID、network、TLS、host、flow 等字段是否与服务端一致，尤其不要忽略大小写、空格和端口填写错误等细节。
5. 修改配置后无法运行
   建议先测试配置文件，再重启服务。配置文件中最常见的问题往往是 JSON 语法错误、字段拼写错误、括号缺失或多余逗号。
6. 不要频繁重复重装
   很多问题其实并不是“程序没装好”，而是端口、防火墙、证书、域名或配置文件本身的原因。先看日志、再分析原因，效率会更高。
7. 注意系统与脚本兼容性
   建议优先使用较新的稳定版 Linux 系统，避免因为系统版本过旧、软件源异常或依赖缺失而影响安装与运行。

八、Xray 安装与使用总结

通过以上步骤，我们已经把 Xray 的准备工作、安装方法、配置查看、常用管理命令以及常见问题都梳理了一遍。

和早期单纯依赖某一个旧版一键脚本不同，现在更推荐大家使用“官方安装 + 自主配置 + 日志排查”的方式来理解和使用 Xray。这样做不仅安装过程更稳，后续维护和排错也会更加清晰。

如果您只是第一次接触 Xray，不必一开始就追求复杂的组合配置，先完成基础安装，确认服务可以正常启动，学会查看配置文件和日志，再逐步过渡到更适合自己的方案，会更加实际。

最后再次说明，文中的截图主要用于流程参考，帮助大家理解旧式菜单脚本中的交互逻辑，例如输入数字“8”选择某个方案、输入“y”确认安装、安装完成后查看配置信息等。这些截图并不会因为命令更新而失去参考价值，依然可以帮助新手建立完整的安装认知。

感谢您阅读本篇 Xray 安装与使用教程，如果您在安装、配置或排查过程中遇到问题，欢迎结合自己的报错信息、运行状态和日志内容逐步检查，也欢迎在下方留言交流。