跳至内容
安装 OneXray

下载安装 OneXray:Xray-core 客户端

OneXray 是适用于桌面和移动设备的开源 Xray-core 客户端,不提供服务器或订阅。连接前,请先准备服务提供方给出的兼容配置;无需另外安装 Xray-core 命令行程序。

安装后可添加服务器,也可以使用 AI 生成配置。遇到连接问题时,先核对格式兼容性,再调整平台设置。

下载前请先核对系统要求,尤其是 Linux 发行版与运行库基线。

选择平台

平台 系统要求 下载
iPhone / iPad iOS / iPadOS 16+ App Store · IPA
Mac App Store macOS 13+,Apple 芯片或 Intel App Store
Mac — OneXraySE macOS 13+,Apple 芯片或 Intel Homebrew · Universal ZIP
Android 手机 / 平板 Android 10+(API 29),arm64-v8a 或 x86_64 Google Play · APK
Windows x64 Windows 10 20H2(19042)及以上 Microsoft Store · EXE (winget) · ZIP
Windows ARM64 Windows 11 Microsoft Store · EXE (winget) · ZIP
Linux x86_64 glibc 2.39+、GLib 2.80+、GTK 3,内核 5.3+ DEB · RPM · pacman · ZIP
Linux arm64 glibc 2.39+、GLib 2.80+、GTK 3,内核 5.3+ DEB · RPM · pacman · ZIP

完整更新说明和安装包见 Releases。Android 不支持 32 位 ARM。

Windows

Microsoft Store

直接从 Microsoft Store 安装,或通过 winget 指定商店源:

winget install --id 9NJ0MVHW215D --source msstore

商店版本使用 MSIX 和 Windows 系统 VPN,Core 不请求 UAC。Microsoft Store 负责架构选择和更新。

独立 EXE / ZIP

通过 winget 社区源安装独立 EXE 版本:

winget install --id YuanDevLLC.OneXray -e --source winget

EXE 与 ZIP 使用原生 TUN。启动 VPN 时为 Core 请求管理员批准,主 App 不需要以管理员身份运行。ZIP 必须完整解压后打开;它不会自动注册链接或创建快捷方式。

EXE/ZIP 与 MSIX 使用不同数据目录,切换渠道不等于原地迁移。两者都要求明确选择 Xray 出口网卡。参阅 Windows 行为。

各类 Windows 安装包均附带对应架构的 Microsoft Visual C++ 运行库,图形界面无需单独安装运行库。

macOS

Mac App Store 版本使用 Packet Tunnel。OneXraySE 使用 System Extension:

brew install --cask onexrayse

使用 ZIP 时,将 OneXraySE.app 移入 /Applications 后再打开。完成首次设置、进入主界面后,批准 VPN 和网络扩展请求。macOS 可能引导您前往“登录项与扩展”或“隐私与安全性”;如要求重启,请按提示操作。更新 ZIP 版本时先退出 App,再替换应用程序目录中的旧版本,并批准可能出现的扩展更新。

参阅 Apple 系统扩展安装说明。

iOS IPA

建议优先使用 App Store。自行安装 IPA 需要为主 App 与 Packet Tunnel 扩展重新签名,并使用允许 Network Extension 的描述文件;免费 Personal Team 不提供该能力。参阅 Apple 支持的能力。

Linux

请先核对 Linux 系统要求:DEB、RPM、pacman 和 ZIP 安装包使用相同的系统库基线,要求 glibc 2.39+、GLib 2.80+ 和 GTK 3。Ubuntu 24.04 LTS 满足此基线,Ubuntu 22.04 不兼容。

Core 进程监测要求 Linux 内核 5.3 及以上,并支持 pidfd。Linux ARM64 当前将中文/日文/韩文语言选择显示为英语,但保留原偏好,详见语言设置。

从 Releases 中选择版本,按该版本实际提供的格式下载与 CPU 架构匹配的安装包。若没有适合您发行版的原生包,可使用 ZIP。以下命令以 x86_64 为例;arm64 请将文件名中的 x86_64 换成 aarch64。

安装、升级或移除软件包前,先停止 VPN 并退出 OneXray;升级时用相同的包管理器安装新版本。DEB、RPM 和 pacman 包在首次安装及升级时都会自动为 Core 设置 cap_net_admin,cap_net_raw capability。安装后,从桌面应用菜单以普通用户启动 OneXray;也可以使用各节列出的启动命令。下方 getcap 的输出应包含 cap_net_admin,cap_net_raw=eip。

Debian / Ubuntu DEB

在满足系统要求的 Debian/Ubuntu 系统上,下载 DEB 后,在文件所在目录执行以下命令,APT 会一并安装所需依赖:

sudo apt install ./OneXray-linux-x86_64.deb

Core 安装在 /opt/OneXray/OneXrayCore。可检查授权并以普通用户启动:

getcap /opt/OneXray/OneXrayCore
OneXray

移除软件包:

sudo apt remove onexray

Fedora / RPM

在满足系统要求的 Fedora 或兼容 RPM 发行版上,从 Releases 下载该版本提供的 RPM,然后在文件所在目录安装:

sudo dnf install ./OneXray-linux-x86_64.rpm

Core 安装在 /usr/share/onexray/OneXrayCore。可检查授权并以普通用户启动:

getcap /usr/share/onexray/OneXrayCore
onexray

移除软件包:

sudo dnf remove onexray

Arch Linux / pacman

在满足系统要求的 Arch Linux 或兼容 pacman 发行版上,从 Releases 下载该版本提供的 .pkg.tar.zst,然后在文件所在目录安装:

sudo pacman -Syu
sudo pacman -U ./OneXray-linux-x86_64.pkg.tar.zst

标准 Arch Linux 使用 x86_64;OneXray-linux-aarch64.pkg.tar.zst 用于满足系统要求的兼容 ARM64 发行版。

Core 安装在 /opt/OneXray/OneXrayCore。可检查授权并以普通用户启动;此包的启动命令首字母大写:

getcap /opt/OneXray/OneXrayCore
OneXray

移除软件包:

sudo pacman -R onexray

以上卸载命令只移除软件包,保留 OneXray 的个人数据。本地安装包不会自动添加 OneXray 更新源,后续升级需下载新版本并重复对应的本地文件安装命令。

Ubuntu、Fedora 与 Arch Linux 的 ZIP 安装

ZIP 需要手动安装运行依赖,并为 Core 授予网络 capability。先执行下方对应发行版的依赖安装命令,再按统一步骤解压、授权和启动。这些命令不会改变系统要求中的最低库版本。

Ubuntu 24.04 LTS

sudo apt install -y unzip libgtk-3-0t64 libglib2.0-0t64 libstdc++6 libepoxy0 libx11-6 libxi6 procps libcap2-bin

Fedora

请使用满足完整系统库基线的 Fedora 版本:

sudo dnf install unzip gtk3 glib2 libstdc++ libepoxy libX11 libXi procps-ng libcap

Arch Linux

在 Arch Linux x86_64 上,一并更新系统并安装依赖:

sudo pacman -Syu --needed unzip gtk3 libstdc++ procps-ng libcap

解压、授权 Core 并启动

从上方表格下载与 CPU 架构匹配的 ZIP。以下以 x86_64 为例,将完整目录保存在 $HOME/Applications/OneXray;arm64 请把压缩包名替换为 OneXray-linux-aarch64.zip。如果浏览器下载到其他位置,请相应调整下载路径。

mkdir -p "$HOME/Applications/OneXray"
unzip "$HOME/Downloads/OneXray-linux-x86_64.zip" -d "$HOME/Applications/OneXray"
cd "$HOME/Applications/OneXray"
chmod +x ./OneXray ./OneXrayCore
sudo setcap cap_net_admin,cap_net_raw+eip ./OneXrayCore
getcap ./OneXrayCore
./OneXray

ZIP 根目录直接包含可执行文件,上方解压命令会为它们创建外层目录。OneXrayCore 与 OneXray 可执行文件均位于 $HOME/Applications/OneXray。请将 lib/、data/ 和其他附带文件保留在此目录中。使用当前桌面的普通用户运行图形 App;上方 sudo 仅用于安装依赖和为 Core 授权。

升级时先停止 VPN 并退出 OneXray,再替换完整的解压目录,并在启动前对新文件重新执行 chmod 和 setcap。替换 Core 后,文件 capability 不会自动保留。ZIP 不自动注册 onexray:// 链接。GNOME 的托盘可能需要 AppIndicator 扩展。

下一步:首次连接。

最后更新于