whatisgithub

What is fhs-install-v2ray?

v2fly/fhs-install-v2ray — explained in plain English

Analysis updated 2026-06-24

6,786ShellAudience · ops devopsComplexity · 2/5Setup · moderate

In one sentence

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.

Mindmap

mindmap
  root((fhs-install-v2ray))
    What it does
      Install V2Ray
      Manage service
      Update geo data
    Tech stack
      Shell script
      systemd
      Linux
    File locations
      Binary in local bin
      Config in local etc
      Logs in var log
    Use cases
      Proxy server setup
      VPS configuration
      Service management
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Install V2Ray on a Debian, CentOS, or Fedora server as a systemd service that survives reboots

USE CASE 2

Update only the V2Ray geographic routing data files without reinstalling or restarting the binary

USE CASE 3

Remove a V2Ray installation cleanly from a Linux server using the script's uninstall flag

USE CASE 4

Set up a network proxy on a VPS with all files in standard Linux filesystem locations for easy management

What is it built with?

Shellsystemd

How does it compare?

v2fly/fhs-install-v2rayspiritlhls/ecsdunwu/linux-tutorial
Stars6,7866,8036,759
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity2/51/51/5
Audienceops devopsops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

The script does not generate a config.json, you must write your own V2Ray configuration after installation before the service will work.

So what is it?

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.

Copy-paste prompts

Prompt 1
Run the fhs-install-v2ray script on my Debian server, then show me a minimal config.json that runs V2Ray as an inbound VMESS proxy on port 443.
Prompt 2
After running fhs-install-v2ray, configure systemd to automatically restart V2Ray if the process crashes, and verify the setting is active.
Prompt 3
Use the geo data update script from fhs-install-v2ray to refresh geoip.dat and geosite.dat on a server where V2Ray is already running.
Prompt 4
I installed V2Ray with fhs-install-v2ray and want to write a config.json that routes traffic through an outbound VMESS connection to a remote server.

Frequently asked questions

What is fhs-install-v2ray?

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.

What language is fhs-install-v2ray written in?

Mainly Shell. The stack also includes Shell, systemd.

How hard is fhs-install-v2ray to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fhs-install-v2ray for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.