🚀 2026 全新 Debian/Ubuntu 安装 v2rayA + Xray-core 避坑终极教程

适用场景： 国内全新 Linux 服务器（Debian 13 / Ubuntu 24.04 及以下版本），无预装环境，无法直接访问 GitHub，需要手动离线安装并解决所有常见路径与协议报错。

🛠️ 第一阶段：核心原理解析

在动手之前，我们需要理解系统的两个核心组成部分：

1. Xray-core (内核)：负责底层流量加密与传输的“发动机”。
2. v2rayA (面板)：负责管理节点、自动分流与提供网页操作界面的“方向盘”。

📂 第二阶段：离线准备工作 (在 Windows 电脑操作)

由于国内服务器无法直接拉取 GitHub 脚本，请先手动下载以下文件：

1. 下载 Xray 内核

• 来源：Xray-core GitHub Releases
• 文件：Xray-linux-64.zip
• 处理：下载后解压，备用里面的 xray、geoip.dat 和 geosite.dat。

2. 下载 v2rayA 安装包

• 来源：v2rayA GitHub Releases
• 文件：installer_debian_amd64_2.3.3.deb (请根据实际架构选择，一般为 amd64/x64)。

💻 第三阶段：服务器端手动部署

通过工具（如 WinSCP, Termius 或宝塔）将上述文件上传至服务器的 /tmp/v2ray 目录。

1. 部署 Xray 内核 (解决“核心未安装”报错)

Bash

 # 创建存放文件夹
 sudo mkdir -p /usr/local/bin
 sudo mkdir -p /usr/local/share/xray
 
 # 移动并赋予执行权限
 sudo cp /tmp/v2ray/xray /usr/local/bin/
 sudo chmod +x /usr/local/bin/xray
 
 # 移动规则数据库
 sudo cp /tmp/v2ray/*.dat /usr/local/share/xray/
 
 # 【必做】建立软连接以兼容部分固执的 UI 扫描
 sudo ln -s /usr/local/bin/xray /usr/local/bin/v2ray
 sudo ln -s /usr/local/share/xray /usr/local/share/v2ray

2. 安装 v2rayA 面板

Bash

 # 使用 apt 安装本地包，它会自动处理缺失的基础依赖（如 iptables）
 sudo apt install /tmp/v2ray/installer_debian_amd64_2.3.3.deb

⚙️ 第四阶段：强制路径配置 (解决 UI 路径报错)

为了防止 v2rayA 启动时“找不到发动机”，我们通过 systemd 强制注入环境变量。

Bash

 # 一键写入覆盖配置
 sudo mkdir -p /etc/systemd/system/v2raya.service.d
 echo -e "[Service]\nEnvironment=\"V2RAYA_V2RAY_BIN=/usr/local/bin/xray\"\nEnvironment=\"V2RAYA_V2RAY_ASSETSDIR=/usr/local/share/xray\"" | sudo tee /etc/systemd/system/v2raya.service.d/override.conf
 
 # 刷新并启动
 sudo systemctl daemon-reload
 sudo systemctl enable --now v2raya

🌐 第五阶段：Web UI 配置与网络排障

1. 局域网访问

在浏览器访问：http://服务器IP:2017。

注意：如果打不开，请尝试关闭防火墙或放行端口：

sudo ufw allow 2017/tcp 或 sudo iptables -F。

2. 解决 unexpected eof 错误 (关键)

如果你能连上节点，但 curl 测试 Google 报错 unexpected eof while reading，说明流量指纹被拦截。

修复步骤：

1. 点击节点列表右侧的 编辑 (小铅笔)。
2. 找到 Fingerprint (指纹) 或 uTLS。
3. 选择 chrome。
4. 保存 (Save) 并重新点击左上角的蓝色 Ready (就绪) 按钮。

📝 踩坑总结表

🔗 参考资源

• 官方手册：v2raya.org
• 内核仓库：GitHub - Xray-core
• 面板仓库：GitHub - v2rayA

教程结束。 希望这份文档能帮到正在折腾 Linux 代理环境的你！