v2ray docker 部署完整指南

目录

  1. 简介
  2. 准备工作
  3. 安装 Docker
  4. 部署 v2ray 服务
    1. 拉取 v2ray 镜像
    2. 创建 v2ray 配置文件
    3. 启动 v2ray 容器
  5. 配置客户端
  6. FAQ

简介

v2ray 是一个功能强大的代理工具,可用于突破网络封锁,访问被限制的网站和服务。本文将详细介绍如何使用 Docker 部署 v2ray 服务,包括安装配置、常见问题解答等内容,帮助您快速上手使用 v2ray

准备工作

在开始部署 v2ray 之前,需要准备以下条件:

  • 一台可以访问互联网的服务器或云主机
  • 一个域名(可选,用于配置 TLS 加密)
  • 一些基本的 Linux 操作知识

安装 Docker

v2ray 的部署依赖于 Docker 环境,因此首先需要在服务器上安装 Docker。安装步骤如下:

  1. 更新系统包索引:

    sudo apt-get update

  2. 安装 Docker 所需的依赖包:

    sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

  3. 添加 Docker 的 GPG 密钥:

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –

  4. 添加 Docker 的 APT 源:

    sudo add-apt-repository “deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable”

  5. 安装 Docker:

    sudo apt-get install docker-ce docker-ce-cli containerd.io

  6. 验证 Docker 安装成功:

    sudo docker run hello-world

部署 v2ray 服务

拉取 v2ray 镜像

v2ray 提供了官方的 Docker 镜像,我们可以直接拉取使用:

docker pull v2ray/official

创建 v2ray 配置文件

v2ray 的配置文件需要自行编写,可以参考以下示例:

{ “log”: { “loglevel”: “warning” }, “inbounds”: [ { “port”: 10086, “protocol”: “vmess”, “settings”: { “clients”: [ { “id”: “your-uuid”, “alterId”: 64 } ] } } ], “outbounds”: [ { “protocol”: “freedom”, “settings”: {} } ]} 将上述配置文件保存为 config.json

启动 v2ray 容器

使用以下命令启动 v2ray 容器:

docker run -d –name v2ray -v $(pwd)/config.json:/etc/v2ray/config.json -p 10086:10086 v2ray/official

其中:

  • -d: 以守护进程方式运行容器
  • --name v2ray: 为容器命名为 v2ray
  • -v $(pwd)/config.json:/etc/v2ray/config.json: 挂载本地的 config.json 配置文件到容器内
  • -p 10086:10086: 将容器的 10086 端口映射到宿主机的 10086 端口

配置客户端

v2ray 提供了多种客户端供您选择,包括 Windows、macOS、Linux 等平台。以 Windows 为例,下载并安装 v2ray 客户端,然后按以下步骤配置:

  1. 打开 v2ray 客户端,选择 Servers 选项卡
  2. 点击 + 按钮,添加新的服务器
  3. 在服务器配置中填写以下信息:
    • 地址: 您的服务器 IP 地址或域名
    • 端口: 10086
    • 用户 ID: 您在 config.json 中配置的 id
    • 额外 ID: 64
    • 加密方式: auto
  4. 保存配置并连接到服务器

FAQ

如何开启 TLS 加密?

如果您拥有一个域名,可以通过以下步骤开启 TLS 加密:

  1. config.json 中添加以下配置:

    { “inbounds”: [ { “port”: 443, “protocol”: “vmess”, “settings”: { “clients”: [ { “id”: “your-uuid”, “alterId”: 64 } ] }, “streamSettings”: { “network”: “tcp”, “security”: “tls”, “tlsSettings”: { “certificates”: [ { “certificateFile”: “/path/to/certificate.crt”, “keyFile”: “/path/to/private.key” } ] } } } ] }

  2. certificate.crtprivate.key 文件挂载到容器内的对应路径。

  3. 重启 v2ray 容器。

如何查看 v2ray 日志?

可以使用以下命令查看 v2ray 容器的日志:

docker logs v2ray

如何更新 v2ray 版本?

v2ray 有新版本发布时,可以使用以下步骤进行更新:

  1. 停止当前运行的 v2ray 容器:

    docker stop v2ray

  2. 拉取最新版本的 v2ray 镜像:

    docker pull v2ray/official

  3. 重新启动 v2ray 容器:

    docker run -d –name v2ray -v $(pwd)/config.json:/etc/v2ray/config.json -p 10086:10086 v2ray/official

如何自定义 v2ray 配置?

v2ray 的配置文件支持多种自定义选项,您可以根据需求进行调整。例如:

  • 添加多个入站协议,如 Shadowsocks、Socks5 等
  • 配置 DNS 设置
  • 开启 mKCP 传输协议
  • 设置流量统计和 API 等功能

更多配置选项请参考 v2ray官方文档

正文完