Docker 部署 File Browser 文件管理系统

注意：

1. port 为容器端口，官方文档中设置的是 80 端口。个人建议设置为 8080，这样当容器以非 root 身份运行时，也可以监听成功。而如果设置为 80，那么容器只能以 root 身份运行。
2. "root":"/srv"：为容器内的网盘目录，建议设置为 /srv。

3.2. 创建一个空的 filebrowser.db 文件

mkdir -p ./data
touch filebrowser.db

3.3. 运行容器

# -v $CURRENT_DI/opt/filebrowser/data:/srv: 将宿主机目录挂载到容器内的/srv 目录，这是网盘的数据目录
docker run \
  -v /opt/filebrowser/data:/srv \
  -v /opt/filebrowser/filebrowser.db:/database/filebrowser.db \
  -v /opt/filebrowser/setting.json:/config/settings.json \
  -u $(id -u):$(id -g) \
  -p 8080:8080 \
  -d \
  --name filebrowser-server \
  --restart=unless-stopped \
  filebrowser/filebrowser

3.4. 访问

浏览器访问地址：http://<服务器 IP>:8080/files，请将 <服务器 IP> 替换为自己服务器 IP 地址。

[root@localhost filebrowser]# docker logs filebrowser-server
2025/12/29 11:47:55 Using config file: /config/settings.json
2025/12/29 11:47:55 WARNING: filebrowser.db can't be found. Initializing in /database/
2025/12/29 11:47:55 Using database: /database/filebrowser.db
2025/12/29 11:47:55 Performing quick setup
2025/12/29 11:47:55 User 'admin' initialized with randomly generated password: 1_vq2yzAkooehgNf
2025/12/29 11:47:55 Listening on [::]:8080

可以通过日志查看到用户名 admin 和密码 1_vq2yzAkooehgNf，注意每个人密码不一致，请替换成自己的密码。

3.5. 功能介绍

支持在线查看 pdf 文件，图片，视频，txt 文档，目前无法查看 office 文件，分享后，可以发送分享链接给用户，支持多用户多权设置。

4. 常见问题

4.1. listen tcp :80: bind: permission denied

由于在 docker run 时使用了参数 -u $(id -u):$(id -g)，这使得 FileBrowser 以非特权用户身份运行。在容器内部尝试绑定到 80 端口仍然需要特权，从而导致 bind: permission denied 错误。

解决方案：更改容器内的监听端口。最简单的方法是让 FileBrowser 监听一个大于 1024 的端口，比如 8080。