↓跳到主要内容
  1. 摘记/
  2. notes/

Filebrowser 的使用

2 分钟

简介 #

FileBrowser 原名为 filemanager，曾是 caddy 的一个插件，现在可以独立运行，也可以通过 caddy 来代理访问。
它是基于 go 语言开发的开源轻量级文件管理系统，能够在浏览器上使用查看、下载、修改等各种功能管理文件，File Browser 支持 Windows、Linux 系统，还支持 ARM 架构的设备，例如搭载 ARM 架构处理器的软路由。它支持中文，支持嵌套文件夹上传，在现代浏览器上可以使用拖拽上传多个文件和含子目录的文件夹，上传文件大小没有限制，默认情况下启用 HTTPS。
官网及项目地址：
https://filebrowser.xyz/ （旧官网）
https://filebrowser.org/
https://github.com/filebrowser/filebrowser

Windows 下使用配置 #

注意：CMD 操作是 cd 到所在文件夹直接 filebrowser [flags] 或 [command]；而在 Windows PowerShell 终端里是 cd 到所在文件夹用 .\filebrowser [flags] 或 [command] 操作。

下载 windows 版二进制包，解压到任意位置，注意带文件夹。打开一个管理员 cmd，cd 到 filebrowser.exe 所在目录。

  • 创建数据库/初始化（它会在目录下生成一个初始化内置数据库文件 filebrowser.db) filebrowser.exe -d filebrowser.db config init
  • 设置监听地址和端口(默认 8080)
  • 设置网盘的根目录 filebrowser.exe -d filebrowser.db config set –root E:\file\
  • 设置日志文件位置 filebrowser.exe -d filebrowser.db config set –log filebrowser.log
  • 添加用户（可以不用设置，默认的账号密码：admin/admin） filebrowser.exe -d filebrowser.db users add test 123456 –perm.admin

Linux 下配置使用 #

  1. 创建文件夹 mkdir filebrowser
  2. cd filebrowser
  3. 下载 linux 版二进制包
    wget https://github.com/filebrowser/filebrowser/releases/download/v2.0.3/linux-amd64-filebrowser.tar.gz
  4. 解压 tar zxvf linux-amd64-filebrowser.tar.gz
  5. 配置：
    • 创建数据库，使用 -d 参数指定数据库路径：./filebrowser -d /etc/filebrowser.db config init
    • 设置监听地址：./filebrowser -d /etc/filebrowser.db config set –address 0.0.0.0
    • 设置监听端口(默认 8080) ： ./filebrowser -d /etc/filebrowser.db config set –port 8081
    • 设置云盘路径：./filebrowser -d /etc/filebrowser.db config set –root /root/test
    • 设置语言环境：./filebrowser -d /etc/filebrowser.db config set –locale zh-cn
    • 设置日志位置：./filebrowser -d /etc/filebrowser.db config set –log /var/log/filebrowser.log
    • 添加一个用户：./filebrowser -d /etc/filebrowser.db users add root password –perm.admin，其中的 root 和 password 分别是用户名和密码，根据自己的需求更改。

说明 #

filebrowser config set 参数 更新配置的命令格式
filebrowser config init 初始化数据库的命令格式
filebrowser config cat 查看配置文件的命令

filebrowser config set --address 0.0.0.0
设置访问地址为 0.0.0.0（这个不能变），这样就能在外网或者 192.168.x.x（你的内网地址）访问了。注意，默认的 127.0.0.1 有时不能访问，改成这个就好了。
还要注意不能用默认的 8080 端口，移动电信联通都把这个端口封了，从外面访问不了。

启用 #

配置修改好以后，就可以启动 File Browser 了。打开浏览器访问你的 IP:8081，登录你刚刚创建的用户名和密码就可以了。

快速设置 #

直接使用：
在 windows 环境下直接双击 filebrowser.exe 就可以运行了，然后在浏览器中输入 http://127.0.0.1:8080，出现的登录界面里输入默认的管理员账号和密码（均为 admin）就可以进入管理页面。在 filebrowser.exe 同级目录下会自动生成 filebrowser.db 这个配置文件，不要删除它。

配置使用：
打开 PowerShell ，输入以下命令
filebrowser.exe config set -a 0.0.0.0 -p 8888 修改数据库文件（同时设置地址和端口） filebrowser.db 并生效
.\filebrowser -d filebrowser.db config set --root d:/ 设置根目录为电脑的 D 盘，可根据自己需要改
.\filebrowser.exe -d .\filebrowser.db --disable-preview-resize --disable-type-detection-by-header --cache-dir .\cache 运行程序

在 linux 下运行程序：
/filebrowser/filebrowser -d /filebrowser/filebrowser.db --disable-preview-resize --disable-type-detection-by-header --cache-dir /filebrowser/cache

参数说明：

  • –disable-preview-resize 表示禁止压缩图片，低端服务器最好关上，不然会很卡很卡。普通服务器也最好关上，会生成好多压缩后的图片文件，也就在访问时省一点流量。如果嫌原图片太大，可以自己提前用 windows 系统的图片批量压缩工具处理一下，比访问时让服务器压缩要好。
  • –disable-type-detection-by-header 这个一定要关，加快列表显示速度的，5000个文件的文件夹只要2秒就能显示出来，如果不关，要30秒。不知道为啥不把它设为默认关闭。好多人不知道设这个。
  • –cache-dir .\cache 设置缓存文件夹为当前目录的 cache 文件夹(没有的话自己会建一个)，最好加这个，放置图片缩略图的，第二次访问同目录时，图片缩略图显示会快很多。