Ubuntu 系统搭建 V2Ray 教程：V2Ray 一键脚本安装与 VMess-TCP 配置

Ubuntu LTS 系统是很多 VPS 用户常用的服务器环境，系统维护周期长，软件源也比较完整。如果大家准备在 Ubuntu 系统上搭建 V2Ray 服务端，可以使用 V2Ray 一键脚本快速生成 VMess-TCP 节点，再通过 V2RayN、V2RayNG 等客户端导入使用。本文以 Ubuntu 22.04.5 LTS 系统为例，给大家演示 Ubuntu 系统 V2Ray 一键脚本安装教程，包括系统检查、脚本安装、节点信息保存、服务状态检查、端口监听和客户端导入。

Ubuntu 系统使用 V2Ray 一键脚本部署 VMess-TCP 节点

这篇 Ubuntu 系统搭建 V2Ray 教程演示的是普通 VMess-TCP 节点，不需要域名，也不需要申请 TLS 证书。脚本运行后会自动下载 V2Ray Core、生成端口、UUID 和 vmess:// 导入链接，适合先把基础服务端跑起来。

如果需要域名、TLS 证书、Nginx 反代和 WebSocket 路径，可以参考：Ubuntu TLS 系统带伪装 V2Ray 一键脚本安装教程。

习惯使用 Shadowsocks 的网友，也可以参考：Ubuntu 系统 Shadowsocks / SS 一键脚本安装教程。

如果大家手里的客户端或软路由环境仍然依赖 SSR 节点，也可以查看：Ubuntu 系统 ShadowsocksR / SSR 一键脚本安装教程。SSR 属于另一套方案，适合有历史客户端兼容需求的用户；如果是新建节点，继续按本文部署 V2Ray 即可。

一、准备 VPS 和 Ubuntu 系统环境

运行 V2Ray 一键脚本前，需要先准备一台能够正常联网、安装 Ubuntu 系统的 VPS。

本文测试环境如下：

• 系统版本：Ubuntu 22.04.5 LTS
• 系统架构：x86_64
• 协议类型：VMess-TCP
• 服务端口：脚本自动生成，本文演示为 61416
• 配置文件路径：/etc/v2ray/config.json

如果还没有 VPS，可以参考：最新搬瓦工 VPS 注册与购买教程 购买服务器，选择系统时安装 Ubuntu 22.04 LTS，与本文测试环境保持一致。服务器开通后，再按照 搬瓦工 VPS 搭建 V2Ray 详细教程 完成 V2Ray 安装和节点配置。

如果只是临时测试脚本，也可以选择 Vultr 按小时计费的 VPS。测试完成后需要销毁实例，停止服务器不会停止计费。

如果大家使用的是 CentOS 系统，不要照搬本文命令。CentOS 与 Ubuntu 的包管理方式、服务路径和安装脚本并不相同，可以参考：CentOS 系统 V2Ray 一键脚本安装教程。

如果是使用的 CentOS 系统，并且需要域名、Nginx、WebSocket 和 TLS 证书等带伪装部署方式，可以参考：CentOS 系统带伪装 V2Ray 一键脚本安装教程：Nginx+WS+TLS 部署。本文只记录 Ubuntu 环境下普通 VMess-TCP 节点的安装流程。

二、通过 SSH 远程连接 Ubuntu 服务器

服务器开通后，需要先通过 SSH 登录 VPS。Windows 用户可以使用 Xshell，具体连接方法可参考：Xshell 通过 SSH 远程连接 VPS 教程。

macOS 用户可以打开系统自带的终端，输入下面命令：

ssh root@ip_address -p ssh_port
# 例如：ssh root@203.0.113.10 -p 22

其中，ip_address 替换为 VPS 的公网 IP 地址，ssh_port 替换为 SSH 端口。登录成功后，就可以检查系统环境并运行 V2Ray 一键安装脚本。

三、检查 Ubuntu 系统版本和基础组件

开始安装前，先确认当前服务器的系统版本和架构。

执行：

cat /etc/os-release

本文测试环境输出：

PRETTY_NAME="Ubuntu 22.04.5 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.5 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu

继续查看系统架构：

uname -m

如果返回：

x86_64

说明当前系统是常见的 64 位 x86 架构，可以继续安装。

如果需要查看 VPS 当前的公网 IPv4 地址，可以执行：

curl -4 ip.sb

如果提示 curl 命令不存在，先执行：

apt update
apt install -y curl wget

后面运行 V2Ray 安装脚本会用到 curl 和 wget，安装前确认这两个命令可以正常使用即可。

查看 Ubuntu 22.04.5 LTS、x86_64 架构和 VPS 公网 IPv4

四、运行 V2Ray 一键脚本安装 VMess-TCP 节点

确认系统环境后，执行下面的 V2Ray 一键安装脚本：

bash <(wget -qO- -o- https://github.com/233boy/v2ray/raw/master/install.sh)

脚本开始运行后，会自动下载 V2Ray Core、V2Ray 脚本文件和 jq 工具。本文测试时，终端输出了下面这些关键内容：

开始安装...
下载 V2Ray
下载 V2Ray 脚本
下载 jq
生成配置文件...

正常情况下，这个脚本会自动生成一个 VMess-TCP 节点，不需要手动输入端口、UUID 或配置文件内容。终端滚动时不要关闭 SSH 窗口，等待节点信息输出完成即可。

安装完成后，脚本会显示类似下面的节点信息：

使用协议: VMess-TCP
协议 (protocol)    = vmess
地址 (address)     = 你的 VPS IP
端口 (port)        = 61416
用户ID (id)        = 脚本生成的 UUID
传输协议 (network) = tcp
伪装类型 (type)    = none

同时还会生成一段 vmess:// 开头的链接。这个链接后面可以导入 V2Ray 客户端。先不要关闭终端，把端口、UUID 和导入链接保存下来，后面配置客户端时会用到。

运行 V2Ray 一键脚本后生成 VMess-TCP 节点参数和 vmess 导入链接

五、保存 VMess-TCP 节点信息和 vmess 链接

如果安装完成后忘记保存节点参数，可以随时在服务器上执行：

v2ray info

本文测试显示的关键信息包括：

• 协议：vmess
• 地址：VPS 公网 IP
• 端口：61416
• 用户 ID：脚本生成的 UUID
• 传输协议：tcp
• 伪装类型：none
• 导入链接：vmess:// 开头的链接

执行 v2ray info 查看 VMess-TCP 端口、UUID、传输协议和导入链接

需要在客户端手动填写时，可以按照下面表格核对：

如果是使用 v2rayN 或 v2rayNG 客户端，可以导入 vmess:// 链接完成节点配置。手动填写时，传输协议要选择 tcp，伪装类型选择 none，TLS 保持关闭，不要改成 WS 或 gRPC 等其它传输方式。

六、检查 v2ray.service 服务运行状态

脚本输出节点信息后，还需要确认服务是否已经启动。执行：

systemctl status v2ray --no-pager -l

本文测试返回的关键内容如下：

● v2ray.service - V2Ray Service
     Loaded: loaded (/lib/systemd/system/v2ray.service; enabled; vendor preset: enabled)
     Active: active (running)
       Docs: https://www.v2fly.org/
   Main PID: 10405 (v2ray)
     CGroup: /system.slice/v2ray.service
             └─10405 /etc/v2ray/bin/v2ray run -config /etc/v2ray/config.json -confdir /etc/v2ray/conf

这里重点看 Active: active (running)。如果服务状态是 running，说明 V2Ray 服务已经正常运行。启动命令中还能看到配置文件路径，下面的服务日志中会显示 V2Ray Core 版本，本文测试时使用的是 V2Ray 5.49.0。

v2ray.service 显示 active running，V2Ray 服务已正常启动

七、检查 V2Ray 端口监听和 UFW 状态

服务状态正常后，再确认脚本生成的端口是否已经监听。本文演示端口为 61416，执行：

ss -tulnp | grep 61416

正常情况下会看到类似输出：

tcp   LISTEN 0      4096               *:61416            *:*    users:(("v2ray",pid=10405,fd=6))

这说明 V2Ray 已经在 61416 端口等待客户端连接。

如果 systemctl status v2ray 显示运行正常，但端口没有监听，先回到上一节检查服务状态；如果本机端口已经监听但客户端连不上，再到 VPS 商家后台检查安全组、防火墙或入站规则，确认这个端口允许外部访问。

本文测试环境中执行：

ufw status

终端输出：

-bash: ufw: command not found

这说明当前系统没有安装 ufw 命令。这和 V2Ray 是否安装成功没有关系，也不能说明端口已经允许外部访问；如果客户端仍然无法连接，还需要检查 VPS 商家后台是否设置了额外的防火墙或入站规则。

检查 V2Ray 端口监听状态，并确认当前系统未安装 UFW

八、查看 V2Ray 配置目录和节点配置文件

233boy 脚本安装后的 V2Ray 配置目录为：

/etc/v2ray

可以执行下面命令查看目录结构：

ls -l /etc/v2ray
ls -l /etc/v2ray/conf

本文测试返回的关键目录和文件包括：

config.json
conf
VMess-TCP-61416.json

其中，主配置文件是：

/etc/v2ray/config.json

当前节点配置文件位于：

/etc/v2ray/conf/VMess-TCP-61416.json

继续查看节点配置文件：

cat /etc/v2ray/conf/VMess-TCP-61416.json

会看到类似下面的核心配置：

{
  "inbounds": [
    {
      "tag": "VMess-TCP-61416.json",
      "port": 61416,
      "listen": "0.0.0.0",
      "protocol": "vmess",
      "settings": {
        "clients": [
          {
            "id": "这里是脚本生成的 UUID"
          }
        ]
      },
      "streamSettings": {
        "network": "tcp",
        "tcpSettings": {
          "header": {
            "type": "none"
          }
        }
      }
    }
  ]
}

查看 /etc/v2ray/conf 目录和 VMess-TCP 节点配置文件

这几个字段和客户端参数有关：

一般不需要手动修改这个配置文件。先确认服务能运行、端口能监听、客户端能导入，再考虑后续的多用户、改端口或其它配置。

九、下载 V2Ray 客户端并导入 VMess 节点

服务端部署完成后，还需要在本地设备安装 V2Ray 客户端。客户端下载可以参考：最新 V2Ray 客户端下载地址（支持各平台），根据 Windows、macOS、Android 或 iOS 设备选择对应版本。

如果客户端支持链接导入，可以复制脚本输出的 vmess:// 链接进行导入。

导入后建议检查下面几项：

• 地址是否为 VPS 公网 IP
• 端口是否为脚本输出的端口
• 用户 ID 是否与脚本输出一致
• 传输协议是否为 tcp
• 伪装类型是否为 none
• TLS 是否关闭

如果是 iOS 用户，并且使用 Quantumult X，也可以参考：Just My Socks 配置 Quantumult X 详细教程 中的节点导入方法。各客户端的界面会有差别，但需要核对的主要参数都是地址、端口、UUID、传输协议和 TLS 状态。

客户端配置完成后就可以测试连接。如果连接失败，可以先按照服务状态、端口监听、客户端参数和 VPS 防火墙这个顺序进行排查。

十、Ubuntu 系统 V2Ray 常用管理命令

安装完成后，日常维护主要用到下面几条命令。

1. 查看当前节点信息

需要查看当前 VMess-TCP 节点参数时，可以执行：

v2ray info

这个命令会显示当前节点的端口、UUID、传输协议和 vmess:// 导入链接。

2. 查看 V2Ray 服务状态

需要确认 V2Ray 服务是否正常运行时，可以执行：

systemctl status v2ray --no-pager -l

如果看到 Active: active (running)，说明服务正在运行。

3. 启动、停止和重启 V2Ray

日常启动、停止或重启 V2Ray 服务，可以使用下面的 systemd 命令：

• 启动：systemctl start v2ray
• 停止：systemctl stop v2ray
• 重启：systemctl restart v2ray

4. 检查端口监听

如果需要确认 V2Ray 是否正在监听节点端口，可以执行：

ss -tulnp | grep 61416

如果节点端口不是 61416，请替换成脚本生成的端口。

5. 查看配置文件

需要核对 V2Ray 配置内容时，可以执行：

cat /etc/v2ray/config.json
cat /etc/v2ray/conf/VMess-TCP-61416.json

如果节点端口不是 61416，配置文件名也会随端口变化，可以先执行：

ls -l /etc/v2ray/conf

然后按照终端列出的文件名查看对应配置文件。

6. 重新打开脚本管理菜单

需要重新进入 233boy 脚本管理菜单时，可以执行：

v2ray

如果系统支持该命令，可以通过脚本菜单继续查看配置、添加节点、删除节点或卸载服务。脚本版本更新后菜单项目可能会调整，以服务器终端显示为准。

如果后续需要给多台设备或多个用户分配独立节点，可以在单节点连接正常后，再参考：V2Ray 多用户配置教程。新手不建议一开始就改多用户配置，先确认当前 VMess-TCP 节点能正常连接，再考虑增加用户或端口。

希望通过网页面板添加和管理 VMess 节点，也可以参考：3X-UI 面板搭建 VMess 节点教程，里面介绍了添加入站、客户端以及导出节点链接的方法。

十一、总结

这篇 Ubuntu 系统 V2Ray 一键脚本安装教程，核心流程是：先确认 Ubuntu 22.04.5 LTS 系统环境，再运行 V2Ray 一键安装脚本，安装完成后保存 VMess-TCP 节点信息，继续检查 v2ray.service、端口监听和 /etc/v2ray 配置文件。

对于需要在安装 Ubuntu 系统的 VPS 上部署 V2Ray 的用户，本文这套流程适合先完成普通 VMess-TCP 节点部署。后续如果需要域名、TLS、Nginx 和 WebSocket 伪装，再单独部署带伪装方案，普通 TCP 节点和 WS+TLS 节点需要按照各自参数进行配置。