Stop Configuring V2Ray by Hand: This Script Turns Setup Into a One-Second Command

If you've ever set up V2Ray manually, you know the drill: install the binary, write a JSON config from memory (or worse, from a tutorial), generate UUIDs, set up TLS certificates, and then pray the service actually starts. It's tedious, error-prone, and every protocol has its own quirks. What if you could add a new proxy config in under a second, manage multiple configs simultaneously, and never touch a config file again? That's exactly what the 233boy/v2ray script aims to deliver.

This is a one-click installation and management script for V2Ray, built around a simple design philosophy: high efficiency, blazing speed, and extreme ease of use. It's not a GUI or a web panel—it's a command-line tool that wraps all the complexity of V2Ray into a handful of intuitive commands.

What It Does

At its core, this script installs V2Ray and gives you a v2ray command to manage everything. The key architectural decision is multi-config support—you can run several proxy configurations simultaneously on the same server, each with its own protocol, port, and settings. The script is built around four core operations: add, change, view, and delete. Each one is designed to complete in under a second.

The script supports all the common V2Ray protocols out of the box. You can one-click add Shadowsocks, VMess over TCP/mKCP/QUIC, VMess with WebSocket/HTTP2/gRPC plus TLS, VLESS with the same transport options, and Trojan variants too. It also handles dynamic ports for VMess, enables BBR, sets up a fake website for camouflage, and lets you change just about any parameter—port, UUID, password, domain, path, encryption method, SNI, you name it.

TLS is fully automated, and the script blocks BitTorrent traffic and China IPs by default. It also exposes an API for programmatic control and stays compatible with standard V2Ray commands, so you can still run v2ray api, v2ray convert, or v2ray tls directly.

Why It's Cool

The most striking thing here is the speed. The README claims you can add a configuration in less than one second, and given how the script is structured, that's believable. The entire CLI is built around short, memorable commands—v2ray a for add, v2ray c for change, v2ray d for delete. No menus, no prompts, no interactive wizards. You pass arguments directly and get results instantly.

• Zero learning curve: The design goal is literally "zero learning cost." If you can type v2ray a vmess-ws-tls auto, you can set up a fully functional TLS-secured VMess proxy. The auto keyword fills in sensible defaults for anything you don't specify.

• Everything is a one-liner: Changing a port? v2ray c myconfig port 8080. Regenerating a UUID? v2ray c myconfig id auto. Updating the core? v2ray u core. The command structure is consistent and predictable across all operations.

• Batch operations built in: You can delete multiple configs at once with v2ray dd name1 name2, or fix all broken configs with a single fix-all command. There's even a test mode that shows what a config would look like without actually creating it—great for experimenting.

• Thoughtful extras: The script can show QR codes and URLs for client configuration, generate debug info, test-run your setup, and even reinstall itself cleanly. It's clear the author built this from real-world usage, not just as a demo.

• No confirmation prompts: Deleting a config with del doesn't ask "are you sure?"—it just does it. That's a design choice that values speed over hand-holding, and it's refreshing for anyone who's tired of clicking through confirmation dialogs.

How to Try It

To get started, head over to the GitHub repository. The README links to a detailed installation guide and a step-by-step tutorial with screenshots, both on the project's wiki.

The installation itself is a standard curl-pipe-to-bash affair, which you can find on the repo page. Once installed, you'll have the v2ray command available. Start by checking the help output:

v2ray help

That prints the full command reference. To add your first config, try something like:

v2ray a vmess-ws-tls auto

That one command sets up a VMess config with WebSocket transport and auto-configured TLS. To see the details of any config:

v2ray i myconfig

To view a QR code for mobile clients:

v2ray qr myconfig

And when you need to tear it down:

v2ray d myconfig

The help output also includes a gen command that works like add but only prints the JSON without creating files—perfect for testing before you commit.

Final Thoughts

This script is clearly built by someone who got tired of the manual V2Ray setup grind and decided to automate every single step. It's opinionated—no confirmation prompts, no hand-holding, just fast commands—but that's exactly what makes it powerful. If you run V2Ray on your own server and manage multiple protocols or clients, this will save you a ton of time. If you're new to V2Ray, the wiki tutorials and the auto keyword make the learning curve surprisingly gentle.

It's not a GUI, and it's not trying to be one. It's a focused, well-designed CLI tool that respects your time. Give it a shot on a test server, add a few configs, and see how quickly you can go from nothing to a fully working multi-protocol proxy setup. You might never hand-edit a V2Ray config again.

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