FileBrowser Quantum 快速上手：一条命令部署自托管文件管理器完整指南

FileBrowser Quantum 快速上手一条命令部署自托管文件管理器完整指南【免费下载链接】filebrowser Web File Browser项目地址: https://gitcode.com/GitHub_Trending/fileb/filebrowser它是什么把服务器硬盘变成网页网盘先给结论FileBrowser Quantum 是一个免费、开源的自托管文件管理器把它部署到家里的服务器或任意闲置机器上之后在浏览器里就能浏览、搜索、预览和分享这台机器上的文件全程无需安装客户端。它以一个单二进制文件或一个 Docker 镜像交付Docker 镜像约 180MB已含 ffmpeg最低内存需求 512MB。它适合三类人想给自己搭私有网盘的个人用户、需要共享项目资料的开发团队以及想替代商业网盘的自托管使用者。体积不大但能力完整多数据源挂载、输入即出结果的索引搜索、图片/视频/Office 文档/3D 模型的缩略图预览、可设过期时间与权限组合的分享链接、WebDAV 协议、长期有效的 API 令牌以及 OIDC、LDAP、JWT、密码2FA、反向代理五种登录方式。速览如下能力说明部署形态单二进制文件或 Docker 镜像一份 config.yaml 完成配置登录方式密码2FA、OIDC、LDAP、JWT、反向代理认证搜索SQLite 索引输入即出结果支持按大小、类型过滤分享网页链接可设过期时间、限定用户、控制查看/下载/编辑/上传协议HTTP 浏览 WebDAV文档编辑内置文本编辑器可接 OnlyOffice 在线打开 Office 文件用 Docker 一条命令部署这一节解决怎么跑起来机器上装好 Docker 后执行下面命令即可不需要编译任何东西。docker run -d \ --name filebrowser \ -p 8080:80 \ -v /path/to/files:/srv \ -v fb-data:/home/filebrowser/data \ gtstef/filebrowser/path/to/files换成你要管理的目录fb-data卷存放数据库与配置文件升级容器时数据不丢失浏览器打开http://localhost:8080即可看到登录页。不想用 Docker 也可以后端为 Go 代码见 backend/构建入口在 makefile镜像构建脚本在 _docker/如需克隆源码构建仓库地址为 https://gitcode.com/GitHub_Trending/fileb/filebrowser 。最小可用配置这一节解决跑起来之后最少要改什么。容器首次启动后读取 data 目录中的config.yaml最少只需要端口、数据源和管理员账号三处server: port: 80 sources: - path: /srv auth: adminUsername: admin adminPassword: 你的密码 methods: password: enabled: true改完重启容器即生效。全部字段的默认值与注释可对照仓库自带的 backend/config.yaml多数据源、索引批大小、OnlyOffice 集成等高级项也都在同一文件里。日常使用你每天实际会做的事这一节不按系统模块而是按你打开网页后真正会做的动作来组织。浏览与实时搜索主界面是三个固定入口左侧目录树、中间搜索框、右侧视图切换列表/网格/紧凑。搜索走 SQLite 索引输入到第三个字符就开始返回结果还支持按文件大小、文件类型等条件过滤。之所以比全盘遍历快是因为后台扫描器持续维护索引实现见 backend/indexing/ 与 backend/database/sql/。文件预览图片、视频、音频、Office 文档甚至 3D 模型都生成缩略图鼠标停在缩略图上会弹出放大预览文本类文件有内置编辑器Word/Excel 可接 OnlyOffice 在线打开。下面这张图就是共享目录里一张普通照片的呈现效果——缩略图直接显示真实画面分享链接怎么生成、有效期怎么设在文件上选分享动作会得到一个网页链接。生成时可设置过期时间、允许哪些用户访问含匿名、以及查看/下载/编辑/上传四项权限的任意组合。对外发文件时建议开启过期时间并关闭编辑权限。权限管理管理员在用户设置里为每个账户单独开关七项权限api、admin、modify、share、delete、create、download还能按用户或用户组划定可访问的目录范围实现目录级访问控制。进阶能力挑三个最常用的展开这一节只挑对新手最有价值的三点其余能力一句话带过。OIDC 单点登录与双因素认证企业场景可在认证配置中启用 OIDC填 provider、clientID、clientSecret接入统一身份也可给密码登录叠加 TOTP 双因素认证实现分别在 backend/auth/jwt.go 与 backend/auth/totp.go。另有 LDAP 与反向代理认证适合已有统一登录体系的团队。REST API 与长期令牌开启用户 api 权限后可创建长期有效的 API 令牌配合应用内的/swagger文档页就能把文件浏览、搜索、上传写进自己的脚本。一次搜索调用的示例curl -H Authorization: Bearer 你的令牌 \ http://localhost:8080/api/search?query照片其余能力WebDAV 默认开启可直接挂载到 macOS 访达或 Windows 资源管理器OnlyOffice 集成提供在线文档编辑主题与品牌自定义可让界面接近自己的产品风格。接下来做什么这一节给你三个部署完成后立刻可以做的验证动作往/srv放一批照片和视频确认缩略图与弹窗预览正常给一个文件生成带 24 小时过期时间的分享链接用手机浏览器打开验证需要自动化时再创建 API 令牌并在/swagger页面查看完整接口文档。项目功能仍在快速迭代具体配置项与默认值请以最新 release 版本为准。【免费下载链接】filebrowser Web File Browser项目地址: https://gitcode.com/GitHub_Trending/fileb/filebrowser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考