贝博恩创新科技网

filebrowserlite怎么用?新手必看教程指南

File Browser Lite 详细教程

File Browser Lite 是一个开源的、轻量级的个人文件管理器,你可以把它想象成一个私人网盘私人网盘的简化版,它允许你通过网页浏览器,在局域网或互联网上(需谨慎)上传、下载、预览、重命名、移动和删除你服务器上的文件。

filebrowserlite怎么用?新手必看教程指南-图1
(图片来源网络,侵删)

它的核心特点是:

  • 轻量级:资源占用小,对服务器要求低。
  • 简单易用:界面直观,开箱即用。
  • 功能全面:满足基本的文件管理需求。
  • 开源免费:基于 MIT 许可证,可以免费使用和修改。

安装与部署

File Browser Lite 的安装非常简单,通常只需要一个可执行文件即可。

直接下载运行(推荐用于个人测试)

这是最简单的方式,适合在个人电脑(Windows/macOS/Linux)上快速体验。

  1. 下载

    filebrowserlite怎么用?新手必看教程指南-图2
    (图片来源网络,侵删)
  2. 解压

    • 将下载的压缩包解压到一个你喜欢的目录,D:\Tools\FileBrowserLite
  3. 首次运行(初始化)

    • 进入解压后的文件夹,双击运行 filebrowserlite.exe (Windows) 或在终端中运行 ./filebrowserlite (macOS/Linux)。
    • 首次启动时,程序会自动在当前目录下创建一个 filebrowserlite.db 数据库文件和一个 filebrowserlite.json 配置文件。 这是必须的,请保留它们。
    • 首次运行会打印出访问地址,通常是 http://localhost:8080http://0.0.0.0:8080,打开浏览器访问这个地址,你就能看到 File Browser Lite 的登录界面了。
  4. 登录

    • 默认用户名和密码都是 admin
    • 登录后,你就可以看到当前目录下的文件了。

使用 Docker 部署(推荐用于服务器环境)

如果你有服务器,使用 Docker 是最稳定、最方便的部署方式。

filebrowserlite怎么用?新手必看教程指南-图3
(图片来源网络,侵删)
  1. 确保已安装 Docker

  2. 运行命令: 打开终端,执行以下命令,这个命令会拉取镜像、创建一个名为 filebrowserlite_data 的数据卷(用于存储配置和数据库)并启动容器。

    docker run -d \
      --name filebrowserlite \
      -p 8080:8080 \
      -v /path/to/your/files:/srv \
      -v filebrowserlite_data:/config \
      filebrowserlite/filebrowserlite:latest

    命令解释

    • docker run -d: 在后台运行容器。
    • --name filebrowserlite: 给容器起个名字,方便管理。
    • -p 8080:8080: 将容器的 8080 端口映射到主机的 8080 端口,你可以根据需要修改。
    • -v /path/to/your/files:/srv: 这是最重要的部分,将你主机上的一个目录(/home/user/documents)挂载到容器内的 /srv 目录,这个 /srv 目录就是 File Browser Lite 的根目录。
    • -v filebrowserlite_data:/config: 将容器的配置和数据库目录持久化到主机的 filebrowserlite_data 数据卷中,这样即使容器重启,设置和用户信息也不会丢失。
    • filebrowserlite/filebrowserlite:latest: 指定使用的镜像。
  3. 访问: 部署成功后,在浏览器中访问 http://你的服务器IP:8080 即可。


基本使用教程

登录后,你将看到一个简洁的文件管理界面。

文件操作

  • 上传文件

    • 点击页面上的 “上传” 按钮。
    • 你可以拖拽文件到上传区域,或者点击选择文件。
    • 支持多文件同时上传。
  • 下载文件/文件夹

    • 单击文件或文件夹,使其被选中(左侧会出现对勾)。
    • 点击 “下载” 按钮。
    • 对于文件夹:File Browser Lite 会自动将其打包成一个 .zip 文件供你下载。
  • 预览文件

    • 直接点击文件名。
    • 支持预览图片、文本文件、PDF、视频(HTML5播放器)、音频等多种格式。
  • 创建文件夹

    • 点击 “新建文件夹” 按钮,输入文件夹名称,按回车或点击确认。
  • 重命名

    • 选中一个文件或文件夹。
    • 点击 “重命名” 按钮,输入新名称。
  • 移动/剪切

    • 选中一个或多个文件/文件夹。
    • 点击 “剪切” 按钮(文件会暂时消失)。
    • 进入目标文件夹,点击 “粘贴” 按钮。
  • 复制

    • 选中一个或多个文件/文件夹。
    • 点击 “复制” 按钮。
    • 进入目标文件夹,点击 “粘贴” 按钮。
  • 删除

    • 选中文件/文件夹。
    • 点击 “删除” 按钮,文件会被移动到回收站(如果开启了回收站功能)。

界面导航

  • 面包屑导航:页面顶部的路径导航(如 根目录 > 文档 > 工作),可以快速跳转到上级目录。
  • 排序:点击列表顶部的“名称”、“大小”、“修改时间”等表头,可以按该列对文件进行升序或降序排列。
  • 视图切换:可以切换列表视图和网格视图,方便预览图片。

进阶配置(修改配置文件)

为了安全和个性化,你需要修改默认的配置文件 filebrowserlite.json

操作步骤

  1. 停止 File Browser Lite 程序。
  2. 用任何文本编辑器(如 VS Code, Notepad++)打开 filebrowserlite.json 文件。
  3. 根据需要修改配置项。
  4. 保存 文件。
  5. 重新启动 File Browser Lite 程序。

常用配置项详解

{
  "port": 8080,
  "address": "0.0.0.0",
  "log": "stdout",
  "database": "./filebrowserlite.db",
  "root": "./",
  "username": "admin",
  "password": "admin",
  "recycle": true
}
  • "port": 设置服务监听的端口号,默认是 8080,如果被占用,可以改成其他端口,如 8888
  • "address": 设置服务监听的 IP 地址。
    • "127.0.0.1""localhost": 仅限本机访问,最安全。
    • "0.0.0.0": 允许局域网内任何设备访问,如果你的电脑和手机在同一 Wi-Fi 下,可以用手机 IP 访问。
  • "root": 非常重要! 设置文件管理的根目录,默认是 (即程序运行目录),你可以把它改成你想要管理的文件夹路径,"D:\MyFiles""/home/user/documents"
  • "username""password": 必须修改! 设置你的管理员用户名和密码,以提高安全性。
  • "recycle": 是否开启回收站功能,设置为 true 后,删除的文件会先进入回收站,可以从回收站中恢复,防止误删。

加密密码: 配置文件中的密码是明文存储的,不安全,File Browser Lite 支持存储加密后的密码。

  1. 打开命令行(CMD 或 PowerShell),进入 File Browser Lite 的安装目录。
  2. 运行命令:filebrowserlite -help,查看可用选项。
  3. 运行命令生成哈希密码:filebrowserlite -hash "你的新密码"
  4. 复制输出的哈希值(一长串字符)。
  5. filebrowserlite.json 中,将 "password" 的值替换为这个哈希值。

高级玩法:公网访问(⚠️ 谨慎操作)

如果你想在任何地方都能访问你的文件,需要进行公网访问配置。这会带来安全风险,请务必确保你的操作是安全的!

方法1:使用内网穿透工具(推荐)

内网穿透工具可以在你的本地电脑和公网之间建立一个安全的隧道,无需公网 IP。

  1. 选择工具:如 frpngrok 等,这里以 frp 为例。
  2. 准备
    • 一台具有公网 IP 的服务器(可以是 VPS、云服务器,甚至是树莓派)。
    • 在你的本地电脑上运行 File Browser Lite。
  3. 配置 frp
    • 在服务器上配置 frps.ini (服务端)。
    • 在你的本地电脑上配置 frpc.ini (客户端),将 filebrowserlite 的端口映射到公网。
  4. 启动服务:先启动服务端的 frps,再启动客户端的 frpc。
  5. 访问:通过 frp 提供的公网 URL 访问你的 File Browser Lite。

优点:安全、灵活,无需修改路由器。 缺点:需要一台公网服务器。

方法2:端口转发(需要公网 IP 和路由器管理权限)

  1. 获取公网 IP:在百度搜索“IP”,即可看到你宽带的公网 IP,注意,家庭宽带的 IP 可能会变化。
  2. 设置端口转发
    • 登录你的路由器管理后台(通常是 168.1.1168.0.1)。
    • 找到“端口转发”、“虚拟服务器”或“NAT转发”等选项。
    • 添加一条规则:
      • 外部端口8080 (或你设置的任意端口)。
      • 内部 IP 地址:你运行 File Browser Lite 的电脑的局域网 IP(168.1.10)。
      • 内部端口8080
  3. 防火墙设置:确保你电脑上的防火墙允许 8080 端口的入站连接。
  4. 动态域名解析(可选但推荐):由于家庭宽带 IP 会变,可以使用花生壳、DDNS 等服务将一个域名绑定到你的动态公网 IP 上。
  5. 访问:通过 http://你的公网IP:8080http://你的域名:8080 访问。

⚠️ 安全警告

  • 强烈建议将公网访问的端口修改为非 8080 的其他端口(如 8888)。
  • 必须修改默认的用户名和密码,并使用哈希后的密码。
  • 如果只是临时使用,用完就关闭 File Browser Lite。
  • 考虑启用 HTTPS(通常需要配合内网穿透工具和免费证书,如 Let's Encrypt)。

常见问题与总结

  • Q: 我忘记了密码怎么办?

    • A: 最简单的方法是删除 filebrowserlite.dbfilebrowserlite.json 文件,然后重新运行程序,它会恢复到初始状态,但这样会丢失所有用户设置和配置。
  • Q: 如何备份数据?

    • A: 只需要备份两个文件:filebrowserlite.db(数据库,包含用户信息和设置)和 filebrowserlite.json(配置文件),以及你管理的所有文件。
  • Q: File Browser Lite 和 File Browser 有什么区别?

    A: File Browser 是一个功能更强大的项目,支持用户/权限管理、插件、主题等,而 File Browser Lite 是一个简化分支,专注于核心的文件浏览功能,更轻量,配置更简单,如果你的需求简单,Lite 版本完全够用。

File Browser Lite 是一个极佳的个人文件管理工具,特别适合以下场景:

  • 在局域网内共享文件给家人或同事。
  • 远程管理服务器或 NAS 上的文件。
  • 作为轻量级的个人网盘,随时随地访问自己的文件。

希望这份教程对你有帮助!祝你使用愉快!

分享:
扫描分享到社交APP
上一篇
下一篇