# Installer xray avec Homebrew, apk, MacPorts, Nix, scoop, winget Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de xray pour les workflows d'agents IA. ## installation ```sh sudo av install brew:xray ``` Commandes d'installation supplémentaires: ### macOS - Homebrew (100%): ```sh brew install xray ``` Preuve: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install xray ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: Windows Package Manager source index: XTLS.Xray-core from https://cdn.winget.microsoft.com/cache/source.msix ## Faits du paquet - **Clé du paquet:** brew:xray - **Gestionnaire de paquets:** Homebrew - **Version:** 26.3.27 - **Résumé source:** Platform for building proxies to bypass network restrictions - **Page d'accueil:** - **Dépôt:** - **Dernière mise à jour:** 2026-07-25T21:49:10+02:00 - **Généré:** 2026-08-03T19:37:03+00:00 ## exécutables - xray (alias) ## Comportement d'installation - Bouteille: non disponible ## Version et fraîcheur - page générée: 2026-08-03 - version du gestionnaire: 26.3.27 ## Historique du projet et usages 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. ### Historique du projet 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. ### Historique d'adoption 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. ### Modes d'utilisation 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. ### Pourquoi les passionnés de paquets s'y intéressent 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. ### Chronologie - 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 - - - - - - - ## Notes de sécurité broad file, network, media, or database tool signal. formula declares a Homebrew service. - **Risque Geiger:** orange / moyen - broad file, network, media, or database tool signal - formula declares a Homebrew service ## Autres enregistrements de gestionnaires de paquets - 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) ## Sources - 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