在威联通(QNAP)NAS 中安装 V2RayA 和 V2Ray 完整教程
V2RayA 是一款功能强大的 V2Ray 客户端,支持 Web GUI 管理界面、透明代理(全局代理)、订阅导入等多种协议,包括 VMess、VLESS、Trojan、Shadowsocks、SSR 等。它内置了 V2Ray core,所以通常不需要单独安装 V2Ray core。
在威联通 NAS(QTS 系统)上,最推荐的方式是通过 Container Station(容器站)使用 Docker 部署 V2RayA,操作简单且稳定。这个教程适用于大部分 x86_64 架构的威联通 NAS(比如 TS-xxx、TVS 系列等),ARM 架构的 NAS 可能需要额外测试镜像兼容性。
重要提醒
- 操作前记得备份重要数据,NAS 需要有足够的内存(推荐 4GB 以上,运行透明代理时会消耗较多资源)
- 使用 Host 网络模式会占用 NAS 的网络端口,要注意端口冲突问题
- 如果要用于全设备代理,建议结合路由器或在 NAS 上开启透明代理功能
- V2RayA 默认的管理端口是 2017
准备工作
1. 确保 NAS 系统就绪
- 登录威联通 NAS 管理界面(QTS)
- 更新 QTS 固件到最新稳定版本(推荐 QTS 5.x)
- 安装 Container Station(容器站):打开 App Center(应用中心),搜索 "Container Station" 并安装
2. 准备 V2Ray 节点
- 需要有效的 V2Ray/VLESS/Trojan 等订阅地址或节点信息(可以从机场订阅获取)
- 建议使用支持订阅的节点,这样可以一键导入,更方便
安装 V2RayA 容器
- 打开 Container Station
- 点击左侧菜单 容器 > 创建(或 "Create")
- 在搜索框输入
v2raya,选择官方镜像:
- 推荐镜像:
mzz2017/v2raya(最新稳定版) - 点击 创建
- 容器配置(关键设置):
- 名称:自定义,比如
v2raya - 网络:选择 Host(主机网络模式),这样能直接使用 NAS 的 IP 和端口,方便透明代理
- 特权模式:一定要勾选启用特权模式(Privileged),否则透明代理或 iptables 相关功能可能会失败
- 卷挂载(Volume):
- 添加持久化配置:
- 主机路径:
/share/Container/v2raya/config(或其他共享文件夹下的路径) - 容器路径:
/etc/v2raya - 权限:读写(rw)
- 可选额外挂载(解决内核模块问题):
- 主机路径:
/lib/modules - 容器路径:
/lib/modules:ro
- 端口:Host 模式下不需要手动映射端口,默认使用 2017(Web 界面)
- 环境变量(可选):
- 添加
V2RAYA_LOG_FILE=/tmp/v2raya.log(方便查看日志)
- 添加
- 重启策略:选择 "Always" 或 "Unless stopped",确保 NAS 重启后能自动运行
- 资源限制(可选):根据 NAS 配置限制 CPU/内存,避免影响其他应用
- 点击 应用 或 创建,等待容器下载镜像并启动
访问并初始化 V2RayA
- 容器启动成功后,在浏览器输入:
http://你的NAS-IP:2017
- 首次进入会要求创建管理员账号,设置用户名和密码后完成登录
- 导入节点/订阅:
- 进入 "服务器" 或 "Subscriptions" 页面
- 支持手动添加节点、导入订阅链接(vmess\://、vless\:// 等)、二维码识别
- 添加完成后,记得测试节点连通性
- 启用代理:
- 切换到 "设置" 或 "透明代理" 页面
- 开启透明代理(TProxy)模式,实现全局代理(需要特权模式支持)
- 选择代理模式:全局、绕过大陆 IP、智能分流等
- 保存并应用
关于 V2Ray core
V2RayA 的 Docker 官方镜像通常已经内置了 V2Ray core,不需要额外安装。如果需要手动管理 core 或使用独立 V2Ray:
- 在 Container Station 中搜索并部署单独的 V2Ray 容器(镜像如
v2fly/v2fly-core或mritd/v2ray) - 或者通过 SSH 进入 NAS,下载 V2Ray 二进制文件手动运行(不推荐新手)
- 大多数用户直接使用 V2RayA 内置的 core 就足够了
常见问题排查
容器启动失败 / 权限错误
- 确保勾选了 Privileged 模式
- 检查卷挂载路径是否正确(使用 NAS 共享文件夹)
- 查看容器日志:Container Station > 容器 > 选择 v2raya > 日志
无法访问 2017 端口
- 确认容器网络为 Host 模式
- 检查 NAS 防火墙(Control Panel > Security > Firewall)是否放行 2017 端口
- 尝试重启容器或 NAS
透明代理失败 / iptables 错误(如 "No chain/target/match")
- 部分低端 NAS 或旧内核可能缺少模块,尝试在容器运行命令加载(或升级 QTS)
- 可以参考官方 V2RayA Docker 文档添加更多卷挂载
NAS 本机无法走代理
- V2RayA 透明代理主要针对局域网其他设备,NAS 本机代理需要额外配置或使用 socks/http 代理
性能问题
- 透明代理会占用较多 CPU/内存,建议在高配 NAS(如带 i3/i5 处理器、8GB+ 内存)上运行
- 如果只是用于下载工具,可以关闭透明代理,只用 SOCKS5/HTTP 代理
更新 V2RayA
- 在 Container Station 中停止容器,删除旧容器,重新创建并拉取最新镜像即可(配置会保留在卷中)
高级用法
- 对外提供代理:开启端口转发(路由器映射 20172 等端口),结合 DDNS 实现远程使用
- 配合下载工具:在 qBittorrent 等下载工具中设置 SOCKS5 代理指向 NAS IP:1080(V2RayA 默认出站端口)
- 分流规则:在 V2RayA 中导入 geosite.dat/geoip.dat 规则,实现国内直连 + 国外代理
- 社区应用:部分用户可以尝试搜索 "V2Raya" 直接从 MyQNAP.org 社区应用安装(但 Docker 方式更灵活更新)
配置文件示例
以下是一个基本的 V2Ray 配置文件示例,供参考:
{
"inbounds": [
{
"port": 10809,
"listen": "0.0.0.0",
"protocol": "http",
"settings": {
"auth": "noauth",
"udp": true
}
}
],
"outbounds": [
{
"tag": "proxy",
"protocol": "trojan",
"settings": {
"servers": [
{
"address": "vpts.top",
"port": 443,
"password": "A4UWWlPpc"
}
]
},
"streamSettings": {
"network": "ws",
"security": "tls",
"tlsSettings": {
"serverName": "vpimplants.top",
"alpn": ["http/1.1"]
},
"wsSettings": {
"path": "/",
"headers": {
"Host": "vpsmplants.top"
}
}
}
},
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
],
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": [
"geoip:private",
"geoip:cn",
"192.168.2.0/24",
"127.0.0.1"
],
"outboundTag": "direct"
},
{
"type": "field",
"domain": [
"geosite:private",
"geosite:cn",
"localhost"
],
"outboundTag": "direct"
}
]
}
}
总结
通过 Docker 在威联通 NAS 上部署 V2RayA 是一种简单且稳定的方法,不仅可以为局域网内的设备提供代理服务,还可以配合下载工具使用。按照上面的步骤操作,应该能够顺利完成安装和配置。如果遇到问题,可以参考常见问题排查部分,或者查看 V2RayA 的官方文档。
希望这个教程对你有所帮助!