飞牛OS(fnOS)安装CloudNet教程｜宿主机与Docker双方案部署

CloudNet 是一款轻量、高效的异地组网工具，支持二层穿透、三层路由穿透、内网穿透、设备互联，部署简单、占用资源极低，非常适合 NAS 设备常驻运行。

飞牛OS（fnOS）底层基于 Debian 系统，完美兼容 CloudNet 官方 Linux 安装包，同时支持 Docker 容器部署。本文将提供 原生宿主机安装 和 Docker 容器安装 两种成熟方案，覆盖临时使用和长期稳定部署场景，全程实操无冗余配置。

一、前置准备

1. 开启 fnOS SSH 权限

1. 登录飞牛OS 后台管理界面

2. 进入「设置」→「安全设置」

3. 开启 SSH 服务，设置自定义登录密码

4. 记录 fnOS 内网 IP 地址，使用 Xshell、FinalShell 等工具 SSH 连接

默认端口：22，登录账号为 fnOS 管理员账号

2. 系统环境检查

fnOS 自带 TUN 内核模块、完整网络依赖，无需手动编译内核，完全满足 CloudNet 运行基础条件。

执行命令更新系统依赖（必执行，避免安装报错）： 

apt update && apt install -y curl ca-certificates kmod-tun bash

二、方案一：宿主机原生安装（推荐临时/轻量化使用）

该方案直接在 fnOS 系统内安装 CloudNet，无需依赖 Docker，部署简单、转发效率更高，适合短期使用、快速搭建组网场景。

1. 执行官方一键安装脚本 

curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh

脚本会自动适配系统架构（AMD64/ARM64），完成二进制程序下载、环境配置、基础服务注册。

2. 初始化并启动 CloudNet

安装完成后，执行启动命令，关闭默认 DNS 劫持，避免影响 NAS 正常网络解析： 

cloudnet up --accept-dns=false

3. 设备注册入网

1. 执行注册命令： 

cloudnet register

2. 根据提示输入 CloudNet 组网密钥、设备名称

3. 注册成功后，设备自动接入虚拟组网，可在 CloudNet 控制台查看在线状态

4. 常用基础命令 

# 查看运行状态
cloudnet status

# 重启服务
cloudnet restart

# 停止服务
cloudnet down

# 卸载程序
cloudnet uninstall

⚠️ 方案缺点

飞牛OS 系统 OTA 大版本升级，可能会覆盖宿主机安装的程序，升级后需要重新安装启动 CloudNet。

三、方案二：Docker 容器安装（推荐长期稳定使用）

该方案将 CloudNet 部署在 Docker 容器内，与 fnOS 系统原生环境隔离，不受系统 OTA 升级影响，稳定性更强，是 NAS 常驻服务的最优选择。飞牛OS 默认预装 Docker，无需额外安装环境。

1. 部署容器（一键创建）

SSH 终端执行完整部署命令，自动配置权限、持久化目录、开机自启： 

docker run -d \
  --name cloudnet \
  --privileged \
  --cap-add=NET_ADMIN \
  --device /dev/net/tun \
  --restart=always \
  -v /var/lib/cloudnet:/var/lib/cloudnet \
  cloudnetworld/cloudnet:latest

参数说明：

  • --privileged：授予容器高级网络权限，满足组网穿透需求
  • --device /dev/net/tun：挂载 TUN 虚拟网卡，核心组网依赖
  • --restart=always：Docker 开机自启、容器异常自动重启
  • -v：数据持久化挂载，避免容器重建丢失配置

2. 进入容器完成注册

1. 进入 CloudNet 容器终端： 

docker exec -it cloudnet bash

2. 执行注册命令入网： 

cloudnet register

3. 输入组网密钥、备注设备名称，完成绑定

3. 容器常用运维命令 

# 查看容器运行状态
docker ps | grep cloudnet

# 查看日志
docker logs -f cloudnet

# 重启容器
docker restart cloudnet

# 删除容器（保留数据）
docker rm -f cloudnet

四、常见问题排查

1. 组网连接失败/无法穿透

检查 fnOS 防火墙是否拦截虚拟网卡流量，可临时关闭系统防火墙，或放行 TUN 网卡所有流量。

2. 容器启动失败

大概率是 TUN 模块未加载，执行命令手动加载： 

modprobe tun

3. 系统升级后服务失效

宿主机安装方案：重新执行安装脚本即可；Docker 方案不受影响，直接正常运行。

五、方案选型总结

部署方案 优点 缺点 适用场景
宿主机原生安装 部署简单、转发损耗低、无需Docker依赖 系统升级会清空服务，需重装 临时组网、快速测试、轻量化使用
Docker容器安装 隔离性强、稳定不丢配置、无惧系统升级、自带自启 轻微资源占用，部署步骤稍多 长期常驻组网、生产稳定使用

结语

飞牛OS 依托 Debian 底层生态，完美兼容 CloudNet 所有功能，两种部署方案可满足不同使用需求。日常主力使用优先选择 Docker 容器部署，一次部署长期稳定运行；临时测试可选择原生安装，高效便捷。借助 CloudNet，可轻松实现多设备内网互通、异地组网、内网穿透，大幅提升 NAS 的远程使用便利性。

本文介绍了在飞牛OS fnOS上部署CloudNet异地组网的两种实现方式，Docker方案稳定性更强，适合NAS长期常驻；原生宿主机方案适合快速测试。CloudNet可以简单实现多设备跨网络内网互通，是NAS异地访问的不错选择。