轻量文件管理工具、PT下载的好搭档--Armbian中如何正确安装使用File Browser

File Browser 是一款优秀的文件管理工具，可以通过 Web 界面在指定目录内管理文件，支持上传、下载和目录浏览。File browser 非常轻量，适合在 Armbian 设备上部署，对设备本身或额外挂在的存储设备加以高效利用，将嵌入式设备打造为绿色低功耗的文件服务器。这是一款"自建云存储"类软件，我们只需将其安装在主机上，指向某个路径（指定目录），就能通过美观的网页界面访问文件。对于很多小伙伴需要为Transmission、qBittorrent 等工具找搭子的话，作者 200% 推荐 FileBroswer，一个负责下载、做种，另一个负责管理、转移。

安装与修复

通过 GitHub链接 Releases · filebrowser/filebrowser 可以下合适自己的最新版本，注意如果是电视盒子刷写的 armbian 系统，应下载安装 arm64 架构的版本。

由于 NAS 上都是通过 docker 来进行软件安装和管理的，armbian 设备中，也推荐使用 docker，因此这里使用 docker 安装使用 File Browser。在拉取镜像后，执行下列命令以指定参数创建并启动 FileBrowser 容器。之后，我们会发现无法访问 File Browser，无论是直接拉取官方镜像还是通过第三方 armbian 安装配置工具都没有解决权限问题，导致容器启动失败。

docker run -d -p 8002:80 \
    -v /opt/docker/filebrowser/srv:/srv \
    -v /opt/docker/filebrowser/database:/database \
    -v /opt/docker/filebrowser/config:/config \
    --restart=always \
    --name=filebrowser filebrowser/filebrowser

查看日志，可知权限错误。宿主机 /opt/docker/filebrowser 下的部分目录属主为 root，使用 docker inspect 查看容器信息，可知采用的用户（uid） 1000 是无权访问的。

root@armbian:/# docker logs filebrowser
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied
cp: can't create '/config/settings.json': Permission denied

修改宿主机目录的所有者，执行 chown -vR 1000:1000 /opt/docker/filebrowser 命令以修改 Docker 为 FileBrowser 容器在宿主机创建的目录及其子目录的所有者为 1000 用户。

root@armbian:/# chown -vR 1000:1000 /opt/docker/filebrowser/
changed ownership of '/opt/docker/filebrowser/database' from root:root to 1000:1000
changed ownership of '/opt/docker/filebrowser/srv' from root:root to 1000:1000
changed ownership of '/opt/docker/filebrowser/settings.json' from root:root to 1000:1000
changed ownership of '/opt/docker/filebrowser/config' from root:root to 1000:1000
ownership of '/opt/docker/filebrowser/root' retained as 1000:1000
ownership of '/opt/docker/filebrowser/' retained as 1000:1000

重启 FileBrowser 容器。执行 docker restart filebrowser 命令以重启 Docker 中的 FileBrowser 容器。

root@armbian:/# docker restart filebrowser
filebrowser

重启之后，我们再次查看日志，会发现容器已经正常启动，并在启动过程中生成了随机密码。

root@armbian:/# docker logs filebrowser
cp: can't create '/config/settings.json': Permission denied
...
2026/01/05 03:03:34 Using config file: /config/settings.json
2026/01/05 03:03:34 WARNING: filebrowser.db can't be found. Initialing in /database/
2026/01/05 03:03:34 Using database: /database/filebrowser.db
2026/01/05 03:03:34 Performing quick setup
2026/01/05 03:03:34 User 'admin' initialized with randomly generated password: -raTsoZgtvMIfVm_
2026/01/05 03:03:35 Listening on [::]:80
2026/01/05 03:03:43 Got signal: terminated
2026/01/05 03:03:43 Stopped serving new connections.
2026/01/05 03:03:43 Graceful shutdown complete.
2026/01/05 03:03:45 Using config file: /config/settings.json
2026/01/05 03:03:45 Using database: /database/filebrowser.db
2026/01/05 03:03:45 Listening on [::]:80

这时，我们就可以通过 http://your_armbian_ip:8002 打开并登录 FileBrowser 了。

挂载目标与指定文件夹

File Browser 提供了一个在指定目录内管理文件的界面，这里的指定目录就是我们在运行容器时映射 srv 到宿主机的目录，因此，当我们外挂磁盘时，就需要使用外置磁盘的挂载点。以上个步骤中，最关键的是加载、运行 docker 容器时指定的 srv 映射目标。当使用 /opt/docker/filebrowser/srv 目录时，File Browser 能管理的文件空间上限就是  armbian 系统所在的根文件系统容量。很显然，大多数小伙伴都不会为盒子上可怜的 8-16GB 空间安装个文件管理工具。因此，如果是搭配 transmission 或 qBittorrent，至少也是挂一个外置磁盘，例如 /mnt/bt 作为该外置磁盘的挂载点，那么宿主机的 srv 映射目录必须是 /mnt/bt 或包含  /mnt/bt 的路径。

docker run -d -p 8002:80 \
   -v /mnt/bt:/srv \
   -v /opt/docker/filebrowser/config.db:/database.db \
   -v /opt/docker/filebrowser/settings.json:/config.json \
   --restart=always \
   --name=filebrowser filebrowser/filebrowser

我们可以将 File Browser 的安装和修复分为 3 个步骤。通过 docker logs 查看日志可以看到自动生成的初始随机密码

。

登录之后，除了正常的语言、密码修改之外，在文件、文件夹导航页面，我们看到的就总空间大小就是挂载的磁盘的容量。例如这里，作者就是将 149G 的闲置硬盘挂载作为 pt 长期挂种的。

如果在启动容器时映射了挂载点的上级目录，可以在全局配置中通过用户默认设置的目录范围指定为挂载点。当然，仅对新用户生效，当前用户 admin 的目录范围在指定映射时已经确定，无法缩减。

结语

File Broswer 可以和 Transmission、qBittorrent 等搭配，一个负责下载、做种，一个负责将下好的文件转移到仓库，即便是专门的 NAS 系统，90% 的功能几乎不会用到。下载、整理、播放，海报墙已经是所有播放器的标配，折腾 NAS 的尽头就是 File Broswer。

更多精彩，敬请关注「老 E 的博客」！