Docker 安装 File Browser

系统环境: CentOS 7 x64

§前言

File Browser 是一个开箱即用的网盘程序,配置过程非常简单(使用 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=unless-stopped \
    filebrowser/filebrowser

参数说明:

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

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

1
chmod +x Filebrowser-run.sh

最后执行这个脚本:

1
./Filebrowser-run.sh

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

§进阶配置

§使用 docker compose 部署

上文中将 docker run 命令保存为 shell 脚本的方式,虽然达到了方便复用的目的,但是终归不是一个优雅的解决方式(比如还需要 chmod +x 来赋予可执行权限)。这里我们使用 docker compose 来部署,只需要修改好配置文件,对容器的启停管理都可以通过 docker compose 命令来执行。下面是 docker-compose.yml 配置文件的内容:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
version: '3'

services:
  filbrowser:
    image: filebrowser/filebrowser
    container_name: filebrowser
    user: $DOCKER_UID_GID
    volumes:
      - /CUSTOM_PATH:/srv
      - /PATH_OF_DATABASE/database.db:/database.db
    restart: unless-stopped
    ports:
      - 8080:80
    logging:
      driver: 'json-file'
      options:
        max-size: '1m'

配置文件的内容,主要是将上文中 docker run 命令的参数转化为了 docker compose 配置文件的参数,应该不需要过多解释。

唯一需要一点 tricky 的是 user 参数,因为 docker compose 配置文件并不能直接获取到当前用户的 uid 和 gid,所以这里使用 DOCKER_UID_GID 环境变量来传入,需要在 .bashrc.zshrc (如果你和俺一样使用了 zsh 的话)文件中追加一行:

1
export DOCKER_UID_GID="$(id -u):$(id -g)"

然后执行 source .bashrcsource .zshrc 来使环境变量生效。

最后执行 docker compose up -d 即可。

§读取多个目录

在上文运行容器的 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_1CUSTOM_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 \

如果是 docker compose 部署的,在配置文件 docker-compose.ymlvolumes 小节增加一行:

1
2
3
4
5
...
    volumes:
      - ...
      - /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" 的内容,这样访问 File Browser 的路径就变成了 {[DOMAIN]/[IP:PORT]}/CUSTOM_PATH
  • address:【容器内】的 File Browser 程序监听的地址,没有特殊需要的话不用动这个;
  • log:日志输出的位置;
  • database:默认值为 "/database.db",【容器内】数据库文件的位置,同样的,没有特殊需求的话不用改;
  • "root":默认值为 "/srv",【容器内】 File Browser 读写的目录。

参考链接:

  1. Welcome - File Browser
加载评论