donaldrich/filebrowser

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

镜像概述

本镜像为https://github.com/filebrowser/filebrowser的非官方构建版本，专门针对树莓派等ARM架构设备优化。filebrowser是一款轻量级网页文件管理器，通过直观的Web界面实现文件系统的可视化管理，适合资源有限的嵌入式设备使用。

核心功能与特性

• 网页界面管理：通过浏览器访问即可管理文件，支持上传、下载、删除、重命名、移动等常用操作
• 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 \
  docker.xuanyuan.run/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: docker.xuanyuan.run/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加密访问