以下是 v2rayA 的完整安装配置指南,适用于 Linux 系统(如 Ubuntu/Debian),支持透明代理、多协议管理,并提供 Web 图形化界面。综合官方文档及最佳实践整理:


🔧 一、安装 v2rayA

步骤 1:安装 V2Ray/Xray 内核

# 一键安装 V2Ray 内核(官方脚本)
sudo bash <(curl -Ls https://install.direct/go.sh)

# 或使用 v2rayA 提供的镜像脚本(推荐国内用户)
curl -Ls https://mirrors.v2raya.org/go.sh | sudo bash

步骤 2:安装 v2rayA

# 添加公钥和软件源
wget -qO - https://apt.v2raya.org/key/public-key.asc | sudo tee /etc/apt/trusted.gpg.d/v2raya.asc
echo "deb https://apt.v2raya.org/ v2raya main" | sudo tee /etc/apt/sources.list.d/v2raya.list

# 更新并安装
sudo apt update
sudo apt install v2raya

步骤 3:启动服务

sudo systemctl start v2raya         # 启动服务
sudo systemctl enable v2raya        # 设置开机自启
sudo systemctl status v2raya        # 验证状态

⚙️ 二、配置 v2rayA

  1. 访问 Web 管理界面
    浏览器打开:👉 http://localhost:2017

    • 首次登录:创建管理员账号(遗忘密码可重置:sudo v2raya --reset-password)。
  2. 导入代理节点

    • 点击 ServerImport,支持以下方式:
      • 节点链接(如 VLESS/VMess/Trojan)
      • 订阅链接
      • 扫描二维码
      • 批量导入。
  3. 启用代理服务

    • SERVER 列表勾选节点(建议不超过 6 个)。
    • 点击左上角 Ready 按钮(蓝色表示已启用)。

🌐 三、代理模式配置

模式 适用场景 配置方法
透明代理 全局代理(推荐🔥) 设置 → Transparent Proxy → 选择分流规则(如 GFWList大陆白名单
系统代理 支持代理的应用(浏览器/终端) 系统设置 → 网络代理 → 手动填写:
- SOCKS5:127.0.0.1:20170
- HTTP:127.0.0.1:20171
浏览器代理 仅浏览器流量 安装 SwitchyOmega 插件 → 配置代理端口同上

💡 透明代理优势:无需应用单独配置,自动接管所有流量,且无 DNS 污染风险。


🐳 四、Docker 部署(NAS/路由器适用)

docker run -d \
  --restart=always \
  --privileged \
  --network=host \
  --name v2raya \
  -v /etc/resolv.conf:/etc/resolv.conf \
  -v /etc/v2raya:/etc/v2raya \
  mzz2017/v2raya
  • 访问界面http://NAS-IP:2017
  • 局域网共享:开启后,其他设备将网关指向 NAS IP 即可全局代理。

⚠️ 五、常见问题解决

问题 解决方案
无法访问 localhost:2017 检查防火墙:sudo ufw allow 2017,并重启服务 sudo systemctl restart v2raya
节点连接失败 验证协议类型(VLESS/VMess)和传输设置(如 gRPC/Reality)是否匹配服务端
DNS 污染 启用 防止DNS污染 选项(设置 → 透明代理 → DNS 设置)
更新 GFWList 规则失败 手动下载规则包 → 点击界面右上角 Update

💎 六、高级功能

  • 多协议支持:VLESS/VMess/SS/Trojan/ShadowsocksR/PingTunnel
  • 分流规则:自定义国内外流量路径(如直连国内网站、代理海外流量)
  • 局域网共享:为同一网络内的设备提供代理服务(需开放防火墙端口)

📚 官方资源

通过 v2rayA,你可轻松实现 Linux 全局代理,无需复杂 iptables 规则,尤其适合 NAS、软路由及开发环境部署 ✅。

最后修改:2025 年 07 月 20 日
如果觉得我的文章对你有用,请随意赞赏