v2fly/fhs-install-v2ray — explained in plain English
Analysis updated 2026-06-24
Install V2Ray on a Debian, CentOS, or Fedora server as a systemd service that survives reboots
Update only the V2Ray geographic routing data files without reinstalling or restarting the binary
Remove a V2Ray installation cleanly from a Linux server using the script's uninstall flag
Set up a network proxy on a VPS with all files in standard Linux filesystem locations for easy management
| v2fly/fhs-install-v2ray | spiritlhls/ecs | dunwu/linux-tutorial | |
|---|---|---|---|
| Stars | 6,786 | 6,803 | 6,759 |
| Language | Shell | Shell | Shell |
| Setup difficulty | moderate | easy | easy |
| Complexity | 2/5 | 1/5 | 1/5 |
| Audience | ops devops | ops devops | ops devops |
Figures from each repo's GitHub metadata at analysis time.
The script does not generate a config.json, you must write your own V2Ray configuration after installation before the service will work.
This repository contains a shell script that installs V2Ray on Linux servers running systemd, the init system used by Debian, CentOS, Fedora, openSUSE, and similar distributions. V2Ray is a network proxy tool used to route internet traffic through configurable tunnels and protocols. The script follows the Filesystem Hierarchy Standard, a convention for where programs and their data should be placed on a Linux system. After running the script, the V2Ray binary lands at /usr/local/bin/v2ray, the configuration file at /usr/local/etc/v2ray/config.json, geographic data files at /usr/local/share/v2ray/, and log files at /var/log/v2ray/. Two systemd service unit files are also installed so V2Ray can be started, stopped, and set to run automatically on boot using the standard service management commands. Three operations are supported. The main install script downloads and installs both the V2Ray executable and the geographic data files (geoip.dat and geosite.dat). A second script updates only the geographic data files without touching the binary. Passing a remove flag to the main script uninstalls V2Ray. The README notes clearly that the script does not generate a configuration file for you. After installation, writing and editing the config.json file to match your intended setup is something you must do separately, referring to the V2Ray documentation and community-contributed configuration templates. The script is not recommended for use inside Docker containers, the official V2Ray Docker image is the suggested path there instead. The README is written primarily in Traditional Chinese, with the core usage commands provided in English. A simplified Chinese README is available in a separate file in the same repository.
A shell script that installs V2Ray, a network proxy tool, on Linux servers running systemd, placing all files in standard locations and registering it as a service that starts automatically on boot.
Mainly Shell. The stack also includes Shell, systemd.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
Verify against the repo before relying on details.