跳转到内容

常用 Compose 应用 ​

这一类里的应用都不是 OMV 插件,而是用 omv-extras 的 Compose 插件跑的容器。每篇文章不是应用的完整手册,只讲在 OMV 上把它跑好的要点:插件示例清单里有没有它、示例落后在哪里、数据放哪、权限怎么配、数据库怎么备份、升级前看什么。

本类文章 ​

  1. Jellyfin:家庭影音库:媒体目录只读挂载、Intel 核显转码,以及元数据刮削的网络问题。
  2. Immich:手机相册备份:多容器应用,示例里的版本已经过时,数据库和照片分开备份。
  3. Nextcloud:私有云盘:AIO、插件示例、官方镜像怎么选,AIO 不在插件备份范围内,外部存储挂共享文件夹。
  4. qBittorrent:下载工具:下载目录权限、WebUI 初始密码,不要暴露到公网。
  5. Syncthing:多设备同步:为什么要用 host 网络、同步不是备份、文件版本与忽略规则。
  6. Paperless-ngx:纸质文档归档:示例缺少 v3 必填的变量,中文 OCR,用导出器备份。
  7. Vaultwarden:自托管密码管理:必须 HTTPS,关闭注册,管理页令牌,离线备份。
  8. 导航页与可用性监控:Homepage 与 Uptime Kuma:一页看全部服务,监控容器和 OMV 自身。

先看这几条 ​

插件示例会落后于应用官方。 截至 2026-10-23,这几个示例有明显问题,每篇文章里都写了怎么改:

应用示例的问题
Immich镜像钉在 v1.118.2,官方最新是 v3.x,要用官方当前的 compose
Paperless-ngx缺少 v3 必填的 PAPERLESS_SECRET_KEY 和 PAPERLESS_DBENGINE
Homepage镜像路径是 2023 年的旧版本,官方路径已经换了
Uptime Kuma用的是 :1,官方现在是 :2
Vaultwarden映射了 80 端口,会撞 OMV 的 Web 界面
Nextcloud示例是 LinuxServer 的单容器,不是 Nextcloud 官方推荐的 AIO,还映射了 443
Syncthing用了桥接网络,官方建议 host 网络

带数据库的应用,备份要用应用自带的导出,或者停机后复制。 插件的计划备份默认会先停容器,所以是安全的;千万别勾选 跳过容器停止 / 启动。细节见更新与备份容器。

哪些应用不要直接暴露到公网:Vaultwarden、qBittorrent、Syncthing 的网页界面、Homepage、Uptime Kuma。外网访问优先用 VPN,见远程访问:别把 NAS 直接暴露到公网。

部署前的通用清单 ​

  1. Compose 插件已经装好,设置页的四个共享文件夹都配好了,见安装 Docker 与 Compose 插件。
  2. 建好专用用户 appuser,规划好每个应用的数据放在哪,见容器权限:PUID、PGID 与共享文件夹。
  3. 从模板添加,部署前对照应用官方文档,再按文章里的说明修改,见部署第一个应用。
  4. 上线前先查端口会不会和 OMV 或别的应用撞车,见写好 compose 文件。
  5. 在存重要数据之前,先想好备份,并做过一次恢复演练。

继续浏览 ​

OpenMediaVault 非官方中文使用指南,与 openmediavault 项目及其开发者无隶属关系。