V2Ray一键安装脚本

233boy edited this page 2025-06-25 11:39:15 +08:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

最好用的 V2Ray 一键安装脚本 & 管理脚本

介绍

最好用的 V2Ray 脚本

Github 地址：https://github.com/233boy/v2ray/tree/master

特点

• 快速安装
  
• 超级好用
  
• 零学习成本
  
• 自动化 TLS
  
• 简化所有流程
  
• 屏蔽 BT
  
• 屏蔽中国 IP
  
• 使用 API 操作
  
• 兼容 V2Ray 命令
  
• 强大的快捷参数
  
• 支持所有常用协议
  
• 一键添加 Shadowsocks
  
• 一键添加 VMess-(TCP/mKCP/QUIC)
  
• 一键添加 VMess-(WS/H2/gRPC)-TLS
  
• 一键添加 VLESS-(WS/H2/gRPC)-TLS
  
• 一键添加 Trojan-(WS/H2/gRPC)-TLS
  
• 一键添加 VMess-(TCP/mKCP/QUIC) 动态端口
  
• 一键启用 BBR
  
• 一键更改伪装网站
  
• 一键更改 (端口/UUID/密码/域名/路径/加密方式/SNI/动态端口/等…)
  
• 还有更多…
  
  

设计理念

设计理念为：高效率，超快速，极易用

脚本基于作者的自身使用需求，以 多配置同时运行 为核心设计

并且专门优化了，添加、更改、查看、删除、这四项常用功能

你只需要一条命令即可完成 添加、更改、查看、删除、等操作

例如，添加一个配置仅需不到 1 秒！瞬间完成添加！其他操作亦是如此！

脚本的参数非常高效率并且超级易用，请掌握参数的使用

请认真往下阅读脚本的参数使用，你就会发现可以如此美妙

支持协议列表

• VMess-TCP
  
• VMess-mKCP
  
• VMess-QUIC
  
• VMess-H2-TLS
  
• VMess-WS-TLS
  
• VMess-gRPC-TLS
  
• VLESS-H2-TLS
  
• VLESS-WS-TLS
  
• VLESS-gRPC-TLS
  
• Trojan-H2-TLS
  
• Trojan-WS-TLS
  
• Trojan-gRPC-TLS
  
• Shadowsocks
  
• VMess-TCP-dynamic-port
  
• VMess-mKCP-dynamic-port
  
• VMess-QUIC-dynamic-port
  
  

机场推荐

如果你只是单纯的翻，墙需求，可以购买机场的，不用自己搭建什么的，省心省力。

机场推荐： Just My Socks

Just My Socks 是搬瓦工提供的 Shadowsocks & V2Ray 服务，不怕跑路，非国人商家，无须担心 IP 被墙问题。

购买教程： Just My Socks 详细图文购买教程

sing-box脚本(推荐)

备注，推荐使用 sing-box 脚本，支持更多协议，如 REALITY，TUIC，Trojan，Hysteria2 等协议

请看：sing-box一键安装脚本

你完全可以使用 sing-box 脚本来代替 v2ray 脚本使用。

搭建教程

如果是新手，请看：V2Ray搭建详细图文教程

安装

系统支持：Ubuntu，Debian，CentOS，推荐使用 Ubuntu 22，谨慎使用 CentOS，脚本可能无法正常运行！

执行如下命令：

bash <(wget -qO- -o- https://git.io/v2ray.sh)

安装完成

当你执行了上面的安装命令，并且没有错误提示的话，那么你就能看到类似下面的图片

脚本特意弄了一个时间显示，给反馈用来检测安装时间的…

理论上，绝大多数情况下 15 秒内会安装完成，条件允许的情况下仅需一秒即可完成安装！

超过 15 秒的你应该考虑换 VPS 了，推荐使用 搬瓦工 VPS

为方便你快速使用，脚本在安装完成后会自动创建一个 VMess-TCP 配置。

此时你可以复制 URL 到相关软件 (例如 v2rayN) 去测试一下是否正常使用。

如果无法正常使用，请尝试使用 v2ray add ss 添加一个 SS 来再测试一下

恢复旧配置

如果你之前已经安装过本人的 V2Ray 脚本，请在安装完成后，断开 SSH，重新登录 SSH，然后输入 v2ray

之后会有旧配置恢复之类的提示，可完美的把之前的旧配置恢复过来。

是否恢复旧配置:
1) 删除旧配置
2) 恢复: VLESS_WebSocket_TLS
请选择 [1-2]:

但是你必须做出选择，要么恢复旧配置，要么删除旧配置

是否删除旧配置? [y]:

如果旧配置无法恢复，那么只有删除旧配置选项

其他提醒，如果之前使用的协议为 *TLS，并且使用了 Caddy 自动化完成 TLS，恢复旧配置的时候会连同升级 Caddy 版本到最新版本，并且备份了 /etc/caddy/Caddyfile 文件和 /etc/caddy/sites 目录

备份名为：/etc/caddy/Caddyfile.233.bak 文件和 /etc/caddy/sites.233.bak 目录

此备份是为了避免 Caddy 版本过旧，造成配置文件出错，无法启动

如果你曾在 /etc/caddy/sites 目录放过自己另外的网站配置，请在恢复旧配置之后，再手动检查 sites.233.bak 目录配置的兼容性，然后重新放到 sites 目录，之后重启 Caddy 即可，可以使用 v2ray restart caddy 重启 Caddy

管理面板

安装完成后，输入 v2ray 就能看到管理面板，如下图片所示

提示，如果你不想执行任何功能，直接按 Enter 回车退出即可。

无法使用

无法使用一般都是两种情况，一是无法连接上端口，二是客户端内核支持有问题。

如果你的 VPS 有外部防火墙，请确保你已经开放了端口

测试端口是否能连接上：

打开：https://tcp.ping.pe/

写上你的 VPS IP 跟端口；内容为 ip:端口，示例：1.1.1.1:443，然后点击 Go；或者直接回车

如果显示 successful；证明端口能连接；如果显示 failed；那是无法连接上端口。

提醒，你可以使用 v2ray ip 查看 VPS IP。

关闭防火墙，执行如下命令：

systemctl stop firewalld; systemctl disable firewalld; ufw disable

关闭防火墙之后再测试一下端口是否通，如果不通，你可能还有外部防火墙没关，必须要能连接上端口才能正常使用。

如果能连接上端口，那就继续

使用 v2ray add ss 添加一个 SS 看看能不能正常使用，如果正常使用，证明运行没有问题。

提醒，默认安装的 V2Ray 内核为最新版本

如果无法使用，可能是你客户端的内核太旧

请尝试使用不同的客户端进行测试；比如 v2rayN；v2rayNG 等

请尝试设置 VMessAEAD，某些客户端会有相关选项

某些客户端得把 额外id(alterid) 填写为 0；比如垃圾苹果那边的东西

解决方案一，请尝试将服务器端的内核版本降级

使用 v2ray update core 4.45.2 降级即可

解决方案二，升级客户端内核

备注，请尽量将客户端内核和服务器端内核保持一致！内核版本低于 5 可能会出现莫名其妙的问题

快速入门

V2Ray 脚本简化了很多流程，例如我们常用的是 (添加、更改、查看、删除) 配置，以下内容让你可以快速掌握使用

添加配置：

• v2ray add -> 添加配置

• v2ray add ss -> 添加一个 Shadowsocks 配置

• v2ray add tcp -> 添加一个 VMess-TCP 配置

• v2ray add kcpd -> 添加一个 VMess-mKCP-dynamic-port 动态端口配置

备注，使用 v2ray add 添加配置的时候，仅 *TLS 相关协议配置必须提供域名，其他均可自动化处理。

如需查看更多 add 参数用法，请查看下面的 add 说明

–

更改配置：

• v2ray change -> 更改配置

• v2ray change tcp -> 更改 TCP 相关配置

• v2ray change tcp port auto -> 更改 TCP 相关配置的端口，端口使用自动创建，也可以使用 v2ray port tcp auto

• v2ray change kcp id auto -> 更改 mKCP 相关配置的 UUID，UUID 使用自动创建，也可以使用 v2ray id tcp auto

如需查看更多 change 参数用法，请查看下面的 change 说明

–

查看配置：

• v2ray info -> 查看配置

• v2ray info tcp -> 查看 TCP 相关配置

• v2ray info kcp -> 查看 kcp 相关配置

–

删除配置：

• v2ray del -> 删除配置

• v2ray del kcp -> 删除 KCP 相关配置

• v2ray del tcp -> 删除 TCP 相关配置

提醒，谨慎使用 del 参数

–

非常棒！你已经掌握最常用的功能 (添加、更改、查看、删除)

add / change / info / del ： 添加、更改、查看、删除

对于绝大多数用户来说

使用 v2ray add 添加配置，使用 v2ray change v2ray info v2ray del 来 (更改、查看、删除) 配置即可。

提醒，如果只匹配到一个配置时则自动选择该配置，否则将显示匹配到的配置列表，要求选择其中一个配置

add

add 参数是用来添加配置的

备注：可选参数中使用 auto 代替即是让脚本自动化处理相关参数

用法：v2ray add [protocol] [args... | auto]

举例：

• v2ray add
  
• v2ray add h2
  
• v2ray add ws
  
• v2ray add ss
  
• v2ray add tcp
  
• v2ray add kcpd
  
  

提醒，当 可选参数 不存在时，即默认为 auto，仅 *TLS 协议配置的域名无法自动处理。

例如，v2ray add tcp 等于 v2ray add tcp auto auto auto

–

可选参数详细说明如下：

添加一个 Shadowsocks 配置
可选参数：端口，密码，加密方式
用法：v2ray add ss [port] [password] [method]
举例：

• v2ray add ss

• v2ray add ss 233 233boy aes-128-gcm -> 端口使用 233，密码使用 233boy.com，加密方式使用 aes-128-gcm

–

添加一个 Socks 配置
可选参数：端口，密码，加密方式
用法：v2ray add socks [port] [username] [password]
举例：

• v2ray add socks

• v2ray add socks 233 233boy 233boy.com -> 端口使用 233，用户名使用 233boy，密码使用 233boy.com

–

添加一个 VMess-(TCP/mKCP/QUIC) 配置
可选参数：端口，UUID，伪装类型
用法：v2ray add [tcp | kcp | quic] [port] [uuid] [type]
举例：

• v2ray add tcp -> 添加一个 VMess-TCP 配置

• v2ray add kcp -> 添加一个 VMess-mKCP 配置

• v2ray add quic -> 添加一个 VMess-QUIC 配置

• v2ray add tcp 233 auto http -> 端口使用 233，伪装类型使用 http

• v2ray add kcp 234 auto dtls -> 端口使用 234，伪装类型使用 dtls

• v2ray add quic 235 auto wechat-video -> 端口使用 235，伪装类型使用 wechat-video

–

添加一个 VMess-(TCP/mKCP/QUIC) 动态端口配置
可选参数：端口，UUID，伪装类型，动态开始端口，动态结束端口
用法：v2ray add [tcpd | kcpd | quicd] [port] [uuid] [type] [start] [end]
举例：

• v2ray add tcpd -> 添加一个 VMess-TCP 动态端口配置

• v2ray add kcpd -> 添加一个 VMess-mKCP 动态端口配置

• v2ray add quicd -> 添加一个 VMess-QUIC 动态端口配置

• v2ray add tcpd 223 auto http 2333 3333 -> 端口使用 233，伪装类型使用 http，动态端口使用 2333-3333

• v2ray add kcpd auto auto dtls 2333 2444 -> 伪装类型使用 dtls，动态端口 2333-2444

• v2ray add quicd 456 auto dtls 4567 5678 -> 端口使用 456，伪装类型使用 dtls，动态端口使用 4567-5678

–

添加一个 VMess-(WS/H2/gRPC)-TLS 配置
可选参数：域名，UUID，路径
用法: v2ray add [ws | h2 | grpc] [host] [uuid] [path]
举例:

• v2ray add ws -> 添加一个 VMess-WS-TLS 配置

• v2ray add h2 -> 添加一个 VMess-H2-TLS 配置

• v2ray add grpc -> 添加一个 VMess-gRPC-TLS 配置

• v2ray add ws 233boy.com -> 域名使用 233boy.com

• v2ray add h2 233boy.com auto /h2 -> 域名使用 233boy.com，路径使用 /h2

• v2ray add grpc 233boy.com auto /grpc -> 域名使用 233boy.com，路径使用 /grpc

–

添加一个 VLESS-(WS/H2/gRPC)-TLS 配置
可选参数：域名，UUID，路径
用法: v2ray add [vws | vh2 | vgrpc] [host] [uuid] [path]
举例:

• v2ray add vws -> 添加一个 VLESS-WS-TLS 配置

• v2ray add vh2 -> 添加一个 VLESS-H2-TLS 配置

• v2ray add vgrpc -> 添加一个 VLESS-gRPC-TLS 配置

• v2ray add vws 233boy.com -> 域名使用 233boy.com

• v2ray add vh2 233boy.com auto /h2 -> 域名使用 233boy.com，路径使用 /h2

• v2ray add vgrpc 233boy.com auto /grpc -> 域名使用 233boy.com，路径使用 /grpc

–

添加一个 Trojan-(WS/H2/gRPC)-TLS 配置
可选参数：域名，UUID，路径
用法: v2ray add [tws | th2 | tgrpc] [host] [uuid] [path]
举例:

• v2ray add tws -> 添加一个 Trojan-WS-TLS 配置

• v2ray add th2 -> 添加一个 Trojan-H2-TLS 配置

• v2ray add tgrpc -> 添加一个 Trojan-gRPC-TLS 配置

• v2ray add tws 233boy.com -> 域名使用 233boy.com

• v2ray add th2 233boy.com auto /h2 -> 域名使用 233boy.com，路径使用 /h2

• v2ray add tgrpc 233boy.com auto /grpc -> 域名使用 233boy.com，路径使用 /grpc

–

提醒，v2ray add [protocol] 的 protocol 也可以换完整的协议名称，名称看上面的支持协议列表

举例，v2ray add Shadowsocks 跟 v2ray add ss 是一样的，但当然还是用简化的名称吧，简单好记。

再说一遍，当可选参数不存在时默认是自动化处理的 (除了 *TLS 的配置必须提供域名)，如非必要，可以省去使用可选参数的。

所以，绝大多数情况下，只要加上协议即可，举例： v2ray add tcp，v2ray add kcp，v2ray add kcpd

no-auto-tls

no-auto-tls 参数跟 add 参数用法一样，但禁止自动配置 TLS, 可用于 *TLS 相关协议

用法：v2ray no-auto-tls [protocol] [args... | auto]

举例：

• v2ray no-auto-tls
  
• v2ray no-auto-tls ws
  
• v2ray no-auto-tls vh2 233boy.com
  
• v2ray no-auto-tls tgrpc 233boy.com
  
  

提醒，如果你想要手动配置 TLS，请使用此选项，例如你想要用 NGINX 实现 TLS

帮助说明：V2Ray 脚本 no-auto-tls 参数帮助说明

[name]

试想一虾，如果你当前有 233 个 VMess-TCP 配置的时候，如何快速选择其中一个配置呢

当你有多个配置时，你可以使用 [name] 关键词用来匹配相关配置，以便于快速执行 更改，查看，删除 等操作

推荐使用 端口 或者 域名 来匹配，这样更加容易筛选相关配置。

请往下查看会使用到 [name] 的举例

提醒，如果只匹配到一个配置时则自动选择该配置，否则将显示匹配到的配置列表，要求选择其中一个配置

change

change 参数是用来更改配置

用法: v2ray change [name] [option] [args... | auto]

提醒：不同的配置可提供更改的相关选项是不同的

[option] 名称及选项说明参数如下：

名称	可选参数	用途	auto
dp, dynamicport	[start] [end]	更改动态端口	是
full	[…]	更改多个参数	其他
id	[uuid]	更改 UUID	是
host	[domain]	更改域名	-
port	[port]	更改端口	是
path	[path]	更改路径	是
passwd	[passowrd]	更改密码	是
type	[type]	更改伪装类型	是
method	[method]	更改加密方式	是
seed	[seed]	更改 mKCP seed	是
new	[…]	更改协议	其他
web	[domain]	更改伪装网站	-

备注，支持 auto 的即是可以将可选参数设置为 auto，以执行自动更改相关参数

如果 auto 为其他，可选参数请参考 add 参数用法，full 类似于 v2ray add 当前协议 [...]，new 类似于 v2ray add [...]

举例:

• v2ray change -> 更改配置

• v2ray change tcp -> 更改一个 tcp 相关的配置

• v2ray change tcp port 233 -> 更改一个 TCP 配置的端口为 233

• v2ray change tcp port auto -> 更改一个 TCP 配置的端口，并且端口自动创建

• v2ray change kcp id auto -> 更改一个 mKCP 配置的 UUID，并且 UUID 自动创建

• v2ray change kcp dp auto -> 更改一个 mKCP 配置的动态端口，并且动态端口自动创建

• v2ray change kcp dp 233 332 -> 更改一个 mKCP 配置的动态端口为 233-332

• v2ray change tls host 233boy.com -> 更改一个 tls 配置的域名为 233boy.com

• v2ray change tls web example.com -> 更改一个 tls 配置的伪装网站为 example.com

提醒， [option] 名称也支持直接使用

用法：v2ray [option] [name] [...]

举例：

• v2ray id -> 更改 UUID

• v2ray port -> 更改 端口

• v2ray port tcp 233 -> 更改一个 tcp 配置的端口为 233

• v2ray id tcp -> 更改一个 tcp 配置的 UUID

• v2ray id tcp auto -> 更改一个 tcp 配置的 UUID，并且 UUID 自动创建

• v2ray dp kcp auto -> 更改一个 mKCP 配置的动态端口，并且动态端口自动创建

• v2ray dp kcp 233 332 -> 更改一个 mKCP 配置的动态端口为 233-332

• v2ray host tls 233boy.com -> 更改一个 tls 配置的域名为 233boy.com

• v2ray web tls example.com -> 更改一个 tls 配置的伪装网站为 example.com

更改配置的选项较多，就不一个一个举例了，绝大多数情况下使用 v2ray change 即可

info

info 参数是用来查看配置的

用法: v2ray info [name]

举例:

• v2ray info -> 查看配置

• v2ray info tcp -> 查看一个 tcp 配置

• v2ray info kcp -> 查看一个 kcp 配置

• v2ray info tls -> 查看一个 tls 配置

url

url 参数是用来生成配置的 URL 链接的

用法: v2ray url [name]

举例:

• v2ray url -> 查看配置的 URL 链接

• v2ray url tcp -> 查看一个 tcp 配置的 URL 链接

• v2ray url kcp -> 查看一个 kcp 配置的 URL 链接

• v2ray url tls -> 查看一个 tls 配置的 URL 链接

备注，使用 v2ray info 也同样会有生成 URL 链接信息的

qr

qr 参数是用来生成配置的二维码信息的

用法: v2ray qr [name]

举例:

• v2ray qr -> 查看配置的二维码信息

• v2ray qr tcp -> 查看一个 tcp 配置的二维码信息

• v2ray qr kcp -> 查看一个 kcp 配置的二维码信息

• v2ray qr tls -> 查看一个 tls 配置的二维码信息

del

del 参数是用来删除配置的

用法: v2ray del [name]

举例:

• v2ray del -> 删除配置

• v2ray del tcp -> 删除一个 tcp 配置

• v2ray del kcp -> 删除一个 kcp 配置

• v2ray del tls -> 删除一个 tls 配置

谨慎使用此选项

ddel

ddel 参数是用来删除多个配置的

用法: v2ray ddel [name...]

举例:

• v2ray ddel -> 删除配置

• v2ray ddel tcp kcp -> 同时删除一个 tcp，一个 kcp 配置

提醒，此处的 [name] 只有匹配到相关配置是唯一时，才会执行删除

例如，假设你当前有两个 tcp 配置，使用 v2ray ddel tcp 是不会删除任何文件的

谨慎使用此选项

client

client 参数可生成适用于客户端的 json，仅供参考，默认生成的配置本地 socks5 监听端口为 2333

用法：v2ray client [name]

举例：

• v2ray client
  
• v2ray client tcp
  
• v2ray client tls
  
  

gen

gen 参数跟 add 参数用法一样，但是 gen 参数只返回 JSON 内容，不会创建配置，仅供测试使用

用法：v2ray gen [protocol] [args... | auto]

举例：

• v2ray gen ss
  
• v2ray gen tcp
  
• v2ray gen kcpd
  
• v2ray gen ws 233boy.com
  
  

genc

genc 参数是用来查看适用客户端 outbounds JSON 的，仅供测试使用

用法：v2ray genc [name]

举例：

• v2ray gen
  
• v2ray gen tcp
  
  

提醒，你也可以使用 v2ray client ，跟 genc 作用是一样的。

bbr

bbr 参数是启用 BBR 优化的

使用: v2ray bbr

bin

bin 参数是直接调用 V2Ray 核心运行相关命令，此参数可完全兼容所有 V2Ray 命令

用法：v2ray bin [...]

举例：v2ray bin help

默认兼容的命令：api, convert, tls, run, uuid

举例：v2ray uuid

xapi

xapi 参数类似 v2ray api, 但 API 后端使用当前运行的 V2Ray 服务

用法：v2ray xapi [...]

举例：v2ray xapi stats

fix-config.json

fix-config.json 参数是用来修复 config.json 文件的

使用: v2ray fix-config.json

update

update 参数是用来更新的

用法：v2ray update [core | sh | caddy] [ver]

举例:

• v2ray update -> 更新核心
  
• v2ray update core -> 更新核心
  
• v2ray update core v5.4.1 -> 更新核心，使用 v5.4.1 版本
  
• v2ray update sh -> 更新脚本
  
• v2ray update caddy -> 更新 Caddy
  
  

log

log 参数是用来查看 V2Ray 运行的实时日志

用法: v2ray log [debug | info | warning | error | none | del]

举例：

• v2ray log -> 查看日志
  
• v2ray log [level] -> 设定 log 级别
  
  

由于每个人日常使用需求不同，为了避免 log 生成太大的文件占用硬盘空间，请考虑使用 v2ray log del 来删除日志文件；

或者直接使用 v2ray log none 直接禁止生成 log 文件。

status

status 参数是用来查看运行状态的

使用：v2ray status

start, stop, restart

start, stop, restart 参数是用来管理 V2Ray 启动，停止，重启 的

用法：v2ray [start | stop | restart] [caddy]

举例：

• v2ray restart -> 重启 V2Ray
  
• v2ray restart caddy -> 重启 Caddy
  
  

reinstall

reinstall 参数是用来重装脚本的

使用: v2ray reinstall

uninstall

uninstall 参数是用来卸载脚本的

使用：v2ray uninstall

设置DNS

请看：V2Ray 脚本 DNS 设置

中转

如果你需要使用 A 机器转发流量到 B 机器

那么请看：V2Ray 脚本中转教程

帮助

哎呀，不想写了，其他的一些参数用法，请查看帮助

使用：v2ray help

目录

V2Ray 脚本全部身家保存在 /etc/v2ray

脚本：/etc/v2ray/sh
核心：/etc/v2ray/bin
配置：/etc/v2ray/conf

不要为什么不符合 XXX 规则，因为我更想符合一键删除理念。

友情提醒

如果你添加了 *TLS 协议的配置，请务必设置伪装网站，使用 v2ray web tls 快速设置伪装网站

伪装网站

伪装网站是一个反代，指的是打开自己域名的时候显示来自伪装网站的内容

自动 TLS 说明

V2Ray 脚本自动 TLS 帮助说明

备份脚本

考虑到可能会有不可描述的事情发生，你可以将 V2Ray 脚本备份一下以防止万一。

Github 地址：https://github.com/233boy/v2ray

你可以 Fork 一份，如果本人一键删库跑路了，你也可以照样正常安装使用

安装命令如下：

wget https://github.com/233boy/v2ray/archive/master.tar.gz -O v2ray-master.tar.gz;tar -zxvf v2ray-master.tar.gz;cd v2ray-master;chmod +x i*;./i* -l

记得要把安装命令中的 233boy 更改成你的 Github 用户名

机场备用

为防止自建节点不可用，推荐购买一个机场作为备用方案，以防止失联

机场推荐： Just My Socks

Just My Socks 是搬瓦工提供的服务，不怕跑路，非国人商家，无须担心 IP 被墙问题。

购买教程：Just My Socks 详细图文购买教程

关注我们

Telegram 频道：https://t.me/tg2333

Telegram 群组：https://t.me/tg233boy

反馈问题

https://github.com/233boy/v2ray/issues

返回主页