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

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

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

选择平台

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

Windows

通过 winget 安装独立 EXE 版本：

winget install --id YuanDevLLC.OneXray -e

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

Microsoft Store 版本使用 MSIX 和 Windows 系统 VPN，Core 不请求 UAC。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

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

Debian/Ubuntu 的 DEB 安装会安装依赖并为 Core 授予网络 capability：

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

arm64 使用 OneXray-linux-aarch64.deb。ZIP 用户请在包含已解压 OneXray 文件夹的目录执行：

sudo apt install -y procps libcap2-bin libayatana-appindicator3-1
sudo setcap cap_net_admin,cap_net_raw+eip OneXray/OneXrayCore

更新替换 Core 后需要重新授权。ZIP 不自动注册 onexray:// 链接。GNOME 的托盘可能需要 AppIndicator 扩展。

下一步：首次连接。