# OneXray 系统要求

Source: https://onexray.com/zh/docs/system-requirements/
Description: OneXray 各平台的最低系统版本与 CPU 架构，以及 Ubuntu、Fedora 和 Arch Linux 所需的运行库与内核基线。
Language: zh-CN
Last updated: 2026-11-15


下载 OneXray 前，请先核对操作系统和 CPU 架构。以下要求适用于当前官方发布版本。

**Linux DEB、RPM、pacman 和 ZIP 安装包使用相同基线：glibc 2.39+、GLib 2.80+、GTK 3 运行库，以及支持 pidfd 的 Linux 5.3+ 内核。Ubuntu 24.04 LTS 满足此基线，Ubuntu 22.04 不兼容。**

## 支持的系统

| 平台 / 版本 | 最低系统版本 | CPU 架构 |
| --- | --- | --- |
| iPhone / iPad | iOS / iPadOS 16 | 支持该系统的 iPhone 和 iPad |
| Mac App Store | macOS 13 | Apple 芯片或 Intel |
| Mac — OneXraySE | macOS 13 | Apple 芯片或 Intel |
| Android 手机 / 平板 | Android 10（API 29） | arm64-v8a 或 x86_64；不支持 32 位 ARM |
| Windows x64 | Windows 10 20H2（内部版本 19042） | x64 |
| Windows ARM64 | Windows 11 | ARM64 |
| Linux DEB / RPM / pacman / ZIP | Ubuntu 24.04 LTS，或满足下方全部系统库要求的发行版 | x86_64 或 arm64（aarch64） |

下载地址、安装包差异和 VPN 授权步骤见[安装指南](https://onexray.com/zh/docs/install/)与[首次连接](https://onexray.com/zh/docs/getting-started/)。

## Linux 要求

OneXray 需要图形桌面会话；使用 ZIP 时，请保留完整的解压目录。

DEB、RPM、pacman 和 ZIP 安装包使用相同的系统库基线：

| 组件 | 要求 |
| --- | --- |
| 发行版基线 | Ubuntu 24.04 LTS，或提供下列全部系统库的其他发行版 |
| glibc | 2.39 及以上（官方安装包基线） |
| GLib | 2.80 及以上 |
| GTK | GTK 3 运行库 |
| 内核 | Linux 5.3 及以上，支持用于监测 Core 进程的 pidfd |
| CPU | x86_64 或 arm64（aarch64），与下载的安装包匹配 |

满足基线的 Debian/Ubuntu、Fedora 和 Arch Linux 系统可分别参考 [DEB](https://onexray.com/zh/docs/install/#linux-deb)、[RPM](https://onexray.com/zh/docs/install/#linux-rpm) 和 [pacman](https://onexray.com/zh/docs/install/#linux-pacman) 安装说明。按所选版本实际提供的格式下载；若没有对应的原生包，可使用 [ZIP](https://onexray.com/zh/docs/install/#linux-zip)，手动安装依赖并授予 Core capability。标准 Arch Linux 的安装步骤适用于 x86_64；ARM64 需要满足同一基线的兼容发行版。

**Ubuntu 22.04 与当前官方 Linux 安装包不兼容。** 它的 GLib 2.72 缺少 App 原生库所需的 API，例如 GLib 2.80 才引入的 [`g_once_init_enter_pointer`](https://docs.gtk.org/glib/type_func.Once.init_enter_pointer.html)，可能导致窗口打开前就报缺少符号的错误。

只安装 GTK 不能满足独立的 GLib 和 glibc 版本要求；只更新 OneXray 也不会升级这些系统库。请使用 Ubuntu 24.04 LTS 或满足完整基线的发行版，再按 [Linux 安装与 capability 授权说明](https://onexray.com/zh/docs/install/#linux)操作。

### 检查 Linux 系统

以下命令分别显示发行版、glibc 和内核版本：

```shell
cat /etc/os-release
ldd --version
uname -r
```

在 Debian/Ubuntu 上，可检查已安装的 GLib 和 GTK 运行库版本：

```shell
dpkg-query -W 'libglib2.0-0*' 'libgtk-3-0*'
```

Fedora 可使用：

```shell
rpm -q glibc glib2 gtk3
```

Arch Linux 可使用：

```shell
pacman -Q glibc glib2 gtk3
```

较新的内核不能替代缺失或版本过低的用户空间库，安装前请逐项核对。