From 9070d7f883d025ee5dfcfec46d1281b8787c4c02 Mon Sep 17 00:00:00 2001 From: "ithink.chan" Date: Tue, 16 Jul 2019 11:44:18 +0800 Subject: [PATCH] =?UTF-8?q?Filebrowser=20=E7=9A=84=E9=83=A8=E7=BD=B2?= =?UTF-8?q?=E5=92=8C=E4=BD=BF=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ithink.chan --- .../Filebrowser/Filebrowser_的部署和使用.md | 106 ++++++++++++++++++ 1 file changed, 106 insertions(+) diff --git a/Software/Application/Filebrowser/Filebrowser_的部署和使用.md b/Software/Application/Filebrowser/Filebrowser_的部署和使用.md index 2c11775..9a58292 100644 --- a/Software/Application/Filebrowser/Filebrowser_的部署和使用.md +++ b/Software/Application/Filebrowser/Filebrowser_的部署和使用.md @@ -1 +1,107 @@ # Filebrowser 的部署和使用 + +Filebrowser 是一款开源的，基于 Go 语言开发的 Web 端文件浏览器，可实现文件上传，下载等。 + +## 下载和安装 + +到 的 Release 中下载对应平台和系统的版本，解压即可使用。 + +## 部署 + +Filebrowser 基于数据库形式的配置文件进行工作，用户可通过 Filebrowser 命令直接操作该数据库，不需要直接与数据库打交道。可以使用 -d 参数指定数据库文件，如没有提供该参数，将使用 filebrowser 程序文件路径下的默认数据库文件，如果该数据库文件不存在则自动创建。 + +使用两个基本指令 config 和 users 即可完成 Filebrowser 的简单配置，config 指令的用法如下： + +```sh +filebrowser config init +# 查看当前属性配置 +filebrowser config cat +# 设置某属性 +filebrowser config set +``` + +用于配置的几个主要属性如下： + +| Attribute | Usage | +|-----------|-------------------------------------------| +| address | address to listen on | +| port | port to listen on | +| baseurl | base url | +| cert | tls certificate | +| key | tls key | +| commands | a list of the commands a user can execute | +| scope | scope for users | +| signup | allow users to signup | +| log | log output | + +users 指令的基本用法如下： + +```sh +# 列出所有用户 +filebrowser users ls +# 删除某用户 +filebrowser users rm +# 添加用户 +filebrowser users add [flags] +``` + +几个常用的的 flag 如下 + +| Flags | Usage | +|------------|----------------------| +| perm.admin | admin perm for users | +| scope | scope for users | + +## 示例 + +部署 Filebrowser 并创建一个管理员账户的示例流程如下： + +```sh +filebrowser -d /etc/filebrowser.db config init +filebrowser -d /etc/filebrowser.db config set --address 0.0.0.0 +filebrowser -d /etc/filebrowser.db config set --port 8088 +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分别是用户名和密码，根据自己的需求更改。 + +部署完成后，可在管理员账户的系统设置界面对系统进行一些其他设置，如视图模式、普通用户权限、区域和语言等。 + +## 利用 Caddy 进行反向代理 + +可以利用 Caddy 为 Filebrowser 做反向代理 + +## 在 Root Domain 进行反向代理 + +不需要修改 Filebrowser 配置，Caddyfile 示例内容如下： + +```sh +example.com { + proxy / 127.0.0.1:8080 +} +``` + +## 在 Sub-directory 下进行反向代理 + +需要先修改 Filebrowser 配置，假设 Sub-directory 为 admin： + +```sh +filebrowser config set --baseurl /admin +``` + +Caddyfile 的示例内容如下： + +```sh +example.com { + proxy /admin 127.0.0.1:808 +} +``` + +或 + +```sh +localhost:2015/admin { + proxy / 127.0.0.1:8080 +} +```