# Install xray with Homebrew, apk, MacPorts, Nix, scoop, winget Platform for building proxies to bypass network restrictions. Version 26.3.27 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:xray ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install xray ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install xray ``` Evidence: 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 ``` Evidence: 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 ``` Evidence: 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 ``` Evidence: 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 ``` Evidence: Windows Package Manager source index: XTLS.Xray-core from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:xray - **Package manager:** Homebrew - **Package manager page:** - **Version:** 26.3.27 - **Source summary:** Platform for building proxies to bypass network restrictions - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MPL-2.0 AND CC-BY-SA-4.0 - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - xray (cli) - xray (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Service: declared - Caveats: An example config is installed to $HOMEBREW_PREFIX/etc/xray/config.json - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 26.3.27 - Local data: ok - Upstream repository: https://github.com/XTLS/Xray-core - Upstream latest detected: v26.3.27 (current) - info: No package-manager update timestamp was available. ## Project history and usage 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. ### Project history 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. ### Adoption history 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. ### How it is used 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. ### Why package nerds care 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. ### Timeline - 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. ### Sources - - - - - - - ## Security Notes broad file, network, media, or database tool signal. formula declares a Homebrew service. - **Geiger risk:** orange / medium - broad file, network, media, or database tool signal - formula declares a Homebrew service ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** xray - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - 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-r0: normalized package name match | Alpine Linux edge package indexes: xray from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Platform for building proxies to bypass network restrictions | 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 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [geph4](https://www.automicvault.com/pkg/brew/geph4/) - Shares av.db curated category or tags: cli, networking, privacy, proxy. - [brook](https://www.automicvault.com/pkg/brew/brook/) - Shares av.db curated category or tags: cli, networking, proxy. - [connect](https://www.automicvault.com/pkg/brew/connect/) - Shares av.db curated category or tags: cli, networking, proxy. - [dante](https://www.automicvault.com/pkg/brew/dante/) - Shares av.db curated category or tags: cli, networking, proxy. - [ghostunnel](https://www.automicvault.com/pkg/brew/ghostunnel/) - Shares av.db curated category or tags: cli, networking, proxy. - [gost](https://www.automicvault.com/pkg/brew/gost/) - Shares av.db curated category or tags: cli, networking, proxy. - [hysteria](https://www.automicvault.com/pkg/brew/hysteria/) - Shares av.db curated category or tags: cli, networking, proxy. - [libproxy](https://www.automicvault.com/pkg/brew/libproxy/) - Shares av.db curated category or tags: cli, networking, proxy. - [v2ray](https://www.automicvault.com/pkg/brew/v2ray/) - Local metadata places this package in an adjacent workflow. Shared terms: building, bypass, cli, network, networking. ## Combined YAML source View the package source record on GitHub. [combined/xray.yml](https://github.com/automic-vault/db/blob/main/combined/xray.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph