酷IT

File Browser安装及命令用法

File Browser（文件浏览器）是一种基于GO语言开发的开源轻量级文件管理系统，它能够在浏览器上管理你的文件，让您可以在浏览器上使用查看、下载、修改等各种功能。 你可以把它当作私有云盘来使用。

1、安装
File Browser支持Windows、Linux系统，还支持ARM架构的设备，这样可以在一些ARM架构的设备上运行，例如搭载ARM架构处理器的软路由。
下载地址：https://github.com/filebrowser/filebrowser/releases
官方文档：https://filebrowser.org/

openwrt的安装包

https://op.dllkids.xyz/packages/

openwrt中执行文件位置 /usr/sbin ，新版本替换后，需要在终端中执行chmod -R 777 filebrowser ，更改执行文件权限，才能正常启动服务

根据你的操作系统下载对于的文件，然后解压缩即可。
如果你在windows环境下你可以直接双击filebrowser.exe就可以运行了，然后在浏览器中输入http://127.0.0.1:8080，输入默认的管理员账号和密码（均为admin）就可以看到首页。
而filebrowser.exe同级目录下会自动生成filebrowser.db文件，不要删除它。

1.1 配置中文
在首页点击左侧的Settings，然后找到Language选择中文,最后应用一下，点击UPDATE就可以变成中文了。

2、FileBrowser命令用法
打开命令行，输入filebrowser help就能看到所有可用命令。更多FileBrowser命令和其他功能可以访问官方文档查看https://filebrowser.org/
filebrowser后可以跟参数或命令。官方用法 filebrowser [flags] 或 filebrowser [command]
下面说明基于软件翻译可能描述不专业或不正确。

2.1 filebrowser [flags]
所有可用的参数

  -a, --address string                     要侦听的地址（默认值为 "127.0.0.1""）
  -b, --baseurl string                     基础url
      --cache-dir string                   文件缓存目录（如果为空则禁用）
  -t, --cert string                           tls证书
  -c, --config string                       配置文件路径
  -d, --database string                  数据库路径(默认值 "./filebrowser.db")
      --disable-exec                                     禁用命令运行器功能
      --disable-preview-resize                     禁用调整图像预览的大小
      --disable-thumbnails                           禁用图像缩略图
      --disable-type-detection-by-header   通过读取文件头禁用类型检测
  -h, --help                               帮助
      --img-processors int                 图像处理器计数（默认值4）
  -k, --key string                              tls密钥
  -l, --log string                               日志输出（默认 "stdout"） 
      --noauth                                   使用快速设置时使用noauth auther
      --password string                     使用快速配置时第一个用户的Hash密码（默认为 "admin"）
  -p, --port string                            监听端口（默认为 "8080"）
  -r, --root string                             根以前置到相对路径（默认 "."）
      --socket string                          要侦听的套接字（不能与地址、端口、证书或密钥参数一起使用）
      --socket-perm uint32               unix套接字文件权限（默认438） 
      --username string                    使用快速配置时第一个用户的用户名（默认为 "admin"）

2.1.1 设置访问地址
用法：filebrowser -a 192.168.200.1 或 filebrowser -a=192.168.200.1
结果：浏览器访问http://192.168.200.1:8080

2.1.2 设置访问端口
用法：filebrowser -p 8000
结果：控制台输出Listening on 127.0.0.1:8000，浏览器访问http://127.0.0.1:8000
同时设置地址和端口的话输入filebrowser -a 192.168.200.1 -p 8000,这样你就可用配置访问地址和访问端口了。

2.1.3 设置日志输出位置
用法：filebrowser -l log.log
如果不把路径写全，那么就会在当前程序下创建一个日志文件

后面的参数可以自行测试。

2.2 filebrowser [command]
filebrowser跟命令的话就可以实现很多功能，例如配置访问地址、设置文件地址、账号密码、语言等。
所有可用的命令

  cmds          命令运行程序管理实用程序
  config        配置管理实用程序
  hash          hash密码
  help           关于任何命令的帮助
  rules          规则管理实用程序
  upgrade     升级旧配置
  users       用户管理实用程序
  version     获取版本号

主要讲两个命令，config和users。这两个是经常用到的

2.2.1 config 配置文件相关
用法: filebrowser config [命令]

       可用命令:
        cat            查看配置信息
        export      将配置导出到文件
        import      导入配置文件
        init            初始化新数据库
        set            更新配置

      Flags:
        -h, --help   获取config帮助

(1)查看配置
用法：filebrowser config cat

Sign up:          false               // 关闭注册工程
Create User Dir:  false                  // 关闭自动创建用户目录
Auth method:      json                  // 登录验证方式
Shell:                                  // Shell 相关

Branding:                             // 个性化配置
  Name:
  Files override:
  Disable external links:  false

Server: // 服务器配置                            
  Log:           stdout              // 日志输出名称
  Port:          8080                 // 端口
  Base URL:                          // 访问文件基本路径
  Root:          .                     // 根路径 
  Socket:                             // Socket通信相关
  Address:       127.0.0.1           // 访问地址
  TLS Cert:                          // TLS证书
  TLS Key:                             // TLS 密钥
  Exec Enabled:  false

Defaults: // 初始默认值
  Scope:         .
  Locale:        en                  // 语言
  View mode:     mosaic                 // 文件列表视图样式
  Single Click:  false                 // 关闭单击打开文件及文件夹
  Commands:
  Sorting:
    By:
    Asc:  false
  Permissions:  // 默认权限配置
    Admin:     false                // 管理员
    Execute:   true                 // 执行权限
    Create:    true                 // 创建文件及文件夹
    Rename:    true                 // 重命名
    Modify:    true                 // 修改
    Delete:    true                 // 删除
    Share:     true                 // 可共享
    Download:  true                 // 下载

Auther configuration (raw):   // 身份验证方式，默认空

{
  "recaptcha": null
}

（2）导出配置到文件
用法：filebrowser config export 文件名
实例：filebrowser config export config.json

{
    "settings": {
        "key": "你的KEY",
        "signup": false,
        "createUserDir": false,
        "defaults": {
            "scope": ".",
            "locale": "en",
            "viewMode": "mosaic",
            "singleClick": false,
            "sorting": {
                "by": "",
                "asc": false
            },
            "perm": {
                "admin": false,
                "execute": true,
                "create": true,
                "rename": true,
                "modify": true,
                "delete": true,
                "share": true,
                "download": true
            },
            "commands": [],
            "hideDotfiles": false
        },
        "authMethod": "json",
        "branding": {
            "name": "",
            "disableExternal": false,
            "files": "",
            "theme": ""
        },
        "commands": {
            "after_copy": [],
            "after_delete": [],
            "after_rename": [],
            "after_save": [],
            "after_upload": [],
            "before_copy": [],
            "before_delete": [],
            "before_rename": [],
            "before_save": [],
            "before_upload": [],
            "e": [
                "dir"
            ]
        },
        "shell": [],
        "rules": []
    },
    "server": {
        "root": ".",
        "baseURL": "",
        "socket": "",
        "tlsKey": "",
        "tlsCert": "",
        "port": "8080",
        "address": "127.0.0.1",
        "log": "stdout",
        "enableThumbnails": false,
        "resizePreview": false,
        "enableExec": false,
        "typeDetectionByHeader": false
    },
    "auther": {
        "recaptcha": null
    }
}

（3）导入配置文件
用法：filebrowser config import 文件名
实例：filebrowser config import config.json

（4）更新配置 filebrowser config set 参数
可选的参数

  -a, --address string                     设置访问IP地址(默认 "127.0.0.1")
      --auth.header string                 设置HTTP代理
      --auth.method string                 身份验证类型(默认 "json")
  -b, --baseurl string                         基础URL
      --branding.disableExternal           禁用外部链接，如GitHub链接
      --branding.files string                  有图像和自定义样式的目录路径
      --branding.name string               将“File Browser”替换为此名称
      --cache-dir string                        文件缓存目录（如果为空则禁用）
  -t, --cert string                                  tls证书
      --commands strings                    用户可以执行的命令列表
      --disable-exec                              禁用命令运行程序功能
      --disable-preview-resize             禁用调整图像预览的大小
      --disable-thumbnails                 禁用图像缩略图
      --disable-type-detection-by-header   通过读取文件头禁用类型检测
  -h, --help                               获取帮助
      --img-processors int                 图像处理器计数（默认值4） 
  -k, --key string                         tls密钥
      --locale string                      用户区域设置（默认为“en”）
      --lockPassword                       锁定密码
  -l, --log string                         日志输出（默认“stdout”）
      --perm.admin                         用户管理员权限
      --perm.create                        创建权限 (默认 true)
      --perm.delete                        删除权限 (默认 true)
      --perm.download                      下载权限 (默认 true)
      --perm.execute                       执行权限 (默认 true)
      --perm.modify                        修改权限 (默认 true)
      --perm.rename                        重命名权限 (默认 true)
      --perm.share                         分享权限 (默认 true)
  -p, --port string                        端口 (默认 "8080")
      --recaptcha.host string              use another host for ReCAPTCHA. recaptcha.net might be useful in China (default "https://www.google.com")
      --recaptcha.key string               ReCaptcha site key
      --recaptcha.secret string            ReCaptcha secret
  -r, --root string                        根相对路径 (default ".")
      --scope string                       用户范围（默认“.”）
      --shell string                       附加其他命令的shell命令
  -s, --signup                             允许用户注册
      --singleClick                        仅使用单击文件或文件夹
      --socket string                      要侦听的套接字（不能与地址、端口、证书或密钥标志一起使用） 
      --socket-perm uint32                 unix套接字文件权限（默认438）
      --sorting.asc                        按升序排序
      --sorting.by string                  排序模式（名称name、大小size或已修改modified） (默认 "name")
      --viewMode string                    用户的查看模式（默认 "list"）

实例：filebrowser config set -p 8002
更新端口到配置
使用filebrowser config cat 查看结果。或导出配置到文件查看全部

Sign up:          false
Create User Dir:  false
Auth method:      json
Shell:

Branding:
  Name:
  Files override:
  Disable external links:  false

Server:
  Log:           stdout
  Port:          8002
  Base URL:
  Root:          .
  Socket:
  Address:       127.0.0.1
  TLS Cert:
  TLS Key:
  Exec Enabled:  false

Defaults:
  Scope:         .
  Locale:        en
  View mode:     mosaic
  Single Click:  false
  Commands:
  Sorting:
    By:
    Asc:  false
  Permissions:
    Admin:     false
    Execute:   true
    Create:    true
    Rename:    true
    Modify:    true
    Delete:    true
    Share:     true
    Download:  true

Auther configuration (raw):

{
  "recaptcha": null
}

实例：filebrowser config set -r e://
更新根路径位置，登录系统可以看到E盘下所有的文件了

(5) 初始化数据库
用法：filebrowser config init

2.2.2 users用户相关
用法：filebrowser users [命令]
所有可用命令

        add         创建新用户
        export      将所有用户导出到一个文件
        find        根据用户名或id查找用户
        import      从文件导入用户
        ls          列出所有用户
        rm          根据用户名或id删除用户 
        update      更新现有用户

(1) 添加用户
用法：filebrowser users add <用户名> <密码> [参数]
参数可选

      --commands strings    用户可以执行的命令列表
  -h, --help                帮助信息
      --locale string       用户的语言设置（默认为“en”）
      --lockPassword        锁定密码
      --perm.admin          用户管理员权限
      --perm.create         创建权限 (默认 true)
      --perm.delete         删除权限 (默认 true)
      --perm.download       下载权限 (默认 true)
      --perm.execute        执行权限 (默认 true)
      --perm.modify         修改权限 (默认 true)
      --perm.rename         重命名权限 (默认 true)
      --perm.share          分享权限 (默认 true)
      --scope string        访问范围(默认 ".")
      --singleClick         仅使用单击文件或文件夹
      --sorting.asc         按升序排序
      --sorting.by string   排序模式（名称name、大小size或已修改modified） (默认 "name")
      --viewMode string     用户的查看模式（默认 "list"）

添加账号和密码为123456的用户
实例：filebrowser users add 123456 123456
结果返回：

ID  Username  Scope  Locale  V. Mode  S.Click  Admin  Execute  Create  Rename  Modify  Delete  Share  Download  Pwd Lock
2   123456    .      en      mosaic   false    false  true     true    true    true    true    true   true      false

(2) 导入或导出所有用户到文件
导出
用法：filebrowser users export 文件名
实例：filebrowser users export users.json

导入
用法：filebrowser users import文件名
实例：filebrowser users import users.json

(3)根据用户名或ID查找用户
用法：filebrowser users find 用户名或ID
查找ID为1的用户
实例：filebrowser users find 1

ID  Username  Scope  Locale  V. Mode  S.Click  Admin  Execute  Create  Rename  Modify  Delete  Share  Download  Pwd Lock
1   admin     .      zh-cn   mosaic   false    true   true     true    true    true    true    true   true      false 

查找用户名为admin的用户
实例：filebrowser users find admin

(4) 查找所有用户
用法：filebrowser users ls


(5) 更新现有用户
用法：filebrowser users update 用户名或ID
实例：更新用户名为demo的用户密码为demo
命令：filebrowser users update demo -p demo
部分参数

--locale string       设置语言 (默认"en")
-p, --password string     新密码
-u, --username string     新账号

(6) 删除指定用户
用法：filebrowser users rm 用户名或ID
删除ID为4的用户
实例：filebrowser users rm 4
user deleted successfully
删除用户名为demo的用户
实例：filebrowser users rm demo

3、总结
这些命令对普通用户而言比较复杂，但系统在浏览器上大部分还是可以设置的。下面就汇总一些比较常用的命令用法

1.设置地址和端口：filebrowser -a 192.168.200.1 -p 8000
浏览器访问：http://192.168.200.1:8000

2.设置文件地址：filebrowser -a 192.168.200.1 -p 8000 -r e://
登录系统可以访问E盘下所有的文件

3.每次运行filebrowser不想输入参数，那么可以用config 下的set
如：filebrowser config set -a 192.168.200.1 -p 8000
后面每次启动就不用再次输入-a 192.168.200.1 -p 8000了

4.建议首次运行用filebrowser config export config.json导出配置到文件备份

5.更多玩法可以看官方文档
————————————————
版权声明：本文为CSDN博主「scork」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/weixin_53606308/article/details/115478566