One Command to Manage Your V2Ray Configs, Because Nobody Wants to Edit JSON by Hand

If you've ever set up V2Ray, you know the drill. You open config.json, scroll through nested objects, try to remember whether the inbound protocol key goes before or after the port, and then spend twenty minutes debugging a missing comma. It's not hard, exactly, but it's tedious—and it gets worse when you're running multiple configurations at once. The v2ray script from 233boy exists to make that whole process go away. Instead of hand-editing files, you run one command.

What It Does

This is a V2Ray installation and management script. It handles the full lifecycle of a V2Ray setup: installing the core, adding configs, changing parameters, viewing what's running, and deleting what you don't need. The script is built around the idea of running multiple configurations simultaneously, and it optimizes specifically for four operations—add, change, view, and delete. Each of those is a single command.

Under the hood, it manages V2Ray itself along with Caddy for TLS, and it exposes a command-line interface that wraps the underlying complexity. You get a v2ray command with subcommands for everything from adding a Trojan config to enabling BBR to checking the running status. It also stays compatible with the native V2Ray command, so you can drop down to v2ray bin or v2ray api when you need to.

The supported protocols cover the usual ground: Shadowsocks, VMess over TCP, mKCP, QUIC, WebSocket, HTTP/2, and gRPC, VLESS with TLS, and Trojan with TLS. Dynamic ports are supported for VMess over TCP, mKCP, and QUIC.

Why It's Cool

• Speed is the whole point. The README claims adding a config takes under a second, and that's not just marketing—the script is designed so that every common operation is a single command with sensible defaults. You don't walk through a wizard. You type v2ray add trojan and it's done.

• The command structure is genuinely well thought out. Look at the help output and you'll see the parameters are organized by frequency of use: basic commands first, then general operations (add, change, delete, info), then specific change commands, then advanced and management stuff. The short aliases (a for add, c for change, d for del, i for info) mean you're not typing long words over SSH.

• It handles TLS for you. Automatic TLS configuration is listed as a core feature, and there's a no-auto-tls variant if you want to configure it yourself. For anyone who's fought with certificate renewal scripts, this alone is worth the install.

• The auto keyword everywhere. Most change commands accept auto as an argument—v2ray id [name] auto regenerates a UUID, v2ray port [name] auto picks a free port. It's a small design choice that removes a lot of guesswork.

• Extras that show someone actually uses this. Blocking BitTorrent traffic, blocking Chinese IPs, a one-command BBR enable, the ability to change the camouflage website. These aren't afterthoughts—they're the things you'd otherwise script yourself.

• Testing and debugging tools. Commands like gen, genc, client, and debug let you generate JSON without writing files or inspect what the script would produce. That's useful when you're trying to understand what's actually being configured.

How to Try It

The script installs with a single command (check the repository for the current install line, since these change). Once installed, you interact with it through the v2ray command.

1. Install the script by following the instructions in the repository or the installation wiki page.

2. Add a configuration. For example, to add a Trojan config with automatic TLS:

v2ray add trojan

1. View what you've got:

v2ray info

1. Generate a client URL or QR code to import into your client:

v2ray url [name]
v2ray qr [name]

1. If you need to change something, use the specific change command:

v2ray port [name] auto
v2ray id [name] auto

1. Run v2ray help to see the full command list. It's worth reading through—there are a lot of options, and the help output is the most complete reference.

The README links to a detailed setup tutorial with screenshots if you want more hand-holding.

Final Thoughts

This script is for people who run V2Ray regularly and are tired of managing config files by hand—especially if you're juggling multiple configs on the same machine. It's opinionated about how things should work, and it assumes you're comfortable in a terminal, but it doesn't assume you've memorized V2Ray's config schema. The documentation is in Chinese, which might be a barrier depending on your language skills, but the command help output is clear enough to get moving. If you're setting up V2Ray for the first time or the fiftieth, it's worth a look before you open another JSON file.

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