Linux Setup Guide

Supported Apps

Linux users can choose between a GUI client (Hiddify, Happ) or the command-line v2ray-core for full control.

Your VLESS Link

Get your VLESS link from the Hue VPN dashboard.

https://sub.huevpn.com/4853285291/sub/mmlwxrmn8ouhkemj

Setup: v2ray-core (CLI)

For servers, headless setups, or power users who prefer full control, v2ray-core with a JSON config file is the most flexible option.

1. 1
   Install v2ray using the official script

   bash — one-line installer Copy

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

   Or download a binary manually from GitHub Releases and extract to /usr/local/bin/.

2. 2
   Create the configuration file

   Create /usr/local/etc/v2ray/config.json with the content shown in the config.json section below.

   bash Copy

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

3. 3
   Test the configuration

   bash Copy

   v2ray run -config /usr/local/etc/v2ray/config.json

   If v2ray starts without errors, the configuration is valid. Press Ctrl+C to stop.

4. 4
   Enable and start the systemd service

   bash Copy

   sudo systemctl enable v2ray
   sudo systemctl start v2ray
   sudo systemctl status v2ray

5. 5
   Configure your system or browser to use the proxy

   v2ray-core creates a local SOCKS5 proxy at 127.0.0.1:10808 and HTTP proxy at 127.0.0.1:10809 (configurable in config.json). Configure your browser or system settings to use these.

   bash — set system proxy (GNOME) Copy

   gsettings set org.gnome.system.proxy mode 'manual'
   gsettings set org.gnome.system.proxy.socks host '127.0.0.1'
   gsettings set org.gnome.system.proxy.socks port 10808

config.json

Complete v2ray configuration file for VLESS over WebSocket + TLS. Replace YOUR-UUID-HERE with your UUID from the Hue VPN dashboard.

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "socks",
      "port": 10808,
      "listen": "127.0.0.1",
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    },
    {
      "tag": "http",
      "port": 10809,
      "listen": "127.0.0.1",
      "protocol": "http",
      "settings": {}
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "server.huevpn.com",
            "port": 443,
            "users": [
              {
                "id": "YOUR-UUID-HERE",
                "encryption": "none",
                "flow": ""
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "server.huevpn.com",
          "fingerprint": "chrome",
          "allowInsecure": false
        },
        "wsSettings": {
          "path": "/vless",
          "headers": {
            "Host": "server.huevpn.com"
          }
        }
      }
    },
    {
      "tag": "direct",
      "protocol": "freedom"
    },
    {
      "tag": "block",
      "protocol": "blackhole"
    }
  ],
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

systemd Service (auto-start)

If the official install script was not used, create the service file manually:

[Unit]
Description=V2Ray Service
Documentation=https://www.v2fly.org/en_US/
After=network.target nss-lookup.target

[Service]
User=nobody
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
NoNewPrivileges=true
ExecStart=/usr/local/bin/v2ray run -config /usr/local/etc/v2ray/config.json
Restart=on-failure
RestartPreventExitStatus=23

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable v2ray
sudo systemctl start v2ray

Setup: Happ

1. 1
   Download Happ AppImage

   GitHub Releases
2. 2
   Make executable and run

   bash Copy

   chmod +x Happ-linux-x64.AppImage
   ./Happ-linux-x64.AppImage

3. 3
   Import your VLESS link and connect

   In the Happ window, click Add Proxy, paste your VLESS URL, and click Connect.