explaingit

yeahwu/v2ray-wss

Analysis updated 2026-05-18

3,638ShellAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

A one command shell script that sets up several encrypted proxy protocols, like V2ray and Hysteria2, on a Linux server to route internet traffic through it.

Mindmap

mindmap
  root((repo))
    What it does
      Installs proxy protocols
      One command setup
    Tech stack
      Shell script
      Nginx
      V2ray
    Use cases
      Domain based proxy
      No domain proxy
    Audience
      Server admins
      Privacy users

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

Set up an encrypted proxy on a server you own without a domain name using Reality or Hysteria2.

USE CASE 2

Set up a domain based V2ray plus WebSocket proxy that looks like normal encrypted web traffic.

USE CASE 3

Retrieve saved client connection files to configure a proxy client device after install.

What is it built with?

ShellNginxV2rayShadowsocksHysteria2

How does it compare?

yeahwu/v2ray-wss34306/vphone-aioapple/tensorflow_macos
Stars3,6383,6323,653
LanguageShellShellShell
Setup difficultymoderatehardmoderate
Complexity3/53/53/5
Audienceops devopsdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Linux VPS with root access, and a domain name for the V2ray/WSS and HTTPS proxy options.

In plain English

This is a shell script that installs and configures several proxy server protocols on a Linux machine in one step. The protocols it can set up include V2ray paired with Nginx and WebSocket, which disguises proxy traffic as normal web traffic, along with Shadowsocks-rust, Reality (using the xtls-rprx-vision method), Hysteria2, and a plain HTTPS forward proxy. These protocols are commonly used to route internet traffic through a server in a different location, often to reach sites or services that are blocked in the user's own country. The script runs on Debian, Ubuntu, and CentOS, and the README lists specific tested versions of each, including support for ARM based servers. Installation is a single command that downloads the script with wget and runs it with bash, after which an interactive setup walks the server owner through the choices. The README, written in Chinese, explains two main paths depending on what the server owner has available. If you do not own a domain name, the script can set up Reality or Hysteria2, which do not need one. If you do own a domain, you can instead set up V2ray with WebSocket or the HTTPS forward proxy, both of which rely on a domain to look like ordinary encrypted web traffic. Once installed, the connection details a client needs are saved as JSON files on the server, and the README gives the exact file path for each protocol, such as the V2ray, Shadowsocks, Reality, Hysteria2, and HTTPS proxy client configs. A separate linked page covers how to uninstall everything. The README also reminds anyone who cannot connect to first check whether the server's own firewall is blocking the port before assuming something else is wrong. The README itself is short and mostly practical: command, file paths, and a link to a recommended VPS provider.

Copy-paste prompts

Prompt 1
Walk me through running this script on a fresh Debian or Ubuntu server.
Prompt 2
Explain the difference between the Reality and V2ray plus WebSocket setup options in this script.
Prompt 3
Help me find and read the client config file for the protocol I installed with this script.

Frequently asked questions

What is v2ray-wss?

A one command shell script that sets up several encrypted proxy protocols, like V2ray and Hysteria2, on a Linux server to route internet traffic through it.

What language is v2ray-wss written in?

Mainly Shell. The stack also includes Shell, Nginx, V2ray.

How hard is v2ray-wss to set up?

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

Who is v2ray-wss for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.