filebrowser- 服务器部署轻量级文件管理系统

type

status

date

summary

slug

filebrowser- 服务器部署轻量级文件管理系统

filebrowser 是一个使用 go 语言编写的软件，功能是可以通过浏览器对服务器上的文件进行管理。可以是修改文件，或者是添加删除文件，甚至可以分享文件，是一个很棒的文件管理器，你甚至可以当成一个网盘来使用。总之使用非常简单方便，功能很强大。

官方项目地址：@filebrowser

DockerHub镜像地址：https://hub.docker.com/r/filebrowser/filebrowser

2025年更新：项目官方自2.33版本开始，更改了一系列配置，详情：https://github.com/filebrowser/filebrowser/releases/tag/v2.33.0

一、安装 Docker Compose （可选）

本次以docker-compose 进行搭建，如果第一次用则需要安装

官方文档： https://docs.docker.com/compose/install/

GIthub项目：https://github.com/docker/compose/releases

①下载源码：

下载源码后还需要添加权限

版本可以到 GIthub项目 查看最新的 releases ，修改地址后下载

②查看结果：

如果显示版本号，则说明安装成功了。

③卸载（如有必要）

二、搭建 filebrowser

两钟方式均可：

①拉取并运行Docker镜像

通过 官方说明 可知，直接输入以下命令即可

②Docker-Compose搭建（推荐）

创建映射文件夹

编写docker-compose.yml

2025年更新：这里需要确认好映射文件的信息，可能是由于版本变化，目前中文网络上的配置映射信息可能已经过时，以下为2.33版本后的配置说明。

使用旧的路径映射会导致数据库无法持久化：即docker重启后用户信息和分享相关信息丢失（表现为账号密码失效）

如果发现无法持久化，去修改映射配置。

下面的docker-compose.yml文件路径已经改写好适应版本：filebrowser v2.40.0（其他版本自行配置）

这里有个注意点

所以我们要在目录下创建新文件~~database.db~~ filebrowser.db以及~~filebrowser.json~~ settings.json

之后还要改一下~~filebrowser.json~~ settings.json

输入以下内容

更改文件权限

进行搭建

三、访问 filebrowser

访问 http://ip:端口 ，就会出现filebrowser登录界面，官方给出了初始账户密码，输入进入即可

Username: admin

Password: ~~admin~~ 新版本会在初始化数据库时生成一次性随机密码

进去可进行自定义修改和配置（英文界面就先进Settings将 Language修改English为中文，然后UPDATE即可）

可以新增用户然后授权，由于这里官方给出的 admin 用户可能删不了，建议直接把 admin 连用户名带密码全改成自己的

之后就可以上传你自己的文件了并使用了

四、自定义样式

访问 设置——全局设置 ，就会出现filebrowser登录界面，官方给出了初始账户密码，输入进入即可

实例名称：填写登录页面显示文字

品牌信息文件夹路径：填写docker-compose.yml 内映射的自定义样式目录，如：/branding ，同样上传文件后需要更改所有样式文件的所有者：

样式文件说明：

/opt/other/filebrowser/branding/img/logo.svg：登录页面的样式图片，必须是svg格式
/opt/other/filebrowser/branding/img/icons/favicon.ico：页头的ico，必须是16*16或32*32大小的
/branding/custom.css：样式，推荐一套如下

五、反代设置

设置nginx 反代配置SSL 证书即可。

也可以通过NPM反向代理可以将 ip+端口 设置为 域名+端口

只需域名指向IP后通过设置NPM即可，这里不多叙述

六、Docker Compose 部署目录文件

filebrowser.zip

7.4KB