想给同事或者客户共享几 G 的文件,微信传不动,网盘要会员才不限速,搭 FTP 又太折腾——这事我遇到过不下十次。
直到用上 FileBrowser 才算解决:一个 16MB 的 exe,双击运行,浏览器打开就是一套完整的网盘界面。文件管理、多用户、分享链接、在线预览、手机适配全都有,还是 3.6 万 Star 的老牌开源项目。
我在 Windows 本地完整跑了一遍:建了测试目录、传了各种文件、生成了分享链接、把界面改成了自己的品牌,截了 17 张图。结论放前面:小工具解决大问题,用法极简;但有个重要的坑必须先说——这项目 2026 年 9 月已经归档停止维护了,具体影响往下看。
FileBrowser 能干什么
一句话:把任意一台机器的某个目录,变成一个能在浏览器里操作的网盘。
按用途对号入座——
- 给同事、客户传大文件:不用微信压缩包,也不用充网盘会员,发个链接对方自己下
- 家里 NAS 的网页入口:装 NAS 上,手机在外面也能翻家里的文件
- 服务器的文件管理面板:不想开 FTP,浏览器里传、下、改名、删
- 给项目组开共享目录:每人一个账号,各自的目录互不干扰
- 临时交付:设个 7 天有效的分享链接发过去,到期自动失效
它不是同步盘,也不是团队协作工具。就是个浏览器版的资源管理器——这个定位想清楚了,用起来会很顺。
核心功能亮点
- 文件管理全套:上传、下载、新建、重命名、移动、删除、批量操作
- 多用户 + 权限:每个账号能看到的目录单独配,管理员和普通用户分开
- 分享链接:能设过期时间,生成出来直接发人
- 在线预览:图片、Markdown、文本、视频在浏览器里直接看,不下载
- 搜索:按文件名搜,目录深也找得到
- 网格 / 列表两种视图:看图多用网格,看文件名多用列表
- 暗色模式 + 手机适配:手机上操作和电脑上基本一致
- 单 exe,16MB:不用装环境、不用数据库服务,双击就跑
这工具什么来头
- 版本:v2.63.23,GitHub 3.6 万 Star
- 协议:Apache-2.0,可商用可修改
- 技术栈:Go 编写,编译成单个 exe,自带 BoltDB 单文件数据库,零依赖
- 官方提供各平台二进制,Windows 直接下载就能跑
- 定位很纯粹:给一个文件夹套上网页管理界面,就这么简单
它跟 Cloudreve、NextCloud 那种"完整网盘系统"不一样。FileBrowser 更轻,更像瑞士军刀——单文件、免配置、到处能跑。
我的测试环境
| 项目 | 配置 |
|---|---|
| 系统 | Windows 11 本地 |
| 版本 | 官方 windows-amd64 二进制(v2.63.23) |
| 端口 | 8082 |
| 共享目录 | 程序旁的 files 文件夹 |
部署:解压,双击,浏览
1. 解压到任意目录。
2. 双击 启动文件管理.bat。
3. 浏览器打开 http://localhost:8082,登录页已经是我调好的样子:

默认账号 admin、密码 admin1234567890(包内预设),进去第一件事先改密码。
4. 把你想要共享的文件丢进 files 文件夹,刷新页面就看到了:

文件夹和文件分两类展示,右侧有大小和修改时间。整个界面是中文的,青色是主题色。
一个只有折腾过才知道的坑:FileBrowser 官方提供了「品牌定制」功能(
--branding.name、--branding.files),我在整合包里用它把界面名改成了「源码湾文件管理」、logo 和图标也替换了。但实测发现branding.color这个主题色参数在 v2.63 的前端里其实已经不生效了(老接口遗留)。想改主题色得换思路——我在branding/custom.css里直接覆盖了它的 CSS 变量(--blue、--icon-blue),把默认的蓝色换成了品牌青绿。这个 custom.css 是官方支持的机制,改配色、隐藏元素都靠它。顺带提醒:数据库(filebrowser.db)是 BoltDB 单文件,服务运行中会用文件锁锁死,想在命令行改配置(比如加用户、改品牌)得先关掉服务,否则会报 timeout。
进去走一圈
列表和网格两种视图,右上角一键切换。图片多的文件夹用网格模式舒服很多:

在线预览是重头戏。Markdown 文档直接渲染:

图片点开就是浏览器看图,左右切换:

代码、视频、甚至 CSV 表格也都能直接打开,不用下载。
搜索是递归全盘搜,输入关键字回车,结果带路径显示:

分享功能,是我觉得最实用的。右键任意文件 → 分享 → 设置有效期和密码:

生成后是个独立链接,还能一键复制下载直链:

收链接的人不需要登录,打开就长这样——自带二维码,手机扫码直接下载,发给客户特别体面:

多用户和权限。设置 → 用户管理里能建子账号,每个账号单独划定目录范围:

全局设置里可以控制注册开关、密码长度、访问规则,还有品牌定制区(就是我前面用的那套):

暗色模式:

手机端打开自动适配,卡片式布局,触屏操作没问题:

实话实说
先说好话:
- 部署简单到离谱。单文件、零依赖、自带数据库,扔到任何 Windows/Linux 机器上双击就跑,比装个微信还快。
- 分享体验好。链接+二维码+有效期+密码,给客户发大文件的场景完美覆盖,比网盘分享体面多了。
- 资源占用小。整个程序 16MB,跑起来内存占用也就几十 MB,老电脑、小服务器都能架。
缺点也说得明明白白:
- 项目已归档,不再维护了。这是最重要的一条——官方在 2026-09-01 归档,最后一个版本就是 v2.63.23,之后没有新功能,也没有安全修复。它的应用场景建议缩小到:自用、局域网、临时共享。不要把默认配置直接暴露到公网上,如果一定要公网用,在反向代理层加认证,并且改掉默认密码、关掉注册。
- 界面默认是英文的。中文翻译要在设置里手动切(整合包里我已经预置成中文了),但部分提示文案的翻译质量一般。
- 不适合文件海战术。单目录塞几万个文件时,列表加载会明显变慢,它是为「日常工作目录」设计的,不是为「PB 级仓库」设计的。
- 没有多端同步。它是个文件管理器,不是同步盘。想要"电脑改了手机自动更新"那套,得看 Syncthing 之类的工具(后面我会实测,关注我)。
常见问题
源码获取
上面教程用到的完整整合包(含官方二进制、品牌定制文件、预配置数据库、完整源码),我放夸克网盘了,免费取:
上面记的这些坑,你自己走一遍也都会遇到。环境、依赖、配置、目录结构,一个都省不了。包里是我这边全部跑通之后才打的——要跳过这几步,直接拿下面这个。
两个小提醒:
- 建议先「转存到自己网盘」再下载——直接下载的链接容易失效,转存后就是你的了,随时能下;
- 手机上操作:点开链接 → 右下角「保存到网盘」→ 回夸克 App 的「我的网盘」里下载。
安装卡住了?对照上面的常见问题部分,基本都能解决。
装之前先确认两件事:一个要共享出去的目录(路径别有中文)、一个没被占用的端口(默认 8080)。数据库内置,不用准备。