飞牛NAS搭建在线Office：OnlyOffice部署

为什么要在飞牛NAS上部署OnlyOffice

在日常使用NAS的过程中，我们经常会遇到需要临时查看或编辑文档的场景。虽然飞牛NAS自带文件预览功能，但对于Office文档的支持始终不够完善。而OnlyOffice作为一款开源的在线办公套件，不仅完美兼容微软Office格式，还支持多人实时协作，配合飞牛NAS使用，可以轻松搭建一个私有的云端办公环境。

相比其他方案，OnlyOffice的优势在于部署简单、资源占用可控，并且与Nextcloud、Seafile等主流网盘系统都能完美集成。本文将以飞牛NAS的Docker功能为基础，手把手教你完成OnlyOffice的部署。

部署前的准备工作

在开始部署之前，请确认你的飞牛NAS满足以下条件：

系统版本为fnOS 0.8.1或更高版本
已启用Docker应用（在应用中心安装）
至少分配2GB内存给Docker容器
预留10GB以上的存储空间（用于镜像和文档缓存）
拥有管理员权限，可以操作SSH终端或Docker管理界面

方法一：通过飞牛NAS的Docker界面部署

飞牛NAS自带了一个图形化的Docker管理界面，对于不熟悉命令行的用户来说，这是最直观的部署方式。

第一步：创建OnlyOffice容器

打开飞牛NAS的「应用中心」→「Docker」→「容器」页面，点击右上角的「添加」按钮。在镜像搜索框中输入 onlyoffice/documentserver，选择最新版本（latest）并点击下载。

等待镜像下载完成后，点击「创建容器」，进行以下配置：

容器名称填写 onlyoffice，端口映射设置为 8080:80（左侧为宿主机端口，可自定义；右侧为容器内固定端口）。

第二步：配置存储卷

在「存储」选项卡中，添加一个本地目录映射到容器内的 /var/log/onlyoffice 和 /var/www/onlyoffice/Data 路径。建议在飞牛NAS的共享文件夹中新建一个 onlyoffice-data 目录，用于持久化存储文档数据，这样即使容器重建，文档也不会丢失。

第三步：设置环境变量

在「环境」选项卡中，添加以下关键变量：

JWT_ENABLED=true：启用JWT令牌认证，增强安全性
JWT_SECRET=your_random_secret_key：设置一个足够复杂的随机字符串作为密钥
JWT_HEADER=Authorization：保持默认即可

如果你希望限制OnlyOffice的访问来源，可以额外添加 ALLOW_PRIVATE_IP_ADDRESS=false，避免文档服务器被外部网络直接访问。

点击「创建」后，等待容器启动。首次启动需要一分钟左右进行初始化，可以在日志中观察启动进度。

方法二：通过SSH命令行部署

如果你习惯使用命令行，或者希望通过docker-compose进行更精细的控制，可以按照以下步骤操作。

第一步：连接SSH终端

通过SSH登录飞牛NAS，切换到管理员账户。

第二步：创建docker-compose文件

在你想存放配置文件的目录下（例如 /vol1/docker/onlyoffice），创建 docker-compose.yml 文件，内容如下：

version: '3'

services:
  onlyoffice:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice
    restart: always
    ports:
      - "8080:80"
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=your_strong_secret_key_here
      - JWT_HEADER=Authorization
    volumes:
      - ./logs:/var/log/onlyoffice
      - ./data:/var/www/onlyoffice/Data
      - ./lib:/var/lib/onlyoffice
      - ./db:/var/lib/postgresql

注意 JWT_SECRET 请务必替换成你自己的随机字符串，可以使用 openssl rand -hex 32 命令生成。

第三步：启动容器

在配置文件所在目录下执行：

docker-compose up -d

等待镜像拉取和容器启动完成后，可以通过 docker ps 命令确认容器运行状态。

验证部署是否成功

部署完成后，在浏览器中访问 http://你的飞牛NASIP:8080，如果看到OnlyOffice的欢迎页面，说明部署成功。你可以点击页面上的「Editor」按钮，测试新建和编辑文档。

如果页面无法访问，请检查：

防火墙是否放行了8080端口
容器日志中是否有报错信息
飞牛NAS的Docker网络是否正常

与飞牛NAS文件系统集成

OnlyOffice部署完成后，我们可以通过飞牛NAS的文件管理功能，将在线编辑整合到日常使用中。

最简单的集成方式是使用飞牛NAS的「外部链接」功能。在文件管理器中，找到任意一个Office文档，右键选择「获取分享链接」，然后在OnlyOffice页面中通过「打开文件」→「输入URL」来加载该文件。

不过这种方式稍显繁琐，更推荐的方案是使用飞牛NAS自带的「WebDAV」功能配合OnlyOffice。首先在飞牛NAS中启用WebDAV服务，然后在OnlyOffice的「连接到云」选项中选择WebDAV，填入飞牛NAS的地址、账号密码，即可直接浏览并编辑NAS上的所有Office文档。

进阶优化与注意事项

内存与性能调优

OnlyOffice对内存的占用相对较高，如果发现NAS在运行OnlyOffice时响应变慢，可以在docker-compose中添加内存限制：

    mem_limit: 4g
    cpu_shares: 1024

这样可以将资源占用限制在可控范围内。

安全加固建议

由于OnlyOffice默认监听所有网络接口，建议在飞牛NAS的防火墙中限制8080端口的访问来源，仅允许内网IP访问。同时务必修改默认的JWT密钥，防止未授权访问。

数据备份

OnlyOffice的文档数据存储在 /var/www/onlyoffice/Data 目录下，建议定期将该目录备份到飞牛NAS的其他磁盘或外部存储中。你也可以利用飞牛NAS的「快照」功能，对存放OnlyOffice数据的共享文件夹设置定期快照，实现秒级恢复。

总结

通过以上步骤，你已经在飞牛NAS上成功搭建了OnlyOffice在线Office服务。无论是临时查看文档，还是多人协作编辑，都能获得接近微软Office的流畅体验。结合飞牛NAS本身的文件管理能力，这套方案完全可以替代公有云办公套件，让数据始终掌握在自己手中。后续你还可以进一步研究OnlyOffice与飞牛NAS的API对接，实现更深度的自动化办公流程。