File Browser 是一个单文件的文件管理服务:一个 exe 起一个网页,浏览器里浏览目录、下载和上传,也能在线改文本。它由 Go 写成,不带运行时依赖,适合挂在一个目录上做共享。这篇在 Windows 上把一个 37 MB 的单文件跑起来,从解压到登录,再到浏览文件,把耗时和接口延迟都记了下来。
16 MB 的压缩包,解开是 37 MB 的 exe
发布包 windows-amd64-filebrowser.zip,16,005,055 字节
解压后 filebrowser.exe,37,308,928 字节
版本 2.63.23(页面左下角标注)
启动耗时 0.89 秒
数据库 fb.db,65,536 字节(首次启动自动建)
解压即用,不用安装。启动参数里三个必填:-r 指根目录,-p 指端口,-d 指数据库文件。数据库只存用户和设置,文件本身不搬动,所以接一个已有的目录不会改变里面的东西。
首次启动的密码是随机生成的
日志行 User 'admin' initialized with randomly generated password: ************
长度 16 个字符,含大小写字母、数字与连字符
位置 只打印在控制台,不在网页上显示
第一次跑完,控制台会打出这串随机密码,用户名固定是 admin。如果没抄下这串密码,登录会失败,只能删掉 fb.db 重新初始化。登录页只有两个输入框,成功后跳到 /files/。
列表页一屏看完目录和磁盘
| 界面元素 | 实测表现 |
|---|---|
| 左侧导航 | My files / New folder / New file / Settings / Logout |
| 目录区 | docs、logs 两个文件夹,显示相对时间 |
| 文件区 | 三种文件各带图标与字节数,log 200 B / csv 292 B / md 87 B |
| 左下角 | 262 GiB of 932 GiB used,直接读所在磁盘 |
列表按类型分区,2 个文件夹和 3 个文件分开显示,各自带大小与修改时间。磁盘用量是整块盘的,不是根目录的,所以接一个小目录也会显示整盘占用。右上角有新建 / 上传 / 切换视图 / 设置 四个图标按钮,都不带文字。
列一次目录 5.3 毫秒
GET /api/resources/
五次耗时 12.8 / 5.3 / 4.8 / 5.3 / 4.6 毫秒
中位数 5.3 毫秒
返回字段 items / numDirs / numFiles / sorting / path / name / size / extension
第一次 12.8 毫秒是冷启动后的首请求,之后稳定在五毫秒上下。接口返回里 numDirs 与 numFiles 分开给,前端据此分两块渲染。这个接口在登录态下直接可用,写脚本批量列目录不必解析网页。
双击打开,编辑器带行号和语法高亮
单击只是选中,双击才进编辑视图。文本文件按扩展名识别语言,Markdown 会显示标题高亮,左侧带行号,实测这份 4 行的文件行号从 1 排到 4,右上角显示字号 14px。日志和 CSV 也能直接看,不必下载。保存是覆盖原文件,没有版本历史。
打开路径 /files/项目说明.md(URL 里是 UTF-8 百分号编码)
编辑器顶部 文件名 / 字号 / 保存与关闭图标
左侧 行号 1 到 4
内容 实测库文件服务 / 这是 filebrowser 的根目录,用来放共享文件。
中文文件名在地址栏会编码成 %E9%A1%B9%E7%9B%AE... 这种形式,复制链接时要注意。编辑保存走的是 PUT 请求,大文件不建议用它改,编辑器会把整个文件读进内存。
适合什么场景
单人临时共享一个目录,或者把备份盘挂到局域网里点点看,用它最省事:没有数据库服务,没有配置文件,删掉那个 37 MB 的 exe 就干净了。要多人分权限、要审计日志,还要对象存储那种分片上传,就需要再往上找更重的方案。
实测范围:Windows 10 22H2(10.0.19045.6466) / File Browser 2.63.23 / 2026-10-22。上传下载速度 / 断点续传 / 多用户权限、HTTPS 与反向代理都没有验证,不作结论。










