# V2Ray

Bash script for installing V2Ray in operating systems such as Debian / CentOS / Fedora / openSUSE that support systemd

Repository: https://github.com/v2fly/fhs-install-v2ray
Canonical: https://ross.abutalabs.com/products/v2ray
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: v2ray, installer, script
Last push: 2024-11-05T11:40:15+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2365, "days_push": 666, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6802, forks 1466 (observed 2026-08-28T04:09:48.706451+00:00)

## What it is
An official Bash installer script (plus community config examples) that installs and manages V2Ray, a network proxy platform, on systemd-based Linux distributions such as Debian, CentOS, Fedora, and openSUSE. It follows the Filesystem Hierarchy Standard, installing the v2ray/v2ctl binaries, geoip/geosite data files, config, logs, and systemd service units, and supports updating data files or fully removing the installation.

## Use cases
- install v2ray on debian or centos
- set up a v2ray proxy server on linux
- update geoip.dat and geosite.dat files for v2ray
- cleanly uninstall v2ray from a server
- create systemd service for v2ray
- configure vless protocol with v2ray
- bypass internet censorship using a self-hosted proxy

## When to choose
- You need to install, update, or remove V2Ray on a systemd-based Linux distribution with an FHS-compliant layout
- You only want to refresh the geoip.dat/geosite.dat routing data without touching the binaries
- You want sample server/client config templates (from v2ray-examples) to adapt for protocols like VLESS

## When to avoid
- You plan to run V2Ray in Docker - the maintainers direct you to the official v2fly/docker image instead
- You expect the script to generate a ready-to-use config for you - it explicitly only handles the installation stage
- Your system does not use systemd, such as Alpine, macOS, or BSD

## Facets
- artifact type: cli-tool
- maturity: active
- function: proxy, networking, privacy, deployment, developer-tools
- domain: privacy, censorship-circumvention, security, networking, self-hosted, developer-tools
- platform: cli, self-hosted
- tags: v2ray, installer, shell-script, systemd, proxy-server, geoip, geosite, fhs, vless, vmess, config-examples, command-line, linux

## Member repositories
- v2fly/fhs-install-v2ray (infra) score 32
- v2fly/v2ray-examples (examples) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:48.706451+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:42:05.067902+00:00, confidence not recorded.
  - readme: https://github.com/v2fly/fhs-install-v2ray (fetched 2026-08-28T04:09:48.706451+00:00, sha 047b59df007c)
- Data as of 2026-08-30T08:39:29.467469+00:00.