📚 打造个人私有文献库：飞牛 OS (FnOS) 部署 Reference

💡 为什么选择 Reference？

随着科研资料与个人知识库的爆炸式增长，一个能够私有化部署、支持跨端同步且对中文文献友好的管理工具显得尤为重要。Reference 凭借其轻量化的设计和强大的元数据抓取能力，成为了飞牛 OS 用户的首选。

📂 环境准备：规范化目录结构

在飞牛 OS 的 文件管理器 中，建议按照以下路径建立文件夹，以便于后期迁移和备份：

• 主存储/docker/reference ——— 项目根目录

• 主存储/docker/reference/data ——— 数据库与文献文件

• 主存储/docker/reference/config ——— 应用配置文件

注意：请记录好该路径，在后续 YAML 代码中需要对应修改。

飞牛 OS (FnOS) 提供了非常友好的图形化镜像部署界面。以下是改用 镜像仓库方式 部署的具体步骤。由于“Reference”可能是指 Refereon（目前 NAS 上最流行的文献管理工具），下文将以此为例：

🛠️ 第一步：拉取正确镜像

1. 打开 Docker 应用，点击左侧菜单栏的 镜像。

2. 点击右上角的 拉取（或 添加）按钮。

3. 在弹出窗口中输入镜像完整名称（请确保名称准确，例如）：

   • refereon/refereon

4. 注意： 如果默认仓库拉取失败，请在“镜像仓库地址”处切换为您在飞牛设置中配置好的加速器地址（如阿里云、腾讯云等）。

5. 点击确定，等待下载完成。

📦 第二步：创建容器（图形化配置）

镜像下载完成后，在镜像列表点击该镜像旁的 “运行” 按钮，进入详细配置界面：

1. 基础设置

• 容器名称：reference-app

• 重启策略：始终重启 (Always)

2. 存储设置 (卷)

点击 添加映射，将我们之前创建的本地文件夹关联到容器内部：

• 本地目录：/vol1/1000/docker/reference/data 👉 容器路径：/app/data (读写)

• 本地目录：/vol1/1000/docker/reference/config 👉 容器路径：/app/config (读写)

3. 网络与端口设置

• 网络模式：默认 bridge。

• 端口转发：

  • 本地端口：填写 8080（如果冲突请改用其他，如 8888）。

  • 容器端口：填写 8080（这是软件默认监听端口）。

4. 环境变量设置 (Environment)

点击 添加环境变量，加入以下关键项：

• PUID = 1000

• PGID = 1000

• TZ = Asia/Shanghai

🚀 第三步：启动与验证

1. 检查配置无误后，点击 下一步，最后点击 完成。

2. 进入 容器 列表，确保 reference-app 状态为 正在运行。

3. 打开浏览器，访问 http://你的NAS-IP:8080。

🚀 四、 进阶 Tips

• 外网访问：建议配合飞牛自带的 DDNS 服务 或通过 Nginx Proxy Manager 配置 SSL，实现远程随时查阅论文。

• 移动端同步：Reference 支持标准 API，您可以使用平板电脑连接 NAS 端的 API 地址，实现“沙发阅读”。

• 自动备份：建议在飞牛的 任务计划 中，设置每天凌晨对 /docker/reference 目录进行快照备份。

✍️ 结语：
通过飞牛 OS 部署 Reference，不仅能让文献管理井井有条，更重要的是实现了数据的自主掌控。如果你在部署过程中遇到任何问题，欢迎在评论区留言交流！

💡项目github地址：jaywcjlove/reference