OpenMediaVault 使用指南

外观

入门官方插件开源网络暴露风险OMV 8.x

资料核查：2026-10-23T00:00:00.000Z；尚无本站实机验证记录，请按文中的检查步骤确认本机结果。

FileBrowser：网页文件管理（官方插件） ​

完成后，在浏览器里打开 http://<NAS 地址>:3670，登录后可以上传、下载、预览、重命名和编辑一个共享文件夹里的文件，不需要在电脑上挂载 SMB。

适合谁 ​

  • 偶尔在没有挂载 SMB 的电脑、手机上取放几个文件。
  • 想给家人一个简单的网页入口。

不适合：

  • 要同时浏览多个共享文件夹。插件一次只能选一个共享文件夹。
  • 要精细的多用户权限和审计，可以改用 Compose 版本的文件管理应用，见 插件还是容器。

别和 omv-extras 的 filemanager 插件混淆

omv-extras 另有一个原生的 openmediavault-filemanager 插件。截至 2026-10-22，它还不在 omv-extras 的 OMV 8 软件源里，系统 → 插件（System → Plugins）里装不到。本文讲的是官方的 FileBrowser。

默认账号是 admin / admin，能读写整个共享文件夹

  • 影响范围：登录后，被授权的用户可以修改、删除所选共享文件夹里的全部内容。第一次登录用 admin / admin（界面有提示），没有选证书时是明文 HTTP。FileBrowser 里删除的文件不会进入 SMB 的回收站，那只对 SMB 删除生效。
  • 前置条件：第一次登录就改管理员密码；不要把端口映射到公网，要远程用就走 VPN 或有 HTTPS 的反向代理；给不信任的用户只授予最小权限；选一个专用的共享文件夹，不要选存了全部重要数据的根目录。
  • 怎么回退：取消勾选 已启动，保存并应用，服务停止并移除 systemd 单元；共享文件夹里的数据不变。

插件信息 ​

项内容
包名openmediavault-filebrowser
来源官方插件，不需要 omv-extras
OMV 8 状态截至 2026-10-18 的官方软件源为 8.0.6-1（amd64、arm64）
菜单位置服务 → 文件管理器（Services → File Browser）
依赖podman、catatonit、nftables。安装时创建系统用户 filebrowser，属于 users 组

在 系统 → 插件（System → Plugins）里安装。8.0 起用的是 FileBrowser 的 Quantum 分支，旧数据库会自动迁移。

它是怎么运行的 ​

  • 容器：一个 Podman Pod filebrowser，里面是 filebrowser-app，选了证书时再加一个 Caddy 容器 filebrowser-proxy 提供 HTTPS。由 systemd 单元 pod-filebrowser 管理。
  • 镜像从哪拉：Docker Hub，默认 docker.io/gtstef/filebrowser:stable，Caddy 是 docker.io/library/caddy:latest。访问不了 Docker Hub 时，用环境变量 OMV_FILEBROWSER_APP_CONTAINER_IMAGE 和 OMV_FILEBROWSER_PROXY_CONTAINER_IMAGE 换成别的地址，用法见 环境变量。
  • 数据放哪：
    • 所选共享文件夹整个挂进容器的 /srv/，它就是 FileBrowser 里看到的根目录；
    • FileBrowser 自己的配置和数据库在宿主机的 /var/lib/filebrowser/（config.yaml 和 database.db），位于系统盘上。
  • 谁在读写文件：容器以 filebrowser 用户和 users 组运行。不管你在 FileBrowser 里用哪个账号登录，对文件系统来说都是这一个用户，所以文件系统层面的权限不能区分登录的人，区分只靠 FileBrowser 里的用户设置。共享文件夹默认的 root:users、2775 权限就够它读写。
  • 新建的文件和目录权限，按当前源码默认是 664 和 775，同组的 users 能继续读写。可以用环境变量 OMV_FILEBROWSER_APP_CREATEFILEPERMISSION 和 OMV_FILEBROWSER_APP_CREATEDIRECTORYPERMISSION 调整。

配置与使用 ​

1. 配置插件 ​

服务 → 文件管理器：

字段默认值说明
已启动（Enabled）关
端口（Port）3670监听端口
证书（Certificate）空选一个 系统 → 证书（System → Certificates）里的 SSL 证书就会启用 HTTPS，不选是 HTTP
共享文件夹（Shared folder）无要管理的共享文件夹，启用时必填

保存，点黄色提示条上的应用。第一次应用会拉取镜像，可能要几分钟。点 打开 UI（Open UI）跳到 FileBrowser 页面。

2. 第一次登录 ​

  1. 打开 http://<NAS 地址>:3670，用 admin / admin 登录。
  2. 马上改密码。
  3. 在 FileBrowser 的设置里为需要的人建账号。按插件生成的默认配置，新用户没有修改（modify）、分享（share）、管理（admin）和 API 这几项权限，也就是只读使用，要逐项授予。分享会生成别人可以直接打开的链接，只给确实需要的人。

FileBrowser 的账号是它自己的，和 OMV 用户没有关系，不会同步。

检查结果 ​

在 OMV 的 shell（root）里，只读确认：

sh
# 在 OMV 的 shell 里执行（root）
systemctl status pod-filebrowser
podman ps --pod                  # 应有 filebrowser-app，选了证书时还有 filebrowser-proxy
podman logs filebrowser-app      # 应用日志

然后：

  1. 在浏览器里上传一个测试文件，在 NAS 上用 SMB 或 ls 确认它出现，属主是 filebrowser、属组是 users。
  2. 用一个新建的普通账号登录，确认它不能删除文件。
  3. 重启 NAS，确认服务自动起来。

备份与维护 ​

  • 数据都在共享文件夹里，按 备份策略 备份。FileBrowser 的账号、分享链接保存在 /var/lib/filebrowser/database.db，重装系统时会丢，建议备份。
  • 升级：容器用本地已有的镜像启动，不会自动更新。官方没有文档化升级流程，按插件生成的单元文件推断：先拉新镜像（服务 → Podman → 镜像（Services → Podman → Images）里的拉取，或 podman pull docker.io/gtstef/filebrowser:stable），再 systemctl restart pod-filebrowser，容器会用新镜像重建。升级前备份数据库文件。
  • 额外的运行参数：环境变量 OMV_FILEBROWSER_APP_CONTAINER_START_OPTIONS 可以给容器追加 podman run 参数。
  • 卸载插件：移除 systemd 单元，共享文件夹里的文件不受影响。

常见问题 ​

浏览器是空白页。 先强制刷新（Ctrl+Shift+R），再确认插件是较新的版本。官方 issue 里有人在更早的插件版本上遇到过空白页，更新后恢复。

登录后看不到文件，或提示没有权限。 filebrowser 用户或 users 组要能读这个共享文件夹。检查共享文件夹的权限和 ACL，见 三层权限。

上传的文件，SMB 用户改不了。 文件属主是 filebrowser。属组是 users 并且权限含组写入（默认 664）时，同组用户可以改；否则检查权限设置。

想让它显示多个共享文件夹。 插件只挂一个。可以新建一个共享文件夹作为上层，或改用 Compose 版本，见 插件还是容器。

应用时拉取镜像失败。 通常是访问不了 Docker Hub，见上面的镜像环境变量。

参考资料 ​

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