2024 V2Ray Linux 客户端配置教程 – wiki大全


2024 V2Ray Linux 客户端配置教程

V2Ray 是一款强大的网络代理工具,旨在帮助用户绕过网络限制并增强在线隐私。它支持多种协议,如 VMess、VLESS、Shadowsocks 等,并提供灵活的路由功能,使其成为一个多功能且高度可配置的代理解决方案。本教程将指导您如何在 2024 年在 Linux 系统上配置 V2Ray 客户端,并提供一个常见的 VMess + WebSocket + TLS 配置示例。

1. 前提条件

在开始之前,请确保您具备以下条件:

  • Linux 系统:一台运行 Linux 的计算机(例如 Ubuntu, Debian, CentOS, Fedora 等)。
  • V2Ray 服务器:一个已搭建并正常运行的 V2Ray 服务器。您需要从服务器提供商或您自行搭建的服务器中获取以下关键配置信息:
    • 服务器地址 (IP 地址或域名)
    • 服务器端口
    • 用户 ID (UUID)
    • AlterId (通常为 0 或 64,取决于您的服务器配置)
    • 传输协议 (例如 WebSocket)
    • WebSocket 路径 (如果使用 WebSocket 传输,例如 /ray)
    • TLS 状态 (是否启用 TLS 加密)
  • 必要的工具:确保您的系统已安装 curlunzip 工具。如果未安装,请根据您的 Linux 发行版进行安装:
    • Debian/Ubuntu:
      bash
      sudo apt update
      sudo apt install curl unzip -y
    • CentOS/RHEL/Fedora:
      bash
      sudo yum install curl unzip -y
      # 或对于较新版本
      sudo dnf install curl unzip -y

2. 安装 V2Ray Core

推荐使用 V2Ray 官方提供的一键安装脚本来安装 V2Ray Core。此脚本将安装 V2Ray 核心程序,并将其配置为系统服务。

  1. 下载并运行 V2Ray 官方安装脚本
    bash
    bash <(curl -Ls https://raw.githubusercontent.com/v2fly/fhs-install-v2ray/master/install-release.sh)

    此命令会下载并执行 V2Ray 官方安装脚本。它会自动检测您的系统架构,下载最新的 V2Ray 包,并将其安装到 /usr/local/bin/v2ray/usr/local/bin/v2ctl。V2Ray 的配置文件通常位于 /etc/v2ray/config.json

3. 配置 V2Ray 客户端

安装完成后,您需要编辑 V2Ray 的配置文件 /etc/v2ray/config.json 以连接到您的 V2Ray 服务器。

  1. 打开配置文件
    bash
    sudo nano /etc/v2ray/config.json

    您可以使用 nano 或其他您喜欢的文本编辑器(如 vim)。
  2. 配置示例 (VMess + WebSocket + TLS)
    清空文件中的所有内容,然后粘贴以下配置模板。请务必将模板中的占位符 (YOUR_SERVER_ADDRESS, YOUR_SERVER_PORT, YOUR_UUID, YOUR_ALTERID, YOUR_PATH) 替换为您的 V2Ray 服务器提供的实际信息。

    json
    {
    "log": {
    "loglevel": "warning",
    "access": "/var/log/v2ray/access.log",
    "error": "/var/log/v2ray/error.log"
    },
    "inbounds": [
    {
    "port": 1080, // 本地 SOCKS5 代理端口,您可以根据需要修改
    "listen": "127.0.0.1",
    "protocol": "socks",
    "settings": {
    "auth": "noauth",
    "udp": true,
    "ip": "127.0.0.1"
    },
    "sniffing": {
    "enabled": true,
    "destOverride": ["http", "tls"]
    }
    },
    {
    "port": 1081, // 本地 HTTP 代理端口,您可以根据需要修改
    "listen": "127.0.0.1",
    "protocol": "http",
    "settings": {
    "udp": true,
    "ip": "127.0.0.1"
    }
    }
    ],
    "outbounds": [
    {
    "protocol": "vmess",
    "settings": {
    "vnext": [
    {
    "address": "YOUR_SERVER_ADDRESS", // 您的 V2Ray 服务器地址 (IP 或域名)
    "port": YOUR_SERVER_PORT, // 您的 V2Ray 服务器端口 (数字)
    "users": [
    {
    "id": "YOUR_UUID", // 您的 UUID (一串字符)
    "alterId": YOUR_ALTERID, // 您的 alterId (数字,通常为 0 或 64)
    "security": "auto"
    }
    ]
    }
    ]
    },
    "streamSettings": {
    "network": "ws", // 传输协议,例如 ws (WebSocket)
    "security": "tls", // 启用 TLS 加密
    "tlsSettings": {
    "serverName": "YOUR_SERVER_ADDRESS" // 您的服务器域名,如果服务器地址是 IP 则不需要
    },
    "wsSettings": {
    "path": "YOUR_PATH" // WebSocket 路径,例如 /ray 或 /v2ray
    }
    },
    "tag": "proxy"
    },
    {
    "protocol": "freedom",
    "tag": "direct"
    },
    {
    "protocol": "blackhole",
    "tag": "blocked"
    }
    ],
    "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
    {
    "type": "field",
    "ip": ["geoip:private"],
    "outboundTag": "direct"
    },
    {
    "type": "field",
    "domain": ["geosite:cn"],
    "outboundTag": "direct"
    },
    {
    "type": "field",
    "ip": ["geoip:cn"],
    "outboundTag": "direct"
    },
    {
    "type": "field",
    "port": "25", // 禁用 25 端口,防止邮件泄漏
    "outboundTag": "blocked"
    },
    {
    "type": "field",
    "outboundTag": "proxy" // 所有未匹配的流量都走代理
    }
    ]
    }
    }

    重要参数说明:
    * inbounds: 定义 V2Ray 客户端在本地监听的端口和协议。
    * "port": 1080: 默认的 SOCKS5 代理端口。
    * "port": 1081: 默认的 HTTP 代理端口。
    * "listen": "127.0.0.1": 代理只在本地监听。
    * outbounds: 定义 V2Ray 客户端如何连接到远程 V2Ray 服务器。
    * "address": 您的 V2Ray 服务器的 IP 地址或域名。
    * "port": 您的 V2Ray 服务器的端口。
    * "id": 您的 UUID (用户身份标识)。
    * "alterId": 您的 alterId,通常为 0 或 64。
    * "network": "ws": 使用 WebSocket 传输协议。
    * "security": "tls": 启用 TLS 加密,确保通信安全。
    * "serverName": 如果您的服务器使用域名,这里填写域名。如果使用 IP 地址,可以删除此项或留空。
    * "path": WebSocket 的路径,必须与服务器配置一致。
    * routing: 路由规则,决定哪些流量走代理,哪些直连,哪些被阻止。
    * "geosite:cn""geoip:cn": 用于识别国内网站和 IP,使其直连。
    * "port": "25": 阻止 25 端口的流量,通常用于防止邮件泄露。
    * 最后一个规则 "outboundTag": "proxy": 确保所有未被其他规则匹配的流量都通过 "proxy" 出站(即通过 V2Ray 服务器)。
    3. 保存并关闭文件
    nano 编辑器中,按 Ctrl+O (写入) -> Enter (确认文件名) -> Ctrl+X (退出)。

4. 管理 V2Ray 服务

配置完成后,您需要启动 V2Ray 服务并确保它在系统启动时自动运行。

  1. 启动 V2Ray 服务
    bash
    sudo systemctl start v2ray
  2. 检查 V2Ray 服务状态
    bash
    sudo systemctl status v2ray

    如果服务正常运行,您会看到 “active (running)” 的状态。如果出现错误,请检查 config.json 文件是否有语法错误,并查看日志文件 /var/log/v2ray/error.log
  3. 设置 V2Ray 开机自启
    bash
    sudo systemctl enable v2ray

    这样 V2Ray 会在系统重启后自动启动。
  4. 重启 V2Ray 服务 (如果修改了配置)
    每当您修改 config.json 文件后,都需要重启 V2Ray 服务以使更改生效。
    bash
    sudo systemctl restart v2ray

5. 配置系统或浏览器代理

V2Ray 客户端在本地监听 127.0.0.1 上的 SOCKS5 代理端口 (默认为 1080) 和 HTTP 代理端口 (默认为 1081)。您需要将应用程序或系统的代理设置指向这些本地端口。

5.1. 配置浏览器代理 (以 Firefox 为例)

  1. 打开 Firefox 浏览器。
  2. 点击右上角的菜单按钮 (三条横线),选择 “设置” (Preferences)。
  3. 向下滚动到 “网络设置” (Network Settings) 部分,点击 “设置…” (Settings…) 按钮。
  4. 在弹出的连接设置窗口中,选择 “手动代理配置” (Manual proxy configuration)。
  5. 在 “SOCKS 主机” (SOCKS Host) 字段中输入 127.0.0.1
  6. 在 “端口” (Port) 字段中输入 1080 (确保与您 config.jsoninbounds 的 SOCKS 端口一致)。
  7. 选择 “SOCKS v5″。
  8. 勾选 “当使用 SOCKS v5 时代理 DNS” (Proxy DNS when using SOCKS v5),以避免 DNS 污染。
  9. 点击 “确定” (OK) 保存设置。

5.2. 配置系统范围代理 (以 GNOME 桌面环境为例)

  1. 打开 “设置” (Settings) 应用程序。
  2. 导航到 “网络” (Network) -> “网络代理” (Network Proxy)。
  3. 选择 “手动” (Manual)。
  4. 在 “Socks 主机” (Socks Host) 字段中输入 127.0.0.1,端口输入 1080
  5. 点击 “应用” 或 “启用” 保存设置。
    • 对于 HTTP 和 HTTPS 代理,您可以将它们设置为 127.0.0.1 端口 1081

6. 替代方案:V2RayA (GUI 客户端)

如果您更喜欢图形用户界面 (GUI) 来管理 V2Ray 客户端,可以考虑使用 v2rayAv2rayA 是一个基于 Web GUI 的 V2Ray 客户端,支持多种协议,并提供全局透明代理功能,操作更为简便。

v2rayA 的安装方式包括:
* 通过 apt-source 或 AUR 包管理器安装 (适用于 Debian/Ubuntu 和 Arch Linux)。
* Docker 容器部署。
* Snapcraft (适用于 Ubuntu Snap)。

安装 v2rayA 后,您可以通过浏览器访问其 Web 界面 (通常是 http://127.0.0.1:2017) 进行配置和管理,无需手动编辑 config.json

7. 验证连接

配置完成后,您可以通过访问一些网站来验证 V2Ray 是否正常工作:

  1. 检查 IP 地址
    访问 https://www.iplocation.nethttps://whatismyipaddress.com,检查您的 IP 地址是否已更改为您的 V2Ray 服务器的 IP 地址。
  2. 访问受限网站
    尝试访问一些您所在地通常无法访问的网站,看是否能正常打开。

8. 故障排除

如果 V2Ray 未按预期工作,您可以检查以下几点:

  • 配置文件语法config.json 必须是有效的 JSON 格式。任何拼写错误或括号不匹配都可能导致 V2Ray 无法启动。可以使用在线 JSON 验证器检查。
  • 服务器配置:确保您的 V2Ray 客户端配置中的服务器地址、端口、UUID、alterId、网络协议和路径与服务器端完全一致。
  • 防火墙:检查您的 Linux 系统防火墙(如 ufwfirewalld)是否阻止了 V2Ray 的入站或出站连接。通常,V2Ray 客户端不需要开放入站端口,但出站连接必须允许。
  • V2Ray 日志:检查 V2Ray 的日志文件以获取详细的错误信息:
    • 访问日志:/var/log/v2ray/access.log
    • 错误日志:/var/log/v2ray/error.log
  • 网络连接:确保您的 Linux 机器本身可以正常访问互联网。

通过遵循本教程,您应该能够在 2024 年成功配置 V2Ray Linux 客户端,并享受安全、自由的网络体验。如果您遇到任何问题,请仔细检查每一步并参考 V2Ray 的官方文档或社区寻求帮助。

滚动至顶部