Stop Reconfiguring V2Ray by Hand: This Script Does It in Under a Second

If you've ever managed a V2Ray server, you know the drill: set up the config, edit JSON by hand, restart the service, and pray you didn't break a bracket somewhere. Then you need to add a new protocol, change a port, or rotate a UUID, and you're back to the same tedious cycle. There's a better way. The 233boy/v2ray project is a one-click install and management script that collapses all that fiddly work into single commands—so fast that adding a config genuinely takes under a second.

What It Does

This is a shell script that installs V2Ray on your server and then gives you a command-line tool called v2ray to manage everything afterward. It's not a GUI or a web panel—it's a terminal-first utility that wraps the entire V2Ray lifecycle into a tight set of commands.

The core design philosophy is "high efficiency, ultra-fast, extremely easy to use." The script is built around running multiple configs simultaneously, and it's optimized specifically for the four operations you'll do most: add, change, view, and delete. Under the hood, it uses the V2Ray API for operations, automates TLS setup, and even handles things like enabling BBR and blocking BitTorrent or Chinese IPs. It supports all the common protocols: VMess, VLESS, Trojan, Shadowsocks, and various transport combinations like WS, H2, gRPC, TCP, mKCP, and QUIC—plus dynamic port support.

Why It's Cool

The most striking thing about this script is how deliberately it treats the command-line experience. This isn't a wrapper that just dumps you into a menu system. It's a full command suite with flags, subcommands, and auto-generated values.

• Zero learning curve, by design. The README explicitly lists "zero learning cost" as a feature. You don't need to memorize V2Ray's config schema. Want to add a new VMess over WebSocket with TLS? It's literally v2ray add vmess-ws-tls and you're done. The script auto-generates ports, UUIDs, and paths if you don't specify them.

• Every common operation is one command. Changing a port? v2ray change <name> port. Rotating a UUID? v2ray change <name> id. Swapping the camouflage website? v2ray change <name> web. There's even a full command to batch-change multiple parameters at once. The del and ddel commands are intentionally unconfirmed—the script trusts you to know what you're doing, which is refreshing.

• It's API-driven, not file-edit-driven. The script uses the V2Ray API to make changes, which means you're not manually editing JSON and hoping the daemon picks it up. It also has a fix command to repair a broken config and fix-all to repair everything, which is a lifesaver when you've been experimenting.

• Built-in conveniences you didn't know you needed. One command to enable BBR. One command to change the camouflage website. One command to view a QR code for a config so you can scan it into a mobile client. The script even has a gen command that shows you the JSON without actually creating a file—perfect for testing before committing.

• It respects the underlying tool. The script is "compatible with V2Ray commands," meaning you can still run things like v2ray bin help or v2ray api directly. It's not a walled garden; it's a convenience layer that knows when to get out of the way.

How to Try It

The project is a shell script, so you'll need a Linux server (or a VPS) with root access. The README points to a wiki with detailed installation and setup tutorials, but the core usage is straightforward once installed.

To get started, head over to the repository and follow the installation instructions in the wiki. After installation, you'll have the v2ray command available. Start by checking the help screen:

v2ray help

That gives you the full command reference. To add your first config, you can just run:

v2ray add auto

The auto flag lets the script pick sensible defaults for you. Or you can be specific:

v2ray add vmess-ws-tls

That adds a VMess config over WebSocket with automatic TLS setup. To see what you just created:

v2ray info <name>

And to get a QR code for your phone:

v2ray qr <name>

The README also mentions a detailed photo tutorial in the wiki for the full setup process, which is worth reading if you're new to V2Ray.

Final Thoughts

This script is clearly built by someone who got tired of the same repetitive V2Ray management tasks and decided to fix it properly. If you're running a VPS with V2Ray and you manage more than one config, this will save you real time—the difference between editing JSON by hand and running v2ray change <name> port is night and day. It's also a great learning tool, since the debug and gen commands let you see exactly what config is being generated without committing to it.

It's not a GUI, so if you prefer clicking buttons, this isn't for you. But if you live in the terminal and want a script that respects your time, the 233boy/v2ray script is worth a serious look.

Follow @githubprojects for more developer tools and open source projects.