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

它的核心特点是:
- 轻量级:资源占用小,对服务器要求低。
- 简单易用:界面直观,开箱即用。
- 功能全面:满足基本的文件管理需求。
- 开源免费:基于 MIT 许可证,可以免费使用和修改。
安装与部署
File Browser Lite 的安装非常简单,通常只需要一个可执行文件即可。
直接下载运行(推荐用于个人测试)
这是最简单的方式,适合在个人电脑(Windows/macOS/Linux)上快速体验。
-
下载:
(图片来源网络,侵删)- 访问 File Browser Lite 的官方发布页面:https://github.com/filebrowserlite/releases
- 根据你的操作系统下载对应的最新版本(
filebrowserlite-windows-amd64.zip)。
-
解压:
- 将下载的压缩包解压到一个你喜欢的目录,
D:\Tools\FileBrowserLite。
- 将下载的压缩包解压到一个你喜欢的目录,
-
首次运行(初始化):
- 进入解压后的文件夹,双击运行
filebrowserlite.exe(Windows) 或在终端中运行./filebrowserlite(macOS/Linux)。 - 首次启动时,程序会自动在当前目录下创建一个
filebrowserlite.db数据库文件和一个filebrowserlite.json配置文件。 这是必须的,请保留它们。 - 首次运行会打印出访问地址,通常是
http://localhost:8080或http://0.0.0.0:8080,打开浏览器访问这个地址,你就能看到 File Browser Lite 的登录界面了。
- 进入解压后的文件夹,双击运行
-
登录:
- 默认用户名和密码都是
admin。 - 登录后,你就可以看到当前目录下的文件了。
- 默认用户名和密码都是
使用 Docker 部署(推荐用于服务器环境)
如果你有服务器,使用 Docker 是最稳定、最方便的部署方式。

-
确保已安装 Docker。
-
运行命令: 打开终端,执行以下命令,这个命令会拉取镜像、创建一个名为
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: 指定使用的镜像。
-
访问: 部署成功后,在浏览器中访问
http://你的服务器IP:8080即可。
基本使用教程
登录后,你将看到一个简洁的文件管理界面。
文件操作
-
上传文件:
- 点击页面上的 “上传” 按钮。
- 你可以拖拽文件到上传区域,或者点击选择文件。
- 支持多文件同时上传。
-
下载文件/文件夹:
- 单击文件或文件夹,使其被选中(左侧会出现对勾)。
- 点击 “下载” 按钮。
- 对于文件夹:File Browser Lite 会自动将其打包成一个
.zip文件供你下载。
-
预览文件:
- 直接点击文件名。
- 支持预览图片、文本文件、PDF、视频(HTML5播放器)、音频等多种格式。
-
创建文件夹:
- 点击 “新建文件夹” 按钮,输入文件夹名称,按回车或点击确认。
-
重命名:
- 选中一个文件或文件夹。
- 点击 “重命名” 按钮,输入新名称。
-
移动/剪切:
- 选中一个或多个文件/文件夹。
- 点击 “剪切” 按钮(文件会暂时消失)。
- 进入目标文件夹,点击 “粘贴” 按钮。
-
复制:
- 选中一个或多个文件/文件夹。
- 点击 “复制” 按钮。
- 进入目标文件夹,点击 “粘贴” 按钮。
-
删除:
- 选中文件/文件夹。
- 点击 “删除” 按钮,文件会被移动到回收站(如果开启了回收站功能)。
界面导航
- 面包屑导航:页面顶部的路径导航(如
根目录 > 文档 > 工作),可以快速跳转到上级目录。 - 排序:点击列表顶部的“名称”、“大小”、“修改时间”等表头,可以按该列对文件进行升序或降序排列。
- 视图切换:可以切换列表视图和网格视图,方便预览图片。
进阶配置(修改配置文件)
为了安全和个性化,你需要修改默认的配置文件 filebrowserlite.json。
操作步骤:
- 停止 File Browser Lite 程序。
- 用任何文本编辑器(如 VS Code, Notepad++)打开
filebrowserlite.json文件。 - 根据需要修改配置项。
- 保存 文件。
- 重新启动 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 支持存储加密后的密码。
- 打开命令行(CMD 或 PowerShell),进入 File Browser Lite 的安装目录。
- 运行命令:
filebrowserlite -help,查看可用选项。 - 运行命令生成哈希密码:
filebrowserlite -hash "你的新密码" - 复制输出的哈希值(一长串字符)。
- 在
filebrowserlite.json中,将"password"的值替换为这个哈希值。
高级玩法:公网访问(⚠️ 谨慎操作)
如果你想在任何地方都能访问你的文件,需要进行公网访问配置。这会带来安全风险,请务必确保你的操作是安全的!
方法1:使用内网穿透工具(推荐)
内网穿透工具可以在你的本地电脑和公网之间建立一个安全的隧道,无需公网 IP。
- 选择工具:如 frp、ngrok 等,这里以 frp 为例。
- 准备:
- 一台具有公网 IP 的服务器(可以是 VPS、云服务器,甚至是树莓派)。
- 在你的本地电脑上运行 File Browser Lite。
- 配置 frp:
- 在服务器上配置
frps.ini(服务端)。 - 在你的本地电脑上配置
frpc.ini(客户端),将filebrowserlite的端口映射到公网。
- 在服务器上配置
- 启动服务:先启动服务端的 frps,再启动客户端的 frpc。
- 访问:通过 frp 提供的公网 URL 访问你的 File Browser Lite。
优点:安全、灵活,无需修改路由器。 缺点:需要一台公网服务器。
方法2:端口转发(需要公网 IP 和路由器管理权限)
- 获取公网 IP:在百度搜索“IP”,即可看到你宽带的公网 IP,注意,家庭宽带的 IP 可能会变化。
- 设置端口转发:
- 登录你的路由器管理后台(通常是
168.1.1或168.0.1)。 - 找到“端口转发”、“虚拟服务器”或“NAT转发”等选项。
- 添加一条规则:
- 外部端口:
8080(或你设置的任意端口)。 - 内部 IP 地址:你运行 File Browser Lite 的电脑的局域网 IP(
168.1.10)。 - 内部端口:
8080。
- 外部端口:
- 登录你的路由器管理后台(通常是
- 防火墙设置:确保你电脑上的防火墙允许
8080端口的入站连接。 - 动态域名解析(可选但推荐):由于家庭宽带 IP 会变,可以使用花生壳、DDNS 等服务将一个域名绑定到你的动态公网 IP 上。
- 访问:通过
http://你的公网IP:8080或http://你的域名:8080访问。
⚠️ 安全警告:
- 强烈建议将公网访问的端口修改为非 8080 的其他端口(如 8888)。
- 必须修改默认的用户名和密码,并使用哈希后的密码。
- 如果只是临时使用,用完就关闭 File Browser Lite。
- 考虑启用 HTTPS(通常需要配合内网穿透工具和免费证书,如 Let's Encrypt)。
常见问题与总结
-
Q: 我忘记了密码怎么办?
- A: 最简单的方法是删除
filebrowserlite.db和filebrowserlite.json文件,然后重新运行程序,它会恢复到初始状态,但这样会丢失所有用户设置和配置。
- A: 最简单的方法是删除
-
Q: 如何备份数据?
- A: 只需要备份两个文件:
filebrowserlite.db(数据库,包含用户信息和设置)和filebrowserlite.json(配置文件),以及你管理的所有文件。
- A: 只需要备份两个文件:
-
Q: File Browser Lite 和 File Browser 有什么区别?
A: File Browser 是一个功能更强大的项目,支持用户/权限管理、插件、主题等,而 File Browser Lite 是一个简化分支,专注于核心的文件浏览功能,更轻量,配置更简单,如果你的需求简单,Lite 版本完全够用。
File Browser Lite 是一个极佳的个人文件管理工具,特别适合以下场景:
- 在局域网内共享文件给家人或同事。
- 远程管理服务器或 NAS 上的文件。
- 作为轻量级的个人网盘,随时随地访问自己的文件。
希望这份教程对你有帮助!祝你使用愉快!
