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 一键脚本安装教程。如果只是想部署一个基础 V2Ray 节点，按本文步骤操作即可。

如果您的服务器配置较低，只需要轻量级代理通信，也可以参考 Ubuntu 系统 Shadowsocks / SS 一键脚本安装教程。V2Ray 和 Shadowsocks 不是同一个方案，本文只讲 Ubuntu 系统安装 V2Ray 的流程。

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

一、准备 Ubuntu VPS 和安装环境

运行 V2Ray 一键脚本前，需要先准备一台可以正常联网的 Ubuntu VPS。本文测试环境如下：

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

如果还没有 VPS，可以先准备一台纯净系统的服务器。准备长期使用的用户可以参考 最新搬瓦工 VPS 注册与购买教程，选择系统时建议直接安装 Ubuntu 22.04 LTS。

如果只是临时测试脚本，也可以选择 Vultr 按小时计费的 VPS，测试完成后释放机器即可。

如果您使用的是 CentOS 系统，不建议直接照搬本文命令。CentOS 的包管理、服务路径和安装脚本可能不同，可以参考 CentOS 系统 V2Ray 一键脚本安装教程。

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

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

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

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

ssh root@ip_address -p ssh_port
#例如：ssh root@192.168.0.1 -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

新开通的 Ubuntu VPS 通常已经带有基础组件，不过安装前先确认 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
• 端口：61416
• 用户 ID：脚本生成的 UUID
• 传输协议：tcp
• 伪装类型：none
• 导入链接：vmess:// 开头的链接

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

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

如果您使用 V2RayN 或 V2RayNG，直接导入 vmess:// 链接更方便。手动填写时不要把这篇普通 VMess-TCP 节点误填成 WS、TLS 或 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

这说明当前 Ubuntu 最小化系统没有安装 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、查看当前节点信息

v2ray info

这个命令可以查看当前 VMess-TCP 节点的端口、UUID、传输协议和 vmess:// 导入链接。

2、查看 V2Ray 服务状态

systemctl status v2ray --no-pager -l

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

3、启动、停止和重启 V2Ray

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

4、检查端口监听

ss -tulnp | grep 61416

如果您的端口不是 61416，请替换成自己脚本生成的端口。

5、查看配置文件

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

如果端口不同，节点配置文件名也会跟着变化，可以先执行：

ls -l /etc/v2ray/conf

查看实际文件名。

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

v2ray

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

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

十一、总结

这篇 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 参数混在一起填。