# 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 - **Page du gestionnaire de paquets:** - **Version:** 26.3.27 - **Résumé source:** Platform for building proxies to bypass network restrictions - **Page d'accueil:** - **Dépôt:** - **Docs amont:** - **Licence:** MPL-2.0 AND CC-BY-SA-4.0 - **Archive source:** - **Dernière mise à jour:** 2026-07-25T21:49:10+02:00 - **Généré:** 2026-08-04T22:13:35+00:00 ## exécutables - xray (cli) - xray (alias) ## Dépendances de compilation - go ## Comportement d'installation - hook post-installation: non défini - Service: declared - Précautions: An example config is installed to $HOMEBREW_PREFIX/etc/xray/config.json - Bouteille: disponible sur arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Version et fraîcheur - page générée: 2026-08-04 - version du gestionnaire: 26.3.27 - gestionnaire mis à jour: 2026-07-25 - données locales: OK - dépôt amont: https://github.com/XTLS/Xray-core - dernière version détectée: v26.3.27 (à jour) ## 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 ## Détails de la base source - **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 ## 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 ## Liens liés - [Source-control packages](https://pkg.so/fr/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://pkg.so/fr/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://pkg.so/fr/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://pkg.so/fr/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://pkg.so/fr/brew/go/) - Build dependency declared by Homebrew. - [geph4](https://pkg.so/fr/brew/geph4/) - Shares pkgdb curated category or tags: cli, networking, privacy, proxy. - [sing-box](https://pkg.so/fr/brew/sing-box/) - Shares pkgdb curated category or tags: cli, networking, proxy. - [proxychains-ng](https://pkg.so/fr/brew/proxychains-ng/) - Shares pkgdb curated category or tags: cli, networking, proxy. - [v2ray](https://pkg.so/fr/brew/v2ray/) - Shares pkgdb curated category or tags: cli, networking, proxy. - [squid](https://pkg.so/fr/brew/squid/) - Shares pkgdb curated category or tags: cli, networking, proxy. - [mihomo](https://pkg.so/fr/brew/mihomo/) - Shares pkgdb curated category or tags: cli, networking, proxy. - [libproxy](https://pkg.so/fr/brew/libproxy/) - Shares pkgdb curated category or tags: cli, networking, proxy. - [privoxy](https://pkg.so/fr/brew/privoxy/) - Shares pkgdb curated category or tags: cli, networking, privacy, proxy. - [brook](https://pkg.so/fr/brew/brook/) - Local package facts share a topical domain. Shared terms: cli, networking, platform, proxy. ## 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 - package-page enrichment - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph