docker下部署File Browser

FileBrowser 是一个开源的轻量级网页文件管理器,它的核心价值在于:只需一个浏览器,就能像操作本地电脑一样,远程管理服务器、NAS或任何电脑上的文件。
当你成功部署后,上传下载、解压压缩、在线预览,甚至是与朋友分享文件,都只需要一个链接就能完成。GitHub地址:https://github.com/filebrowser/filebrowser

目前官方镜像新版本默认使用 UID/GID 1000 运行,不再使用 root 用户,因此部署时需要特别留意文件权限和挂载方式

下面我将通过一张架构图,帮你直观地理解它如何工作,并附上最推荐的 Docker 部署方式。

🐳 Docker 部署指南

这是最推荐的方式,便于管理。由于 FileBrowser 官方镜像在挂载文件时有个小坑,请按以下步骤操作:

  1. 准备工作 (在宿主机上执行)
    先规划好目录并预先创建必要的文件,可以避免因 Docker 自动创建目录而导致的启动错误。
# 1. 创建存放数据和配置的总目录
mkdir -p /docker/filebrowser/{data,storage}

# 2. 关键步骤:预先创建一个空的数据库文件
# 如果不做这一步,Docker 可能会创建一个名为 database.db 的目录,导致容器启动失败
touch /docker/filebrowser/data/database.db

一键运行容器
使用下面的 docker run 命令启动服务。记得把 /path/to/your/local/files 换成你真实的文件目录。

docker run -d \
  --name filebrowser \
  --restart always \  # 设置容器自动重启
  -v /docker/filebrowser/data:/data \        # 挂载配置和数据库目录
  -v /path/to/your/local/files:/srv \        # 【重要】挂载你的文件目录
  -p 8080:80 \                               # 端口映射,宿主机端口可改
  --user $(id -u):$(id -g) \                 # 使用当前用户权限运行
  filebrowser/filebrowser

如果你的系统不支持自动获取UID,直接用 --user 1000:1000 通常是安全的

获取初始密码
容器首次启动时,会随机生成一个密码,通过查看日志可以获取

docker logs filebrowser 2>&1 | grep -i password

开始使用
在浏览器中输入 http://你的服务器IP:8080 即可访问。默认的用户名通常是 admin,密码就是上一步获取到的密码

  • 腾讯VPS部署
docker run \
    -v /home/docker/filebrowser/data/Downloads/Downloads/:/srv \
    -v /home/docker/filebrowser/filebrowser.db:/database.db \
    -v /home/docker/filebrowser/settings.json:/config.json \
    -e PUID=$(id -u) \
    -e PGID=$(id -g) \
    -p 8282:80 \
    --restart unless-stopped \
    filebrowser/filebrowser

🚀 登录与首次配置

  1. 修改密码:登录后,强烈建议第一时间修改密码。点击左侧 设置 (Settings) -> 个人设置 (Profile Settings) 进行修改。
  2. 切换中文:如果界面是英文,点击 设置 (Settings) -> 全局设置 (Global Settings),在 语言 (Language) 选项中选择 简体中文 后保存即可。

🔧 进阶技巧与建议

  • 多用户管理:可以在“设置”中添加多个用户,并为不同用户指定不同的访问目录(范围)和权限(只读或读写),非常适合团队使用。
  • 公网访问:默认只能在局域网访问。如果想在任何地方连接家里的 FileBrowser,可以了解一下 内网穿透 工具(如 cpolar、ZeroNews、frp 等),它们能为你的服务分配一个公网地址。
  • 数据安全:别忘了备份 /docker/filebrowser/data/ 目录下的 database.db 数据库文件,这里面保存了你所有的用户和配置信息。

部署成功后,你可以试试上传一张图片或一个文档,体验一下在线预览功能。如果在过程中遇到任何权限或访问问题,随时可以再来问我~

Centos7.9下用宝塔部署开源网盘程序Z-file:https://www.hao0564.com/2023.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注