飞牛 fnOS 部署 V2rayA | This is Sylas's blog

概述与应用场景

在飞牛 fnOS 上配置网络代理，主要用于解决以下常见需求：

需求场景	说明
媒体刮削	Plex、Jellyfin、Emby 等媒体库数据刮削
镜像拉取	Docker 镜像及开源套件的快速下载与更新
外网资源访问	访问受限的国外 API 及网络资源

[!tip] 方案特点本方案仅依赖飞牛 fnOS 单台设备即可完成，无需额外搭建旁路由，配置简单且运行稳定。

部署步骤解析

步骤 1：开启 Docker 模块并准备工作目录

登录飞牛 fnOS 的 Web 操作界面
进入 Docker 应用，若未启动服务，点击开关开启 Docker
打开文件管理（File Station），导航至 docker 目录下
新建一个名为 v2raya 的文件夹（用于持久化存储配置文件及节点信息）

步骤 2：使用 Docker Compose 构建 V2rayA 项目

打开 Docker 管理界面，选择 Compose 标签页
点击右上角新增项目
填写项目配置：
- 项目名称：输入 v2raya（或自定义名称）
- 存储路径：选择步骤 1 中新建的 v2raya 文件夹
选择创建 Docker Compose，并将下方配置文件粘贴至编辑框中
点击确定保存项目创建信息

Docker Compose 配置

version: '3.8'

services:
  v2raya:
    image: mzz2017/v2raya:v2.2.5.7
    restart: always
    container_name: v2raya
    network_mode: host
    privileged: true
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    volumes:
      - ./etc:/etc/v2raya

配置说明：

参数	说明
`image: mzz2017/v2raya:v2.2.5.7`	镜像名，固定为兼容旧规则的稳定版本
`restart: always`	自动重启策略，容器挂了会重新拉起
`network_mode: host`	使用宿主机网络，端口直接绑定到宿主机
`privileged: true`	提升权限，方便操作 iptables 等
`cap_add`	增加额外能力（比 privileged 更细粒度）
`volumes: ./etc:/etc/v2raya`	映射配置目录，重启不会丢失数据

步骤 3：构建并启动容器

在项目列表中找到刚刚创建的 v2raya 项目
点击右侧的构建/启动按钮
此时会弹出终端（Terminal）日志窗口，容器将自动开始拉取镜像并进行初始化
等待构建完成：受网络环境影响，镜像拉取可能需要几分钟，请耐心等待直到完成提示出现
构建成功后，关闭终端窗口，确认 V2rayA 容器状态显示为正在运行

[!warning] 重要提醒容器首次构建时涉及镜像拉取与编译配置，请勿在构建中途强行关闭窗口或重启系统。

V2rayA 后台配置与使用

步骤 1：访问管理界面与初始化

在浏览器打开新标签页，输入：

http://<飞牛NAS的IP地址>:2017

[!note] 首次登录按照提示设置管理员账号与密码（请妥善保存）。

步骤 2：导入订阅与选择节点

点击控制台顶部的导入按钮
将服务商提供的机场订阅链接（Subscription URL）粘贴到输入框中，点击确定
点击右上角的分流/分组菜单，进入已导入节点列表
挑选合适的节点，点击该节点对应的连接

步骤 3：配置分流规则与启动代理

点击右上角的设置（Settings）
根据使用需求设置规则分流模式：

模式	说明	推荐度
大陆白名单	国内流量直连，国外流量走代理	强烈推荐
全局模式	全部流量走代理	备选

点击保存并应用
点击左上角的就绪按钮（代理总开关）
当按钮状态切换为正在运行时，代理服务即正式生效

步骤 4：连通性验证

打开飞牛内置应用或容器服务（如 Chrome 或命令行）
尝试访问 Google、GitHub 或进行 Docker 镜像拉取，验证科学上网功能是否正常运作

核心操作要领

操作阶段	关键要领与注意事项
目录持久化	务必提前创建映射文件夹（如 `v2raya`），确保节点数据和配置文件在容器重启或更新时不丢失
构建耐心等待	容器首次构建时涉及镜像拉取与编译配置，请勿在构建中途强行关闭窗口或重启系统
端口防冲突	V2rayA 默认 Web 管理端口为 2017，若端口被占用，需在 Compose 配置中更改宿主机映射端口
分流模式选择	强烈建议选择大陆白名单模式，以避免 NAS 本地局域网服务及国内流量误走代理，提高传输速度
代理总开关	导入节点和保存设置后，必须点击左上角开关让其显示为”正在运行”，代理才会正式生效

常见问题

Q：端口 2017 被占用怎么办？

在 docker-compose.yml 中修改端口映射，例如改为 2018:2017，然后重启容器。

Q：如何更新 V2rayA 版本？

修改 image 字段的版本号，然后重新构建项目即可。

Q：容器重启后配置会丢失吗？

不会，因为配置文件已通过 volumes 映射到宿主机的 ./etc 目录。

[!tip] 记不住所有命令没关系先记住三个关键步骤：创建目录 → 粘贴配置 → 启动容器。这三个用熟了，再慢慢学其他的。