XTLS_Xray-docs-next/docs/document/install.md

下载安装

平台支持

官方 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 环境、支持更多的架构。由官方库编译并构建支持追溯。牺牲了便利性来追求更极端的安全性 ::: details 文件结构

  • /usr/local/bin/xray：Xray 主程序（拥有者是 root:root、文件权限 755）
  • /usr/local/etc/xray/：配置文件目录（挂载点）（拥有者是 root:root、目录权限 755、文件权限 644）
    • 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/：资源文件目录，存放了 Loyalsoldier 版本地理位置数据文件（拥有者是 65532:65532、目录权限 755、文件权限 644）
    • geoip.dat
    • geosite.dat
  • /var/log/xray/：日志文件目录（挂载点）（目录拥有者是 root:root、权限 755；文件拥有者是 65532:65532、权限 600）
    • access.log
    • error.log

  :::

• teddysun/xray
  有 root 权限、有 shell 环境、兼容所有 Alpine 支持的架构。由私人服务器 dl.lamp.sh 编译并构建。使用起来更便捷 ::: details 文件结构

  • /usr/bin/xray：Xray 主程序
  • /etc/xray/config.json：单一配置文件（其所在目录为挂载点）
  • /usr/share/xray/：资源文件目录，存放了 v2fly 版本地理位置数据文件
    • 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
Windows	Furious
Windows	Invisible Man - Xray
Windows	AnyPortal
Android	v2rayNG
Android	X-flutter
Android	SaeedDev94/Xray
Android	SimpleXray
Android	AnyPortal
iOS / macOS arm64 / tvOS	Happ (tvOS)
iOS / macOS arm64 / tvOS	FoXray
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	Furious
macOS arm64 / x64	OneXray
macOS arm64 / x64	GoXRay
macOS arm64 / x64	AnyPortal
Linux	v2rayA
Linux	v2rayN
Linux	Furious
Linux	GorzRay
Linux	GoXRay
Linux	AnyPortal

UUID 生成器

第三方的 UUID 生成器 uuidgenerator.net