# Install v2ray

Platform for building proxies to bypass network restrictions. Version 5.49.0 via Homebrew; verified 2026-05-17.

## Install

```sh
sudo av install brew:v2ray
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install v2ray
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install v2ray
```

  Evidence: MacPorts ports tree: net/v2ray/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add v2ray
```

  Evidence: Alpine Linux edge package indexes: v2ray from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install v2ray
```

  Evidence: Debian stable package indexes: v2ray from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#v2ray
```

  Evidence: nixpkgs package indexes: pkgs/by-name/v2/v2ray/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S v2ray
```

  Evidence: Arch Linux sync databases: v2ray from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install v2ray-core
```

  Evidence: openSUSE Tumbleweed package metadata: v2ray-core from https://download.opensuse.org/tumbleweed/repo/oss/repodata/155b97171d05e27afd950b6fe0d55513ff38f4597110664535bceedc680bbe6fd459f0733718dcc21dcf0efc7c8250fd1390c73d4790b42e62fb2c16a87242e5-primary.xml.zst

### Windows

- Chocolatey (92%):

```sh
choco install v2ray
```

  Evidence: Chocolatey community package catalog: v2ray from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','ultrasearch'

- Scoop (92%):

```sh
scoop install main/v2ray
```

  Evidence: Scoop official bucket manifest trees: bucket/v2ray.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id v2fly.v2ray-core -e
```

  Evidence: Windows Package Manager source index: v2fly.v2ray-core from https://cdn.winget.microsoft.com/cache/source.msix

## Package Facts

- **Package key:** brew:v2ray
- **Package manager:** Homebrew
- **Package manager URL:** <https://formulae.brew.sh/formula/v2ray>
- **Version:** 5.49.0
- **Source summary:** Platform for building proxies to bypass network restrictions
- **Homepage:** <https://v2fly.org/>
- **Repository:** <https://github.com/v2fly/v2ray-core>
- **Upstream docs:** <https://v2fly.org/>
- **License:** MIT AND CC-BY-SA-4.0
- **Source archive:** <https://github.com/v2fly/v2ray-core/archive/refs/tags/v5.49.0.tar.gz>
- **Last updated:** 2026-05-17T20:24:17Z
- **Generated:** 2026-06-10T07:18:26+00:00

## Executables

- v2ray (cli)
- v2ray (alias)

## Build Dependencies

- go

## Install Behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-06-10
- Package-manager version: 5.49.0
- Package-manager updated: 2026-05-17
- Local data status: ok
- Upstream repository: https://github.com/v2fly/v2ray-core
- Upstream latest detected: v5.49.0 (current)

## セキュリティノート

formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** v2ray
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - v2ray - 4.34.0+ds-4+b12: normalized package name match | Debian stable package indexes: v2ray from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Command line tool for golang-v2ray-core | https://github.com/v2fly/v2ray-core
- Nix - v2ray: normalized package name match | nixpkgs package indexes: pkgs/by-name/v2/v2ray/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - v2ray - 4.34.0+ds-4: normalized package name match | Ubuntu 24.04 LTS package indexes: v2ray from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Command line tool for golang-v2ray-core | https://github.com/v2fly/v2ray-core
- apk - v2ray - 5.47.0-r2: normalized package name match | Alpine Linux edge package indexes: v2ray from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A platform for building proxies to bypass network restrictions | https://v2fly.org
- apk - v2ray-openrc - 5.47.0-r2: normalized package name match | Alpine Linux edge package indexes: v2ray-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A platform for building proxies to bypass network restrictions (OpenRC init scripts) | https://v2fly.org
- pacman - v2ray - 5.49.0-1: normalized package name match | Arch Linux sync databases: v2ray from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A platform for building proxies to bypass network restrictions | https://github.com/v2fly/v2ray-core
- zypper - v2ray-core - 5.47.0-1.2: normalized package name match | openSUSE Tumbleweed package metadata: v2ray-core from https://download.opensuse.org/tumbleweed/repo/oss/repodata/155b97171d05e27afd950b6fe0d55513ff38f4597110664535bceedc680bbe6fd459f0733718dcc21dcf0efc7c8250fd1390c73d4790b42e62fb2c16a87242e5-primary.xml.zst | Network tools for building a computer network | https://github.com/v2fly/v2ray-core
- MacPorts - v2ray: normalized package name match | MacPorts ports tree: net/v2ray/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Chocolatey - v2ray: normalized package name match | Chocolatey community package catalog: v2ray from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','ultrasearch'
- Scoop - main/v2ray: normalized package name match | Scoop official bucket manifest trees: bucket/v2ray.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - v2fly.v2ray-core: normalized package name match | Windows Package Manager source index: v2fly.v2ray-core from https://cdn.winget.microsoft.com/cache/source.msix


## Related Links

- [Secret-risk packages](https://www.automicvault.com/ja/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/ja/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/ja/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/ja/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://www.automicvault.com/ja/pkg/brew/go/) - Build dependency declared by Homebrew.
- [connect](https://www.automicvault.com/ja/pkg/brew/connect/) - Shares av.db curated category or tags: cli, networking, proxy, tunneling.
- [trojan-go](https://www.automicvault.com/ja/pkg/brew/trojan-go/) - Shares av.db curated category or tags: cli, networking, proxy, tunneling.
- [pwnat](https://www.automicvault.com/ja/pkg/brew/pwnat/) - Shares av.db curated category or tags: cli, networking, proxy, tunneling.
- [sshuttle](https://www.automicvault.com/ja/pkg/brew/sshuttle/) - Shares av.db curated category or tags: cli, networking, proxy, tunneling.
- [sing-box](https://www.automicvault.com/ja/pkg/brew/sing-box/) - Shares av.db curated category or tags: cli, networking, proxy.
- [proxychains-ng](https://www.automicvault.com/ja/pkg/brew/proxychains-ng/) - Shares av.db curated category or tags: cli, networking, proxy.
- [xray](https://www.automicvault.com/ja/pkg/brew/xray/) - Shares av.db curated category or tags: cli, networking, proxy.
- [squid](https://www.automicvault.com/ja/pkg/brew/squid/) - Shares av.db curated category or tags: cli, networking, proxy.
- [corkscrew](https://www.automicvault.com/ja/pkg/brew/corkscrew/) - Local package facts share a topical domain. Shared terms: cli, networking, proxies, proxy, tunneling.

## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
