FileBrowser 教程:一条命令部署自托管 Web 文件管理器,10 分钟上手
2026/9/20 22:28:02 网站建设 项目流程

FileBrowser 教程:一条命令部署自托管 Web 文件管理器,10 分钟上手

【免费下载链接】filebrowser📂 Web File Browser项目地址: https://gitcode.com/GitHub_Trending/fileb/filebrowser

想把 NAS 上的文件分享给别人,又不想用第三方网盘?

你大概率遇到过这种场景:NAS 或者一台租来的服务器上存了几十 GB 的照片、文档、视频,家人想看几张照片,同事要一份材料,你却只能一件件上传到第三方网盘——限速、限容量,账号安全还说不准。其实更直接的做法是:在自己的服务器上开一个网页入口,登录进去就能浏览、下载、分享文件。

FileBrowser干的就是这件事。它是一个免费开源的自托管 Web 文件管理器,把服务器上的目录挂载上去,用浏览器打开就能管理:目录浏览、上传下载、在线预览、分享链接、多用户权限,数据全程留在你自己的机器上,不用注册任何外部账号。

一条命令完成 FileBrowser Docker 部署

部署门槛很低,从开机到能用,10 分钟足够。只要你的 Linux 服务器或 NAS 上装好了 Docker,一条命令就能跑起来:

docker run -d \ -p 8080:80 \ -v /你的/文件目录:/srv \ --name filebrowser \ gtstef/filebrowser:latest

参数很好懂:-v把要管理的目录映射进容器,-p 8080:80把端口映射到 8080。不想用 Docker 也行,下载单个二进制文件配合一个config.yaml启动,体验基本一致,完整的容器编排参考项目里的 docker-compose.yaml。

容器起来后,浏览器访问http://你的服务器IP:8080,创建管理员账号即可。登录后看到的就是你刚挂载的目录,点开一张照片可以直接在浏览器里看,不必先下载:

最常用四个 FileBrowser 功能走读

1. 多格式在线预览它能做什么:图片直接预览,视频、音频、Office 文档有缩略图和预览页,代码和文本文件内置编辑器可看可改。对你有什么用:不用下载就能确认照片拍没拍糊、文档内容对不对,"先看看再下载"的工作流顺畅很多,整理大量文件时尤其省时间。

2. 带有效期的分享链接它能做什么:给文件或文件夹生成链接,可设过期时间、是否允许匿名访问、对方能否下载甚至上传。对你有什么用:发给家人的链接三天后自动失效,不会一直躺在公网被人翻到,比直接交出网盘账号放心得多。

3. 多用户与目录级权限它能做什么:为每个人建独立账号,控制能看到哪些目录、能不能改和删,还可以绑定目录级访问规则,认证方式也支持密码加二要素。对你有什么用:家人只浏览照片目录,同事只访问共享文档,谁也不能翻动整个盘,把服务暴露到公网也不慌。

4. 索引驱动的搜索它能做什么:后台维护一份 SQLite 文件索引,搜索框里边输边出结果,还支持按大小等条件过滤。对你有什么用:几万个文件里找"上个月的合同"、"旅行照片"都是秒回,不用像传统目录遍历那样把整块盘扫一遍。

所有配置项集中在一个文件里,完整字段说明可以直接翻 backend/config.yaml。

几条真实使用建议,帮新手少踩坑

  • 公网访问先开认证。装完第一件事不是挂文件,而是把管理员密码设长一点,顺手开启双因素认证,入口暴露出去才踏实。
  • 对外访问走反向代理加 HTTPS。前面挂一层 Nginx 或 Caddy,配域名和证书,比直接给 IP 加端口靠谱。
  • 分享链接一定设有效期。别把"永久有效 + 匿名 + 可上传"的链接随便发出去。
  • 大目录先配排除规则。缓存、构建产物这类目录不索引,首轮扫描快很多,索引也省空间。
  • 配置文件要备份。升级迁移全靠config.yaml,留一份在自己手里,排查问题不抓瞎。

它适合谁,又该注意什么

维度说明
适合人群有 NAS 或家用服务器、想自建"替代网盘"的人,以及小团队的文档协作
上手成本Docker 一条命令即可用,进阶功能都在一份配置文件里
局限不支持 S3 等对象存储,没有官方移动端应用,超大媒体库的索引和预览体验取决于你自身的硬件

一句话收尾:如果你只是想快速拥有一个属于自己的文件管理 Web 端,值得花 10 分钟部署试试——数据在自己手里,试错成本只是一条 Docker 命令。

【免费下载链接】filebrowser📂 Web File Browser项目地址: https://gitcode.com/GitHub_Trending/fileb/filebrowser

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询