donaldrich/filebrowser

filebrowser（树莓派适用）非官方镜像

镜像概述

本镜像为https://github.com/filebrowser/filebrowser%E7%9A%84%E9%9D%9E%E5%AE%98%E6%96%B9%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC%EF%BC%8C%E4%B8%93%E9%97%A8%E9%92%88%E5%AF%B9%E6%A0%91%E8%8E%93%E6%B4%BE%E7%AD%89ARM%E6%9E%B6%E6%9E%84%E8%AE%BE%E5%A4%87%E4%BC%98%E5%8C%96%E3%80%82filebrowser%E6%98%AF%E4%B8%80%E6%AC%BE%E8%BD%BB%E9%87%8F%E7%BA%A7%E7%BD%91%E9%A1%B5%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E5%99%A8%EF%BC%8C%E9%80%9A%E8%BF%87%E7%9B%B4%E8%A7%82%E7%9A%84Web%E7%95%8C%E9%9D%A2%E5%AE%9E%E7%8E%B0%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F%E7%9A%84%E5%8F%AF%E8%A7%86%E5%8C%96%E7%AE%A1%E7%90%86%EF%BC%8C%E9%80%82%E5%90%88%E8%B5%84%E6%BA%90%E6%9C%89%E9%99%90%E7%9A%84%E5%B5%8C%E5%85%A5%E5%BC%8F%E8%AE%BE%E5%A4%87%E4%BD%BF%E7%94%A8%E3%80%82

核心功能与特性

• 网页界面管理：通过浏览器访问即可管理文件，支持上传、下载、删除、重命名、移动等常用操作
• ARM架构支持：专为树莓派优化，兼容ARMv7/ARM64架构
• 轻量级设计：资源占用低，运行内存需求小，适合嵌入式环境
• 权限控制：支持多用户配置，可自定义不同用户的文件访问权限
• 文件预览：支持文本、图片、音频等多种格式文件在线预览
• 配置持久化：用户设置和权限信息可通过数据库文件持久化保存

使用场景

• 树莓派本地文件管理：替代命令行操作，通过网页界面便捷管理树莓派文件系统
• 家庭小型服务器：在家庭网络中搭建简易文件共享服务，实现多设备文件访问
• 嵌入式设备文件操作：为ARM架构嵌入式设备提供可视化文件管理解决方案
• 开发测试环境：快速部署临时文件管理服务，用于项目资源共享

使用方法

基本部署（docker run）

bash
docker run -d \
  --name filebrowser \
  -p 8080:8080 \
  -v /path/to/local/files:/srv \
  -v /path/to/database.db:/database.db \
  --restart unless-stopped \
  filebrowser-rpi

参数说明：

• -v /path/to/local/files:/srv：挂载本地文件目录到容器内，作为filebrowser管理的根目录
• -v /path/to/database.db:/database.db：挂载数据库文件，用于保存用户配置和权限信息
• -p 8080:8080：端口映射，通过http://<树莓派IP>:8080访问服务
• --restart unless-stopped：设置容器自动重启策略

初始登录

服务启动后，通过浏览器访问http://<树莓派IP>:8080，使用默认账号登录：

• 用户名：admin
• 密码：admin

安全提示：首次登录后请立即修改默认密码

高级配置

可通过环境变量或配置文件自定义服务参数，常用配置项：

• 端口修改：通过-e FB_PORT=8081环境变量指定端口
• 根目录变更：通过-e FB_ROOT=/data环境变量修改管理根目录
• 自定义配置文件：挂载配置文件 -v /path/to/config.json:/config.json

docker-compose部署示例

yaml
version: '3'
services:
  filebrowser:
    image: filebrowser-rpi
    container_name: filebrowser
    ports:
      - "8080:8080"
    volumes:
      - /home/pi/files:/srv
      - /home/pi/filebrowser/db:/database.db
    restart: unless-stopped
    environment:
      - FB_ROOT=/srv
      - FB_PORT=8080

注意事项

• 确保挂载的本地目录具有适当的读写权限（推荐权限：755）
• 树莓派需安装支持ARM架构的Docker引擎（推荐Docker 19.03+版本）
• 此为非官方镜像，建议定期备份数据库文件和重要配置
• 生产环境使用时，建议通过反向代理配置HTTPS加密访问