本篇要点
- v2rayA 是 V2Ray/Xray 内核的 Web 界面,默认监听 2017 端口。
- Docker 部署时用 host 网络模式,否则局域网设备访问不到。
- 透明代理要配网关与 DNS,只开代理开关不够。
它解决什么
内核本身没有界面。装在一台没有桌面的机器上(软路由、NAS、云服务器),改配置就得登 SSH 手改 JSON,错一个逗号就起不来。v2rayA 把这件事搬到浏览器里:订阅、节点、分流、日志都能点。
它的定位是「管理壳」,不改变内核能力。所以协议支持范围取决于内置的 Xray 版本,而不是界面。
Docker 部署
最省事的是官方镜像,注意用 host 网络,否则容器内的 2017 端口与局域网设备不在同一网段,透明代理会失效:
docker run -d --name v2raya --restart=always \
--network=host \
-v /etc/v2raya:/etc/v2raya \
mzz2017/v2raya起来后访问 http://机器IP:2017,首次会让你创建管理员账号。这个账号只用于面板登录,与订阅无关。
首次配置
- 登录后进入「订阅」页,粘贴订阅地址并更新
- 在「节点」页选中一个节点设为活动节点
- 回首页打开代理开关,先验证出口 IP 是否变化
- 确认可用后再配透明代理与分流,避免一开始就把自己关在门外
透明代理与分流
透明代理需要三样东西对齐:本机开启转发、局域网设备的网关指向这台机器、DNS 交给它处理。只打开开关而不改网关,其他设备仍然走原路由。
| 环节 | 要做什么 | 漏了会怎样 |
|---|---|---|
| IP 转发 | 开启 net.ipv4.ip_forward | 设备指了网关也不通 |
| 网关指向 | 客户端网关改为本机 IP | 流量根本不经过它 |
| DNS | 由 v2rayA 接管或下发 | 解析与连接不一致,部分站点打不开 |
四个常见错误
- 用 bridge 网络部署,面板能开但透明代理对局域网无效
- 把面板端口暴露到公网且没设强密码
- 订阅更新后忘记重新选活动节点,实际还在用旧的
- NAS 上部署却让设备走 Wi-Fi 网关,两条路径互不相关
需要安装包?v2rayA 下载 一页列出各平台安装包与版本核对结果。
常见问题
和 OpenWrt 插件有什么区别?
同一类方案的不同形态,插件与本机系统结合更紧。
能跑在群晖上吗?
可以,Docker 方式最常见。
开机自启怎么配?
容器加 restart=always 即可。
支持 Reality 吗?
取决于内置 Xray 版本。