FileBrowser Quantum 教程3 步搭好一个自托管文件管理器【免费下载链接】filebrowser Web File Browser项目地址: https://gitcode.com/GitHub_Trending/fileb/filebrowserFileBrowser Quantum 是一个开源的自托管文件管理器用浏览器打开就能管理服务器上的文件上传下载、在线预览、分享链接、多用户权限都能在一个地址里完成。它由 Go 编写的后端和 Vue 前端组成发布为单个可执行文件配置集中在一个config.yaml文件里。对普通用户来说它解决的是一件很具体的事家里或机房有一台存着照片、文档、视频的机器你希望不在 SSH 终端里敲ls和scp而是像用网盘一样在网页上直接看、直接管。 首次部署用 Docker 跑起第一个实例如果你的机器上已装好 Docker部署只需要一条命令。仓库的 Docker 镜像名为gtstef/filebrowser内置了 ffmpeg一个用于生成视频、图片预览帧的常用工具链开箱即可用。# 拉取镜像并启动容器把宿主机目录挂到 /srv docker pull gtstef/filebrowser docker run -d --name filebrowser \ -p 8080:80 \ -v /path/to/your/files:/srv \ gtstef/filebrowser容器起来后把浏览器指向http://服务器地址:8080即可看到登录界面。第一次使用时需要创建管理员账号具体字段和行为以仓库内的配置文件为准可参考 backend/config.yaml。整个仓库的源码目录也可以直接阅读构建方式写在 makefile 里。⚙️ 最小配置config.yaml 里该写什么所有行为都由一个 YAML 文件控制最核心的只有三块监听端口、暴露哪些目录、允许什么登录方式。下面是一份可以直接复制运行的最小配置关键字段都加了注释server: port: 8080 sources: - path: /srv # 暴露到 Web 界面的目录可写多个 auth: methods: password: enabled: true minLength: 5 # 密码最小长度 signup: false # 关闭访客自助注册其中sources是理解这个项目的关键它不是一个根目录而是一个目录列表。你既可以只挂一个/srv也可以同时挂照片盘、文档盘、备份盘每个来源有独立的名字、显示和权限设置。 搜索为什么快先建索引再查传统的 Web 文件管理器在搜索时是边遍历磁盘边找文件越多越慢。FileBrowser Quantum 的做法是先把目录树扫进一个 SQLite 索引库一个单文件的轻量数据库搜索时只查这个索引所以输入关键词时结果是边打字边返回的。索引支持按文件大小等条件过滤并且会监控文件变化后更新索引。对于不需要进入搜索结果的文件可以用来源规则排除比如不索引某个缓存目录或某类临时文件server: sources: - path: /srv name: 主存储 config: rules: - folderPath: /.cache # 整个目录不索引 - fileEndsWith: .tmp # 按后缀排除文件规则还支持按文件名、前缀、后缀匹配写法都以仓库文档为准。️ 预览和分享让文件更好看、更好传预览是这个项目花了不少工程的部分图片有缩略图和悬浮放大视频和音频用 ffmpeg 生成帧Office 文档可接入 OnlyOffice 在线查看甚至 3D 模型也能在浏览器里渲染。文件夹本身会显示大小和缩略图列表浏览时不用点进目录就知道里面是什么。分享功能则是把发给别人这件事做得很细每个分享链接可单独设置过期时间和访问密码也可以匿名访问按链接控制对方能否查看、下载、上传粒度到单个文件分享页有自己的主题样式和主界面区分开。对于发个文件给同事但又不想开通账号的场景这一组开关基本够用。 登录方式怎么选项目内置了五种登录方式按场景选即可密码 两步验证2FA默认方式登录时输入一次性动态码适合个人和小团队通行密钥passkey基于 WebAuthn 标准的指纹/屏幕解锁登录适合移动端OIDCOpenID Connect 单点登录企业已有统一身份系统时用它JWT / 反向代理认证在 Nginx 等代理层完成验证后把用户身份传给本服务LDAP对接企业目录服务。这几种方式可以共存管理员还可以按用户指定各自用哪种方式登录。具体配置项在 backend/config.yaml 的auth一节都有注释。 进阶玩法多来源、API 与 WebDAV熟悉基本操作后有三个方向值得看多来源 目录级权限给不同用户绑定不同来源甚至精确到某个用户只能看某几个目录适合按部门划分资料开发者 API为指定用户开启 API 权限后可生成长期有效的 Token接口文档直接暴露在服务的/swagger页面方便写脚本备份或做二次集成WebDAV内置 WebDAV 协议支持可以把这个服务当网盘挂载到 macOS 或 Windows 的资源管理器里不挂载也能通过任何 WebDAV 客户端访问。功能迭代节奏可以在 CHANGELOG.md 里查看想参与开发的话贡献流程写在 CONTRIBUTING.md。 写在最后FileBrowser Quantum 的定位可以概括为一个单文件部署、配置全在 YAML 里、带索引搜索和完整分享权限的 Web 文件管理器。它的 Docker 镜像约 180MB建议至少预留 512MB 内存给容器文件规模越大索引带来的搜索优势越明显。对已经在用同类工具的人来说它的差异点主要在多来源管理、目录级权限和预览覆盖面上对第一次自托管文件管理的人来说一条docker run加一个最小配置就能开始。剩下的照着仓库里的配置注释逐项打开就好。【免费下载链接】filebrowser Web File Browser项目地址: https://gitcode.com/GitHub_Trending/fileb/filebrowser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考