How to install v2ray on debian

Installing V2Ray on Debian is simple if you follow the right steps. Here’s how to get it up and running in just a few commands.

Step 1: Update System Packages

Before anything else, make sure your system is up-to-date:

sudo apt update && sudo apt upgrade -y

Step 2: Install Required Dependencies

You’ll need curl and unzip if they’re not already installed:

sudo apt install curl unzip -y

Step 3: Download and Run the Official V2Ray Installation Script

V2Ray provides an official shell script that handles installation automatically:

bash <(curl -L -s https://raw.githubusercontent.com/v2fly/fhs-install-v2ray/master/install-release.sh)

This script downloads the latest version, installs binaries, sets up systemd service files, and puts configuration files in /usr/local/etc/v2ray.

Step 4: Configure V2Ray

Edit the main config file:

sudo nano /usr/local/etc/v2ray/config.json

A minimal example configuration (replace with your actual UUID and preferred port):

{
  "inbounds": [{
    "port": 443,
    "protocol": "vmess",
    "settings": {
      "clients": [
        {
          "id": "YOUR-UUID-HERE",
          "alterId": 0
        }
      ]
    },
    "streamSettings": {
      "network": "tcp"
    }
  }],
  "outbounds": [{
    "protocol": "freedom",
    "settings": {}
  }]
}

Generate a UUID if needed:

uuidgen

Step 5: Enable and Start V2Ray Service

Once configured, reload the daemon and start V2Ray:

sudo systemctl daemon-reexec
sudo systemctl enable v2ray
sudo systemctl start v2ray

Check if it’s running:

sudo systemctl status v2ray

Step 6: Allow the Port Through Firewall (if enabled)

If you use ufw, allow the port you specified in your config:

sudo ufw allow 443/tcp