banner
约 1,200 字
4 分钟

File Browser 教程:浏览器管理服务器文件

摘要

File Browser 是单二进制的 Web 文件管理器,浏览器里完成上传下载、在线编辑、预览与分享。本教程依据官方文档,介绍脚本与 Docker 安装、多用户权限管理、限时分享链接、systemd 常驻,以及改密码、反代 HTTPS、不暴露根目录等安全建议。

File Browser 使用教程:浏览器里管理服务器文件

服务器上没有桌面,传文件要 scp、改文件要 vim?File Browser 是一个单二进制的 Web 文件管理器:浏览器打开就是一个带上传下载、在线编辑、预览的"网盘界面",一行命令跑起来。本教程依据 File Browser 官方文档(filebrowser.org)整理。

一、快速安装

Linux 一条命令安装(官方脚本):

bash
curl -fsSL https://raw.githubusercontent.com/filebrowser/filebrowser/master/install.sh | bash
filebrowser -r /path/to/your/files    # 指定根目录并启动

默认地址 http://服务器IP:8080,初始账号密码都是 admin登录后立刻改密码

Docker 方式(推荐长期跑):

bash
docker run -d --name filebrowser \
  -p 8080:80 \
  -v /opt/data:/srv \
  -v /opt/filebrowser/filebrowser.db:/database.db \
  filebrowser/filebrowser

二、能干什么

  • 上传下载:拖拽上传,支持文件夹和断点续传

  • 在线编辑:文本/代码文件直接在浏览器里改,自带语法高亮

  • 在线预览:图片、视频、音频、PDF、Markdown 都能直接点开看

  • 文件操作:新建、重命名、复制移动、批量删除、压缩下载(自动打包 zip)

  • 搜索与排序:大目录里找文件比命令行舒服

对经常给服务器"传图改配置"的人来说,这基本替代了 80% 的 scp + vim 场景。

三、用户与权限

File Browser 支持多用户,每个用户可以:

  • 限定在某个目录范围(scope)

  • 按需勾选权限:只读、可下载、可修改、可分享

  • 管理员在「设置 → 用户管理」里创建,比如给朋友开一个只读账号专门下载资料

四、分享链接

选中文件 → Share,可以生成带有效期和密码的下载链接——相当于自建的对象存储分享,临时给朋友传个大文件特别方便。

五、安全建议

Web 面板暴露公网前做好这几件事:

  1. 改默认密码,密码尽量长

  2. 前面套 Nginx 反代 + HTTPS(本站 Nginx 教程),不要明文 HTTP 跑在公网

  3. 或者干脆不暴露公网,通过 Tailscale(本站有教程)在内网访问

  4. -r 指定的根目录只给它该看的目录,不要 -r /

六、配置成 systemd 服务

/etc/systemd/system/filebrowser.service(参考本站 systemd 教程):

ini
[Unit]
Description=File Browser
After=network.target

[Service]
ExecStart=/usr/local/bin/filebrowser -r /opt/data --port 8080 --noauth=false
Restart=on-failure
User=www-data

[Install]
WantedBy=multi-user.target

systemctl enable --now filebrowser 即可常驻。

七、总结

需求

做法

安装

官方脚本或 Docker,端口 8080

传文件

浏览器拖拽上传下载

改配置

在线编辑器直接改

给别人下载

Share 生成限时链接

常驻

systemd 服务

安全

改密码 + 反代 HTTPS + 不暴露根目录

File Browser 解决的是"服务器没有脸"的问题:给它一张浏览器就能用的脸,管理效率立竿见影。

END