项目档案命令行工具

V2Ray一键安装管理脚本：快速部署代理服务器，支持多协议自动化TLS

233boy/v2ray：V2Ray 一键安装与管理脚本，通过命令行工具实现快速部署、多配置管理、自动化 TLS 及多种协议支持，极大简化代理服务器搭建与运维流程。本页整理它解决什么问题、适用场景、安装方式和使用方法。

29,636ShellStar 于 2026年4月10日2026年9月19日更新

AI 总结

V2Ray 一键安装与管理脚本，通过命令行工具实现快速部署、多配置管理、自动化 TLS 及多种协议支持，极大简化代理服务器搭建与运维流程。

中文项目介绍

本项目是一个专为 V2Ray 设计的命令行安装与管理脚本，旨在解决传统 V2Ray 部署过程中配置复杂、学习成本高的问题。脚本以“多配置同时运行”为核心设计理念，提供极简的命令行接口，用户可通过单一命令完成添加、更改、查看、删除等日常操作，实现零学习成本的高效管理。它适用于个人用户快速搭建代理服务、运维人员批量管理多个实例，以及需要自动化 TLS 证书申请与 HTTPS 伪装的场景。技术实现上，脚本采用模块化 Bash 编写，集成 Caddy 实现自动 TLS，支持 BBR 加速，并覆盖 VMess、VLESS、Trojan、Shadowsocks 等主流协议，同时提供动态端口、伪装网站等高级功能。

详细信息与使用说明

1. 项目定位与用途

本项目是一个 V2Ray 的一键安装与全生命周期管理脚本，定位为命令行工具（CLI）。其核心用途是简化 V2Ray 服务的部署、配置修改和日常运维，用户通过 `v2ray` 命令即可完成所有操作，无需手动编辑配置文件。脚本以“多配置同时运行”为设计核心，允许在同一实例上管理多个代理配置，并针对添加、更改、查看、删除四项高频操作进行了深度优化，实现秒级配置变更。

2. 解决的问题

传统 V2Ray 安装涉及依赖安装、核心下载、配置文件编写、服务启动等多个步骤，对新手不友好且易出错。本脚本通过自动化流程解决了以下问题：1) 安装复杂：自动检测系统环境、安装依赖、下载并部署 V2Ray 核心；2) 配置繁琐：一键添加多种协议配置，自动处理端口、UUID、路径等参数；3) TLS 配置困难：集成 Caddy 实现 HTTPS 证书的自动申请与续期；4) 管理低效：提供统一命令接口，快速修改、查看和删除配置，避免手动编辑 JSON 文件的风险。

3. 适用场景

1) 个人用户快速搭建：希望在 VPS 上快速启用代理服务，无需深入了解 V2Ray 配置细节；2) 运维人员批量管理：需要在多台服务器上部署或统一更新 V2Ray 配置，脚本的自动化特性能显著提升效率；3) 需要自动化 TLS 的场景：希望为代理服务配置 HTTPS 伪装网站并自动管理 SSL 证书，脚本内置 Caddy 可一键实现；4) 多协议切换需求：频繁在 VMess、VLESS、Trojan、Shadowsocks 等协议间切换，脚本提供统一的添加和修改接口。

4. 安装方式

安装过程完全自动化，需以 root 用户身份执行。具体步骤基于仓库中的 install.sh 脚本：1) 系统检查：自动识别 Ubuntu/Debian/CentOS 系统，验证 systemd 和 CPU 架构（amd64/arm64）；2) 依赖安装：自动安装 wget、unzip 等必需工具包；3) 核心部署：下载并安装 V2Ray 核心程序至 /usr/bin/v2ray；4) 脚本部署：将主脚本 v2ray.sh 安装至 /usr/bin/v2ray，并创建配置目录 /etc/v2ray/conf、日志目录 /var/log/v2ray 及脚本目录 /etc/v2ray/sh。用户只需运行 install.sh 即可完成全部安装。

5. 使用方式

安装后通过 `v2ray` 命令进行管理，所有操作均通过子命令实现。基本操作包括：`v2ray add [协议]` 一键添加配置（如 `v2ray add vmess`），`v2ray change [名称] [选项]` 修改指定配置（如端口、UUID、域名），`v2ray info [名称]` 查看配置详情，`v2ray del [名称]` 删除配置。进阶功能涵盖动态端口设置（`v2ray dynamicport`）、DNS 配置（`v2ray dns`）、服务控制（`v2ray start/stop/restart`）及更新（`v2ray update`）。完整命令列表可通过 `v2ray help` 查看，脚本同时兼容部分原生 V2Ray 命令（如 `v2ray api`）。

6. 补充说明与实现特点

脚本采用模块化 Bash 架构，主入口 v2ray.sh 负责加载 src 目录下的功能模块（如 core.sh、caddy.sh、bbr.sh 等），实现职责分离。关键实现特点包括：1) 多配置管理：所有配置集中存储在 /etc/v2ray/conf，支持同时运行多个协议实例；2) 自动化 TLS：通过 caddy.sh 集成 Caddy，自动为域名申请 SSL 证书并生成反向代理配置，实现 HTTPS 伪装；3) 性能优化：bbr.sh 提供一键启用 BBR 加速的功能；4) 协议覆盖：支持 Shadowsocks、VMess（TCP/mKCP/QUIC/WS/H2/gRPC）、VLESS（WS/H2/gRPC）、Trojan（WS/H2/gRPC）等常用协议，并支持 TLS 加密传输。

思维导图

V2Ray 一键安装管理脚本

核心命令

安装

添加配置

修改配置

查看信息

删除配置

协议支持

VMess

VLESS

Trojan

Shadowsocks

TLS 自动化

Caddy 集成

证书申请

HTTPS 伪装

性能优化

BBR 加速

动态端口

服务管理

启动/停止/重启

状态查看

日志管理

更新组件

常见问题

233boy/v2ray 是做什么的？