下载安装
平台支持
官方 Release 支持以下平台
| 平台 | 架构 |
|---|---|
| Windows [1] | x86 / amd64 / arm32 / arm64 |
| macOS | amd64 / arm64 |
| Linux | x86 / amd64 / arm / arm64 / mips64 / mips / ppc64 / s390x / riscv64 |
| FreeBSD | x86 / amd64 |
| OpenBSD | x86 / amd64 |
[1] Windows 7 已被 golang 官方停止支持，Xray 使用 patched go 独立发布构建提供支持，win7 用户请使用 -win7 后缀的发布。
Xray 积极跟进 golang 版本，除 win7 外最低操作系统版本支持请参考发布时对应的最新的 go release note。
未像部分类似项目一样提供 amd64 v2 v3 等构建，因为经过测试性能并没有明显提升，关键函数中很多使用了运行时检测来自动使用扩展指令集。
下载 Xray
预编译的二进制 ZIP 格式压缩包可在 Github Releases 中找到。
下载对应平台的压缩包，解压后即可使用。
验证安装包
Xray 提供两种验证方式：
- ZIP 压缩包的 SHA1 / SHA256 摘要
- 可复现构建：请参照 编译 Xray
Windows 安装方式
- 在 Github Releases 下载适用于 Windows 平台的 ZIP 压缩包，解压后可得到可执行文件
xray.exe，然后通过命令行带参数运行 即可
macOS 安装方式
- 在 Github Releases 下载适用于 macOS 平台的 ZIP 压缩包，解压后可得到可执行文件
xray，然后通过命令行带参数运行 即可 - 通过 Homebrew 包管理器安装：
brew install xray - homebrew-xray 感谢@N4FA
Linux 安装方式
安装脚本与项目
| 类型 | 项目 | 说明 |
|---|---|---|
| Linux Script | XTLS/Xray-install（官方） | 官方维护的 Linux 安装脚本 |
| Linux Script | tempest | 支持 Systemd 与 OpenRC |
| One Click | Xray-REALITY | 一键安装方案 |
| One Click | reality-ezpz | 一键安装方案 |
| One Click | Xray_bash_onekey | 一键安装方案 |
| One Click | v2ray-agent | 一键安装方案 |
| One Click | ProxySU | 一键安装方案 |
| Magisk | Xray4Magisk | 适用于 Magisk 环境 |
| Magisk | Xray_For_Magisk | 适用于 Magisk 环境 |
包管理器与发行版仓库
| 方式 | 项目 | 说明 |
|---|---|---|
| Arch User Repository | AUR helpers | 以 yay 为例，可通过 yay -S xray 安装 |
| Arch Linux CN | Arch Linux CN 仓库 | 添加仓库后，在 root 用户下使用 pacman -S xray 安装 |
| Linuxbrew | Homebrew | 用法与 Homebrew 一致：brew install xray |
| Gentoo Portage | Gentoo-zh | 适用于 Systemd 系统；使用 layman 或 eselect-repository 添加 Overlay 后安装 |
Docker 安装方式
目前提供两种不同风格的 Docker 映像：
ghcr.io/xtls/xray-core（官方）
无 root 权限、无 shell 环境、支持更多的架构。由官方库编译并构建支持追溯。牺牲了便利性来追求更极端的安全性文件结构
/usr/local/bin/xray：Xray 主程序（拥有者是root:root、文件权限755）/usr/local/etc/xray/：配置文件目录（卷挂载点，VOLUME）（拥有者是root:65532、目录权限750、文件权限640）- 00_log.json
- 01_api.json
- 02_dns.json
- 03_routing.json
- 04_policy.json
- 05_inbounds.json
- 06_outbounds.json
- 07_stats.json
- 08_fakedns.json
- 09_metrics.json
- 10_observatory.json
- 11_geodata.json
- 12_env.json
- 99_version.json
/usr/local/share/xray/：资源文件目录，存放 GeoIP 完整版 和 GeoSite 扩展版（拥有者是65532:65532、目录权限755、文件权限644）- geoip.dat
- geosite.dat
/var/log/xray/：日志文件目录（卷挂载点，VOLUME）（拥有者是65532:65532、目录权限700）
teddysun/xray
有 root 权限、有 shell 环境、兼容所有 Alpine 支持的架构。由私人服务器 dl.lamp.sh 编译并构建。使用起来更便捷文件结构
/usr/bin/xray：Xray 主程序/etc/xray/config.json：单一配置文件（其所在目录为挂载点）/usr/share/xray/：资源文件目录，存放了 Loyalsoldier 版本地理位置数据文件- geoip.dat
- geosite.dat
第三方图形化客户端
| 平台 | 项目 |
|---|---|
| OpenWrt | PassWall |
| OpenWrt | PassWall 2 |
| OpenWrt | ShadowSocksR Plus+ |
| OpenWrt | luci-app-xray (openwrt-xray) |
| Asuswrt-Merlin | XRAYUI |
| Windows | v2rayA |
| Windows | v2rayN |
| Android | v2rayNG |
| Android | X-flutter |
| Android | SaeedDev94/Xray |
| Android | SimpleXray |
| iOS / macOS arm64 / tvOS | Happ (tvOS) |
| iOS / macOS arm64 / tvOS | Streisand |
| macOS arm64 / x64 | Happ |
| macOS arm64 / x64 | v2rayA |
| macOS arm64 / x64 | v2rayN |
| macOS arm64 / x64 | V2rayU |
| macOS arm64 / x64 | V2RayXS |
| macOS arm64 / x64 | OneXray |
| Linux | v2rayA |
| Linux | v2rayN |
| Linux | GorzRay |
