filebrowser
SHA-256轻量自托管 Web 文件管理器，通过浏览器管理服务器上的任何目录。
单文件自建云盘，浏览器管文件。
核心功能
- 单个二进制文件，部署极简（无依赖、无数据库）
- 基于 Web 的图形界面，支持上传、下载、预览、编辑文件
- 支持多用户、权限控制、分享链接
- 文件预览支持图片、视频、音频、文本、PDF 等常见格式
- 可直接在线编辑文本文件（代码、文档）
避坑指南
- •项目已停止新增功能，仅修复 Bug 和安全问题；默认端口 8080 可能与其他服务冲突；生产环境建议启用 HTTPS 和反向代理；不要将根目录设为 `/`，避免越权暴露系统文件；单机部署，不适合高并发或大规模团队
适用场景
- 个人云盘：替代 Dropbox/Nextcloud，轻量管理私人文件
- 团队协作：为小团队提供共享文件目录，无需复杂配置
- 开发调试：快速浏览和编辑服务器上的配置文件、日志
- NAS 管理：配合树莓派等设备，创建低成本文件服务器
详细介绍
File Browser 是一个轻量级的自托管 Web 文件管理器，仅需一个二进制文件即可运行。它将服务器上的任意目录变成一个功能齐全的在线文件管理界面，支持文件上传、下载、删除、重命名、预览以及文本编辑。内置用户认证和权限管理，无需数据库，配置简单。项目当前处于维护模式，功能稳定，适用于个人云存储或团队内部文件共享场景。相比 Nextcloud 等重量级方案，它更轻量、启动更快，是“即装即用”的文件管理选择。
常见问题与排障 (2)
操作指南如何禁用登录界面并跳过FileBrowser中的身份验证？
使用noauth认证方法。运行 filebrowser config set --auth.method=noauth 或在Docker中设置环境变量 FB_NOAUTH=noauth。ID为1的用户将被用作默认用户。
故障排除如何在移动视图中显示文件大小和修改日期列以进行排序？
File Browser 在宽度小于736px的屏幕上会隐藏“尺寸”和“修改”列。要使其可见，请将以下代码添加到你的自定义CSS中（例如，主题的mobile.css）：
@media (max-width: 736px) {
#listing.list .item .size,
#listing.list .item .modified {
display: table-cell !important;
width: auto; /* 如需调整宽度 */
}
}
这会覆盖默认的 display: none。保存后，列会在移动设备上显示，你可以点击表头进行排序。如果某个表头仍然缺失，请检查元素以找到其确切的类名（例如 .sort-name、.sort-modified），并将其添加到规则中。注意：目前尚未提供完整的内置切换功能；请关注官方仓库以获取更新。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：从 GitHub Releases 下载对应系统的二进制文件（filebrowser）
步骤2：在终端运行 `./filebrowser -r /path/to/root`（指定根目录）
步骤3：打开浏览器访问 `http://localhost:8080`，使用默认账号 admin/admin 登录
- 步骤1：从 GitHub Releases 下载对应系统的二进制文件（filebrowser）
- 步骤2：在终端运行 `./filebrowser -r /path/to/root`（指定根目录）
- 步骤3：打开浏览器访问 `http://localhost:8080`，使用默认账号 admin/admin 登录
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
927f81faa996d20295324158aca84bd7a950986fe33b82079e55fd66d0e768cc该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止进程后直接删除二进制文件即可，无残留数据（配置文件和数据库默认在当前目录，如需彻底清除请删除 `.filebrowser.json` 和 `filebrowser.db`）
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs