项目介绍
v2rayA 提供代理节点和路由规则的网页管理界面。下面介绍 NAS 部署配置、服务启动和应用连接检查。管理端口、HTTP/SOCKS 代理端口和透明代理是不同入口,应按实际需求分别配置。
部署容器(任选一种方式部署即可)
方法1:手动安装
创建配置文件夹

需要修改的地方均用红色的方框标出


方法二:Docker Compose部署
创建 yaml 存放文件夹

查看文件夹真实路径

复制文件路径,替换到下面的compsoe文件里面
Compose示例
version: "3.8"
services:
v2raya:
image: mzz2017/v2raya:latest
container_name: v2raya
restart: unless-stopped
privileged: true
network_mode: host
environment:
- V2RAYA_LOG_FILE=/tmp/v2raya.log
- V2RAYA_V2RAY_BIN=/usr/local/bin/v2ray
- V2RAYA_NFTABLES_SUPPORT=off
- IPTABLES_MODE=legacy
volumes:
- /lib/modules:/lib/modules:ro
- /etc/resolv.conf:/etc/resolv.conf
- /volume1/docker/v2:/etc/v2raya访问ip:2017
用户名自行设置

在最下面提示参数配置错误,需要在文件管理器中查看Nas是否创建了这个文件夹。

注意事项:
容器安装选择host网络,不要选择bridge网络
补充:部署与使用
群晖 Compose 安装
此方案仅先建立应用级代理,不接管群晖默认路由,也不默认启用透明代理。因此不添加 privileged、host 网络或内核模块挂载;管理及代理端口显式映射。透明代理属于另一种网络部署方式,需要单独核对 DSM 内核及防火墙。
1. 创建项目目录
群晖先安装并启动 Container Manager。通过 SSH 登录后执行下列命令,只为本项目准备目录:
sudo -i
mkdir -p /volume1/docker/v2raya /volume1/docker/v2raya/config
cd /volume1/docker/v2raya
2. 保存完整 Compose
在 /volume1/docker/v2raya/compose.yaml 保存下面的配置。在 Container Manager 中新建项目时,项目路径选择 /volume1/docker/v2raya 并导入该文件;有 .env 的项目要保留它与 Compose 在同一目录。
services:
v2raya:
image: ghcr.io/v2raya/v2raya:latest
container_name: v2raya
restart: unless-stopped
volumes:
- /volume1/docker/v2raya/config:/etc/v2raya
environment:
V2RAYA_ADDRESS: 0.0.0.0:2017
ports:
- 2017:2017
- 20170:20170
- 20171:20171
- 20172:20172
挂载参数冒号左侧是群晖的实际目录,右侧是应用内目录。以上只挂载本项目所需的数据;若已有同类数据,请先备份再调整路径。端口冲突时只改宿主机一侧,应用内端口保持不变。
3. 检查、拉取与启动
cd /volume1/docker/v2raya
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100
浏览器访问 http://群晖IP:2017。群晖IP 替换为自己的 NAS 局域网地址;首次启动时先等待初始化,再检查日志。若群晖仍使用旧 Docker 套件且只有 docker-compose,将命令中的 docker compose 替换为对应命令。
首次使用与验证
在 2017 管理页面创建自己的管理员账号,导入自己的服务配置,选中节点并启动。查看设置中 HTTP/SOCKS5 实际监听端口,再让一个测试应用使用代理;不在教程中预填私人订阅链接。
先保存一条测试数据或完成一次最小任务,再执行 docker compose restart,确认设置及应该持久化的数据仍在。无服务端持久化目录的纯前端工具,应通过自身导出功能保存工作结果。
常见问题
- 页面打不开:运行
docker compose ps检查状态;查看日志里的初始化错误,核对端口冲突和 DSM 防火墙。不要把容器的 IP 当作固定访问地址。 - 数据目录为空:应用内应填写 Compose 冒号右侧的目录;核对宿主机文件是否已放到对应左侧目录。
- 目录无法写入:先查看日志和目录权限,仅为对应数据目录授予镜像实际运行用户需要的权限,不对整个
/volume1设置 777。 - 拉取镜像失败:先排查 Container Manager 的仓库网络;应用自己的 HTTP 代理设置与 Docker 守护进程拉取镜像的代理设置是两件事。
更新、备份与停止
更新前保存 compose.yaml,并备份上面映射的项目数据。数据库服务应先使用自身的数据库备份,或停止整个项目后复制完整数据目录,不能只复制运行中的单个数据库文件。
cd /volume1/docker/v2raya
docker compose pull
docker compose up -d
docker compose logs --tail=100
临时停止使用 docker compose stop,重新启动使用 docker compose start。卸载容器用 docker compose down,不要附加 -v,也不要直接删除宿主机数据目录。涉及数据库迁移的升级,先保留原镜像版本和完整备份,再安排维护窗口。