Docker 安装 Filebrowser

系统环境： CentOS 7 x64

§前言

Filebrowser 是一个开箱即用的网盘程序，配置过程非常简单（使用 Docker 部署就更简单了），但是功能却很全面，包括了：

目录列表；
在线预览文本和媒体文件；
多用户，支持权限控制和可见范围控制；
分享，可以自定义密码和分享链接有效期；
甚至包含了一个简易的 Web Shell！

官网上的安装说明其实已经足够简明了，俺这里就简单记录下配置过程，补充一点注意事项和进阶配置的说明。

§快速上手

Docker 一条命令即可运行，不过为了可读性和方便复用，俺将这条 Docker 命令保存为了 Shell 脚本：

1
vi Filebrowser-run.sh

写入以下内容并保存：

1
2
3
4
5
6
7
8
docker run -d \
    --name filebrowser \
    -v /CUSTOM_PATH:/srv \
    -v /PATH_OF_DATABASE/filebrowser.db:/database.db \
    --user $(id -u):$(id -g) \
    -p 8080:80 \
    --restart=always \
    filebrowser/filebrowser

参数说明：

CUSTOM_PATH：用于展示的目录，也就是 Filebrowser 可控制的根目录，可以自定义，如果有多个的话，参见后文的进阶配置部分
PATH_OF_DATABASE：存放数据库文件的目录，这一段可以自定义，不过记得在这个目录下手动创建一个名为 filebrowser.db 的新【文件】，否则 Docker 会自动在指定的目录下创建一个名为 filebrowser.db 的新【目录】而非新【文件】，但容器内的 Filebrowser 程序还是将这个新【目录】当作数据库文件来读写，会导致错误
-p：冒号【左边】的 8080 代表外部访问服务时使用的端口，可以自己改，冒号【右边】的 80 是容器内部使用的端口，不要动它

别忘了给这个脚本文件赋予可执行权限：

1
chmod +x Filebrowser-run.sh

最后执行这个脚本：

1
./Filebrowser-run.sh

最后防火墙放行 8080 端口（或者你自定义的其他端口），不出意外的话访问服务器 IP:8080 就能看到 Filebrowser 的登录界面了，默认的帐号密码都是 admin，登录之后尽快改掉。

§进阶配置

§读取多个目录

在上文运行容器的 Docker 命令中，将 -v /CUSTOM_PATH:/srv \ 替换为下面的形式：

1
2
3
    -v /CUSTOM_PATH_1:/srv/CUSTOM_FOLDER_1 \
    -v /CUSTOM_PATH_2:/srv/CUSTOM_FOLDER_2 \
    ...

注意其中冒号【右边】的 CUSTOM_FOLDER_1 和 CUSTOM_FOLDER_2 是文件夹名，不要把冒号左边的整个路径都复制过去，自己随便命名就可以。

§使用域名访问

俺个人是使用的宝塔面板来设置 Nginx 反代的，比较方便，先去 DNS 服务商那里新建一条域名的解析，地址解析到服务器的 IP，然后在宝塔面板中新建一个网站，域名填写刚才新建了解析的域名，PHP 版本选择纯静态就可以，然后在【网站设置】里，配置好 SSL 证书，一键操作就行了，没什么好说的。最后在【反向代理】设置里，新建一条反向代理的规则：

目标域名 http://127.0.0.1:8080 发送域名 $host

目标域名中的端口号注意改成自己之前运行容器时指定的【外部访问端口】，配置好后就可以直接使用域名来访问了，没啥特殊需要的话此时可以配置防火墙关闭 8080 端口了，提高一下安全性。

§使用自定义配置文件

要使用自定义配置文件，在上文运行 Docker 的命令中，在第一行 docker run -d \ 之后，最后一行 filebrowser/filebrowser 之前的任意位置新增一行：

1
    -v /PATH_TO_CUSTOM_CONFIG_FILE/.filebrowser.json:/.filebrowser.json \

其中 PATH_TO_CUSTOM_CONFIG_FILE 是存放自定义配置文件的路径，.filebrowser.json 是自定义配置文件的文件名，配置文件是 json 格式的，默认的配置文件内容如下：

1
2
3
4
5
6
7
8
{
  "port": 80,
  "baseURL": "",
  "address": "",
  "log": "stdout",
  "database": "/database.db",
  "root": "/srv"
}

参数说明如下：

port：默认为 80，容器内部暴露出来的端口，也就是上文中端口映射时冒号【右边】的端口，有需要的话可以自行修改，运行容器的命令也需要对应修改下；
baseurl：默认为空，也就是默认路径在网站根目录下，看不懂这句话的同学简易不要修改这个。如果不想单独解析一个域名或子域名或有其他特殊需求，可以将这一项配置为形如 "/CUSTOM_PATH" 的内容，这样访问 Filebrowser 的路径就变成了 {[DOMAIN]/[IP:PORT]}/CUSTOM_PATH ；
address：【容器内】的 Filebrowser 程序监听的地址，没有特殊需要的话不用动这个；
log：日志输出的位置；
database：默认值为 "/database.db"，【容器内】数据库文件的位置，同样的，没有特殊需求的话不用改；
"root"：默认值为 "/srv"，【容器内】 Filebrower 读写的目录。

参考链接：

Welcome - File Browser