docker-v2ray：一键 Docker 部署 V2Ray 代理服务

本文介绍 docker-v2ray，一个基于 Docker 的 V2Ray 一键部署方案。该项目集成了 Caddy 自动证书申请、TLS 加密和 WebSocket 传输，帮助用户快速搭建安全的代理服务。

项目简介

docker-v2ray 是由 anerg2046 开发维护的开源项目，提供了一个简单快捷的 V2Ray 部署方案。该项目在 GitHub 上已获得 76 stars 和 35 forks，通过 Docker 容器化技术，实现了 Caddy + Vmess + WebSocket + TLS 的完整代理服务栈。

核心特性

• 一键部署：通过简单的脚本命令即可完成整个服务栈的安装配置
• 自动证书管理：Caddy 自动申请和续期 HTTPS 证书，无需手动干预
• TLS + WebSocket：采用 TLS 加密和 WebSocket 传输协议，提高连接稳定性和安全性
• Docker 容器化：使用 Docker Compose 管理容器，便于维护和更新
• 配置自动生成：脚本自动生成 V2Ray 配置文件，简化用户操作

技术栈

• V2Ray v4.45.2：核心代理服务，基于 v2fly/v2ray-core
• Caddy：现代化的 Web 服务器，自动处理 HTTPS 证书
• Docker & Docker Compose：容器化部署和管理
• Shell 脚本：自动化安装和配置流程

前置要求

在开始部署前，请确保满足以下条件：

• 一个已注册域名，并将域名 A 记录指向你的 VPS
• VPS 已安装 Docker 和 Docker Compose
• 开放 80 和 443 端口（用于 HTTP 和 HTTPS）

CentOS 7 环境安装示例

yum update -y
yum install -y yum-utils device-mapper-persistent-data lvm2 epel-release
yum install -y gcc libffi-devel python-devel openssl-devel git net-tools

# 安装 Docker
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum update -y
yum makecache fast
yum install -y docker-ce
service docker start
systemctl enable docker

# 安装 Docker Compose
yum install -y python-pip
pip install --upgrade pip
pip install docker-compose --ignore-installed requests

安装与使用

1. 拉取项目代码

git clone https://github.com/anerg2046/docker-v2ray.git
cd docker-v2ray

2. 生成配置文件

运行配置生成脚本，按提示输入相关信息：

./gen-config.sh

脚本会提示输入以下信息：

• 域名：你的域名（如 www.example.com）
• 邮箱地址：用于 Caddy 申请证书（如 user@mail.com）
• WebSocket 端口：可选，默认随机生成（1234~65535）
• alterId：可选，默认随机生成（10~128）

配置完成后，脚本会显示 V2Ray 连接信息和客户端导入字符串。

3. 启动服务

./docker-v2ray.sh build

首次启动可能需要等待 1-2 分钟，等待 Caddy 完成证书申请。

常用命令

# 停止服务
./docker-v2ray.sh stop

# 更新 V2Ray 版本
git pull && ./docker-v2ray.sh build

端口冲突处理

如果宿主机已占用 80 或 443 端口，可按以下方式处理：

方案一：修改端口映射

编辑 build/docker-compose.yml 文件，修改端口映射配置。

方案二：使用 Nginx 分流

如果使用 Nginx，需要启用 ssl_preread 支持。项目已在 config/nginx 目录中提供了编译和配置范例，可参考相关文档进行配置。

项目结构

docker-v2ray/
├── build/              # Docker 构建文件
├── config/             # 配置文件模板
├── html/               # 伪装页面（默认域名出售页）
├── docker-v2ray.sh     # 主控制脚本
├── gen-config.sh       # 配置生成脚本
└── README.md           # 项目文档

注意事项

• 伪装页面：html 目录包含默认的域名出售页面，建议根据实际需求修改 index.html 中的联系邮箱
• BBR 加速：脚本不包含 BBR 内核加速，如需可自行安装
• 自定义配置：有特殊需求的用户可自行修改脚本或配置文件模板
• 问题反馈：遇到问题可提交 GitHub Issue

相关推荐

• 轻量版方案：如果只需要运行单个 Docker 容器，可参考 Caddy_V2ray 项目
• VPS 推荐：北方联通用户推荐使用 JustHost.ru，价格便宜且不限流量

项目链接

• GitHub 仓库：https://github.com/anerg2046/docker-v2ray
• V2Ray 核心：https://github.com/v2fly/v2ray-core
• 轻量版项目：https://github.com/anerg2046/Caddy_V2ray