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),仅供参考