以下是 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
-
访问 Web 管理界面
浏览器打开:👉 http://localhost:2017-
首次登录:创建管理员账号(遗忘密码可重置:
sudo v2raya --reset-password
)。
-
首次登录:创建管理员账号(遗忘密码可重置:
-
导入代理节点
- 点击
Server
→Import
,支持以下方式:- 节点链接(如 VLESS/VMess/Trojan)
- 订阅链接
- 扫描二维码
- 批量导入。
- 点击
-
启用代理服务
- 在
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、软路由及开发环境部署 ✅。