# 使用 Homebrew, apk, MacPorts, Nix, scoop, winget 安装 xray
查看 xray 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。
## 安装
```sh
sudo av install brew:xray
```
其他安装命令:
### macOS
- Homebrew (100%):
```sh
brew install xray
```
证据: local Homebrew formula metadata
- MacPorts (94%):
```sh
sudo port install xray
```
证据: MacPorts ports tree: net/xray/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
### Linux
- apk (92%):
```sh
sudo apk add xray
```
证据: Alpine Linux edge package indexes: xray from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz
- Nix (92%):
```sh
nix profile install nixpkgs#xray
```
证据: nixpkgs package indexes: pkgs/by-name/xr/xray/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
### Windows
- Scoop (92%):
```sh
scoop install main/xray
```
证据: Scoop official bucket manifest trees: bucket/xray.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget (92%):
```sh
winget install --id XTLS.Xray-core -e
```
证据: Windows Package Manager source index: XTLS.Xray-core from https://cdn.winget.microsoft.com/cache/source.msix
## 软件包事实
- **软件包键:** brew:xray
- **软件包管理器:** Homebrew
- **版本:** 26.3.27
- **来源摘要:** Platform for building proxies to bypass network restrictions
- **主页:**
- **仓库:**
- **最后更新:** 2026-07-25T21:49:10+02:00
- **已生成:** 2026-08-03T19:37:03+00:00
## 可执行文件
- xray (别名)
## 安装行为
- Bottle: 不可用
## 版本和新鲜度
- 页面生成时间: 2026-08-03
- 管理器版本: 26.3.27
## 项目历史与用法
Xray-core is the Go networking core of Project X, a proxy and anti-censorship toolkit descended from v2ray-core and centered on XTLS, VLESS, REALITY, routing, DNS, and composable transports.
### 项目历史
The Xray-core README says Project X originates from the XTLS protocol and provides tools such as Xray-core and REALITY. It also explicitly credits Xray-core v1.0.0 as a fork of v2fly-core commit 9a03cc5, after which the project accumulated many independent enhancements.
The v1.0.0 release in November 2020 framed the fork as a new beginning. Its notes said Xray-core was heavily modified from v2ray-core, merged ctl functionality into one executable, kept similar configuration ideas, changed environment/API naming to XRAY, exposed raw protocol ReadV across platforms, and provided VLESS and Trojan XTLS support.
The official documentation now cautions that Xray-core has evolved independently for a long time and should not be treated as a fully compatible v2ray-core drop-in replacement. It highlights complete support for VLESS, XTLS Vision, REALITY, multiple XTLS flow-control modes, and performance work such as Splice in suitable scenarios.
### 采用历史
Xray's adoption is broad inside the censorship-circumvention and proxy-client ecosystem. The README lists official installation routes, Docker images, web panels, one-click installers, Magisk packages, Homebrew, many GUI clients across OpenWrt, Windows, Android, iOS, macOS, Linux, and HarmonyOS, plus wrappers and downstream cores.
Its ecosystem grew around protocols and deployment recipes rather than a single UI. The Xray-examples repository, REALITY examples, VLESS-XTLS-Vision examples, install scripts, and GUI clients show that users usually consume Xray-core as an engine under profiles, panels, routers, mobile apps, or server setup scripts.
### 使用方式
Practical usage is configuration-driven. Operators define inbound and outbound protocols, routing and DNS rules, transport settings, fallbacks, TLS or REALITY behavior, and platform-specific service wrappers; the xray executable then runs the core proxy service.
Common package-manager users install xray when they want the core binary on macOS, Linux, routers, servers, or CI-built images. More casual users often encounter it indirectly through clients such as v2rayN, v2rayNG, OpenWrt passwall packages, or web panels that generate configuration.
### 为什么软件包爱好者会关心
Xray is significant because it is both a single package and a protocol ecosystem. The Homebrew formula points at one executable, but the surrounding package graph includes install scripts, Docker images, GUI wrappers, router packages, mobile clients, panels, example repositories, and protocol documentation.
It is also a modern example of infrastructure software whose history matters for compatibility. Knowing that Xray branched from v2ray-core but evolved independently explains why configs may look familiar while APIs, environment variables, protocols, and operational assumptions differ.
### 时间线
- 2020-11-25: Xray-core v1.0.0 was published as a fork-derived new beginning from v2fly-core.
- 2023-03-09: Xray-core v1.8.0 release notes introduced REALITY material and XTLS Vision security changes.
- 2025-2026: The project moved to date-like release numbering such as v25.x and v26.x in GitHub releases.
- 2026-06-27: GitHub lists Xray-core v26.6.27 among current releases.
### Related projects
- v2ray-core and v2fly-core: the upstream lineage from which Xray-core branched.
- XTLS, VLESS, XTLS Vision, REALITY, XUDP, and XHTTP: protocol and transport work central to Project X.
- XTLS/Xray-examples and XTLS/REALITY: official example and protocol repositories used by operators.
- v2rayN, v2rayNG, PassWall, Marzban, Hiddify, and related clients or panels: common downstream ways people operate Xray-core.
### 来源
-
-
-
-
-
-
-
## 安全说明
broad file, network, media, or database tool signal. formula declares a Homebrew service.
- **Geiger 风险:** orange / 中
- broad file, network, media, or database tool signal
- formula declares a Homebrew service
## 其他软件包管理器记录
- Nix - xray: normalized package name match | nixpkgs package indexes: pkgs/by-name/xr/xray/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - xray - 26.3.27-r2: normalized package name match | Alpine Linux edge package indexes: xray from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Unified platform for anti-censorship | https://github.com/XTLS/Xray-core
- apk - xray-doc - 26.3.27-r2: normalized package name match | Alpine Linux edge package indexes: xray-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Unified platform for anti-censorship (documentation) | https://github.com/XTLS/Xray-core
- apk - xray-openrc - 26.3.27-r2: normalized package name match | Alpine Linux edge package indexes: xray-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Unified platform for anti-censorship (OpenRC init scripts) | https://github.com/XTLS/Xray-core
- MacPorts - xray: normalized package name match | MacPorts ports tree: net/xray/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/xray: normalized package name match | Scoop official bucket manifest trees: bucket/xray.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - XTLS.Xray-core: normalized package name match | Windows Package Manager source index: XTLS.Xray-core from https://cdn.winget.microsoft.com/cache/source.msix
## Combined YAML source
View the package source record on GitHub. [combined/xray.yml](https://github.com/mxcl/pkgdb/blob/main/combined/xray.yml)
## 来源
- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph