File Browser：Docker 部署 Web 管理文件，浏览器打开就能用 本文基于 filebrowser/filebrowser:v2.63.17-s6 镜像实测版本2.63.17Ubuntu 24.04 服务器实测服务器上有文件要传、要删、要预览每次开 SFTP 或scp太麻烦File Browser是一款开源 Web 文件管理器——一条docker run就能跑浏览器里上传、下载、重命名、预览数据目录完全在你自己的磁盘上。本文带你完成一次File Browser 一条命令 Docker 部署从轩辕镜像拉取、docker run一键启动、从日志读取admin 随机密码到 Web 界面新建文件夹、上传文档、预览与下载——全程零基础可跟做文末附7 张实测截图。国内用户从 Docker Hub 拉取filebrowser/filebrowser可能较慢本文使用 轩辕镜像 加速域docker.xuanyuan.run。官方文档见 filebrowser.org源码仓库 filebrowser/filebrowser。一、File Browser 是什么File Browser是一款开源、自托管的 Web 文件管理器在指定目录内提供完整的文件操作界面。核心能力能力说明Web 管理浏览器内上传、下载、重命名、删除、预览文件多用户支持创建多个用户每人可绑定独立目录与权限轻量部署单 Go 二进制Docker 镜像约44MB配置与用户存 SQLite两种镜像官方提供Alpine 裸镜像与S6 Overlay 镜像本文用后者基于 linuxserver.io典型使用场景VPS / 家用 NAS远程传文件替代 SFTP / FTP 客户端小团队共享静态资源目录文档、备份包、安装包开发机内网文件交换数据不经过第三方网盘与网盘的区别File Browser 不提供协作编辑与版本历史胜在部署极简、目录即所见、完全自控。若需要同步与分享链接可配合反向代理与 HTTPS 对外发布详见 官方部署文档。二、环境要求项目建议操作系统Linux本文 Ubuntu 24.04Docker已安装 Docker 与 Docker Compose V2内存≥ 256 MB空闲约 3050 MBCPU单核即可磁盘≥ 500 MB镜像 数据库 待管理文件端口8080宿主机映射容器内监听80验证 Dockerdocker--versiondockercompose version若尚未安装 Docker可使用轩辕镜像一键脚本bash(wget-qO- https://xuanyuan.cloud/docker.sh)更多安装说明见 轩辕镜像使用手册。三、快速体验单容器部署适合个人 VPS、内网文件交换、快速试用。本文使用S6 Overlay 镜像标签含-s6需挂载三个目录并设置PUID/PGID以匹配宿主机文件权限。3.1 创建数据目录sudomkdir-p/www/wwwroot/filebrowser/{srv,database,config}sudochown-R$USER:$USER/www/wwwroot/filebrowsercd/www/wwwroot/filebrowser宿主机目录容器内路径用途srv//srv文件根目录Web 界面管理的所有文件database//database存放filebrowser.db用户与权限config//config存放settings.json站点配置若希望管理整个家目录可将-v中的srv路径改为/home:/srv生产环境请最小权限挂载勿把整个/暴露给 Web。3.2 拉取并启动容器拉取镜像若已拉取可跳过dockerpull docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6启动 File Browserdockerrun-d\--namefilebrowser\--restartunless-stopped\-p8080:80\-v/www/wwwroot/filebrowser/srv:/srv\-v/www/wwwroot/filebrowser/database:/database\-v/www/wwwroot/filebrowser/config:/config\-ePUID$(id-u)\-ePGID$(id-g)\docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6各参数说明配置说明-p 8080:80宿主机8080映射容器内80Web 访问端口-v ...:/srv持久化待管理的文件目录-v ...:/database持久化 SQLite 数据库-v ...:/config持久化站点配置PUID/PGID与宿主机用户 UID/GID 一致避免读写权限问题v2.63.17-s6固定版本 S6 初始化实测2.63.17--restart unless-stopped宿主机重启后自动拉起官方镜像轩辕镜像加速拉取filebrowser/filebrowser:v2.63.17-s6docker pull docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s63.3 验证启动查看日志dockerlogs filebrowser成功时终端类似输出Ubuntu 24.04 实测[custom-init] No custom services found, skipping... [migrations] started [migrations] no migrations found ... User UID: 0 User GID: 0 ... 2026/06/29 13:18:38 Using config file: /config/settings.json 2026/06/29 13:18:38 WARNING: filebrowser.db cant be found. Initialing in /database/ 2026/06/29 13:18:38 Using database: /database/filebrowser.db 2026/06/29 13:18:38 Performing quick setup 2026/06/29 13:18:38 User admin initialized with randomly generated password: nhGDwQZh2GRG1AzM 2026/06/29 13:18:39 Listening on [::]:80重点关注两行User admin initialized with randomly generated password:— 后面即为admin 初始密码每次全新部署随机生成请以你自己的日志为准Listening on [::]:80— 容器内 Web 服务已就绪另开终端快速探测curl-Ihttp://127.0.0.1:8080应返回 HTTP200或302。确认容器状态dockerps|grepfilebrowserlsconfig/ database/ srv/首次启动后config/settings.json与database/filebrowser.db会自动创建。3.4 首次登录浏览器打开http://你的服务器IP:8080进入 File Browser 登录页。用户名固定为admin密码使用3.3 节日志中的随机字符串。安全提示初始密码只出现在首次启动的docker logs输出中请立即登录并在Settings → Profile中修改密码。若对公网开放 8080务必尽快改密生产环境建议关闭公网直连改用第四节 Compose 反向代理 HTTPS。3.5 登录后主界面登录成功后进入文件管理主界面。左侧为导航My files、New folder、Settings 等顶部为搜索与工具栏若/srv为空中间会显示「It feels lonely here…」。左下角可看到磁盘用量如14.9 GiB of 108 GiB used与版本号File Browser 2.63.17。3.6 新建文件夹点击左侧New folder在弹窗中输入文件夹名实测创建testuploadfile点击CREATE。创建成功后根目录下会出现该文件夹与宿主机srv/testuploadfile/对应。宿主机验证lssrv/testuploadfile/3.7 上传文件进入testuploadfile文件夹点击顶部Upload图标选择File或Folder上传。实测上传验收测试报告模板.docx约 27.46 KiB上传完成后文件卡片出现在Files区域。宿主机同步可见lssrv/testuploadfile/# 验收测试报告模板.docx日常用法速记顶部工具栏支持下载、删除、重命名、移动、复制左侧Search可按文件名检索支持网格 / 列表视图切换手机浏览器访问同一地址即可跨设备管理文件3.8 预览与下载点击文件名可进入预览页。Office 文档如.docx在浏览器内无法内嵌预览会提示「Preview is not available for this file.」可点击DOWNLOAD下载或OPEN FILE在新标签打开。图片、PDF、文本等格式通常可直接在浏览器内预览。四、生产推荐Docker Compose适合长期运行、需要可复现配置、便于git管理部署文件的场景。4.1 目录结构cd/www/wwwroot/filebrowser将包含/www/wwwroot/filebrowser/ ├── docker-compose.yml ├── srv/ # 文件根目录 ├── database/ # filebrowser.db └── config/ # settings.json4.2 编写docker-compose.ymlservices:filebrowser:image:docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6container_name:filebrowserrestart:unless-stoppedports:-8080:80volumes:-./srv:/srv-./database:/database-./config:/configenvironment:PUID:1000# 改为宿主机实际 UIDid -uPGID:1000# 改为宿主机实际 GIDid -gTZ:Asia/Shanghai若以 root 运行如本文实测UID/GID: 0将PUID/PGID设为0并确保./srv等目录权限一致。4.3 启动与运维dockercompose up-ddockercomposepsdockercompose logs-ffilebrowser常用运维命令# 查看日志含 admin 初始密码仅首次dockercompose logs filebrowser# 停止保留 srv / database / configdockercompose down# 升级拉新镜像后重建dockercompose pulldockercompose up-d4.4 生产环境注意HTTPS将 File Browser 放在 Nginx、Caddy 或 Traefik反向代理之后对外只暴露 443。详见 官方部署文档。最小挂载仅挂载需要 Web 管理的目录避免暴露敏感系统路径。备份定期备份./database/filebrowser.db用户与权限及./config/settings.json./srv为实际文件数据务必一并备份。防火墙若必须直连端口可sudo ufw allow 8080/tcp云服务器需在安全组放行。更推荐仅反代对外、8080 仅内网访问。多用户登录Settings → User Management可新增用户并限制可见目录。4.5 镜像标签说明标签适用场景v2.63.17-s6S6 版固定版本本文实测含 linuxserver 初始化s6/v2-s6S6 版滚动标签跟随最新 v2v2.63.17Alpine 裸镜像固定版本无需 PUID/PGID卷用法略有不同latest偏开发向不建议生产使用Alpine 裸镜像快速启动示例供对比dockerrun-d\--namefilebrowser-alpine\--restartunless-stopped\-p8080:80\-vfilebrowser_data:/srv\-vfilebrowser_database:/database\-vfilebrowser_config:/config\docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17五、目录与卷速查容器路径说明/srvWeb 界面管理的文件根目录/database/filebrowser.dbSQLite 数据库用户、权限、分享链接等/config/settings.json站点配置端口、品牌、认证方式等S6 镜像环境变量变量说明PUID运行 File Browser 进程的 UID与宿主机文件所有者一致PGID运行 File Browser 进程的 GIDTZ时区可选如Asia/Shanghai六、常见问题 FAQQ18080端口被占用怎么办单容器启动时改映射例如宿主机用 8095dockerrun-d--namefilebrowser--restartunless-stopped\-p8095:80\-v/www/wwwroot/filebrowser/srv:/srv\-v/www/wwwroot/filebrowser/database:/database\-v/www/wwwroot/filebrowser/config:/config\-ePUID$(id-u)-ePGID$(id-g)\docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6浏览器访问http://服务器IP:8095。Compose 中把ports改为8095:80即可。Q2忘记 admin 密码怎么办初始密码仅在首次启动日志中出现。若已丢失且未改密可停止容器后删除数据库重新初始化会丢失用户与权限配置dockerstop filebrowserdockerrmfilebrowserrm/www/wwwroot/filebrowser/database/filebrowser.db# 再执行第三节 docker run重新查看 docker logs 获取新密码已改密的情况请参考 官方文档 或通过 SQLite 重置。建议首次登录后立即修改并妥善保存。Q3上传文件后宿主机看不到检查-v挂载路径是否正确、容器内/srv是否对应宿主机srv/。用docker inspect filebrowser查看 Mounts。同时确认PUID/PGID与目录所有者一致避免权限导致写入失败。Q4日志里usermod: user abc is currently used by process 1有影响吗S6 镜像初始化时的常见提示不影响 File Browser 正常启动。只要日志末尾出现Listening on [::]:80即可使用。Q5如何升级 File Browser# 单容器dockerpull docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6dockerstop filebrowserdockerrmfilebrowser# 再执行第三节 docker runsrv / database / config 卷不变# Composecd/www/wwwroot/filebrowserdockercompose pulldockercompose up-d升级前建议备份database/与config/。Q6与 Docker Hub 官方镜像的关系功能相同。docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6为轩辕镜像加速的 Docker Hub 同步版便于国内拉取。配置中将镜像名替换为轩辕域即可其余命令与 官方安装文档 一致。Q7可以管理多个目录吗默认单用户绑定/srv根目录。可通过Settings → User Management为不同用户设置不同Scope子目录范围或在settings.json中调整root路径需重启容器。Q8如何停止与卸载# 单容器保留 srv / database / configdockerstop filebrowserdockerrmfilebrowser# Composecd/www/wwwroot/filebrowserdockercompose down# 删除全部数据慎用文件与账户将全部丢失rm-rf/www/wwwroot/filebrowserQ9容器启动后浏览器无法访问依次检查docker ps确认容器为Updocker logs filebrowser看报错本机curl -I http://127.0.0.1:8080是否通云服务器安全组 / 防火墙是否放行 8080若仅绑定了内网 IP需用正确地址访问。七、命令速查操作命令拉取镜像docker pull docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6快速启动docker run -d --name filebrowser --restart unless-stopped -p 8080:80 -v /www/wwwroot/filebrowser/srv:/srv -v /www/wwwroot/filebrowser/database:/database -v /www/wwwroot/filebrowser/config:/config -e PUID$(id -u) -e PGID$(id -g) docker.xuanyuan.run/filebrowser/filebrowser:v2.63.17-s6Compose 启动cd /www/wwwroot/filebrowser docker compose up -d查看日志读 admin 密码docker logs filebrowser健康检查curl -I http://127.0.0.1:8080Web 访问http://服务器IP:8080停止服务docker stop filebrowser docker rm filebrowser八、延伸阅读主题链接项目首页https://filebrowser.org安装文档https://filebrowser.org/installation部署与安全https://filebrowser.org/deployment配置说明https://filebrowser.org/configurationGitHub 源码https://github.com/filebrowser/filebrowserDocker Hubhttps://hub.docker.com/r/filebrowser/filebrowser轩辕镜像页https://xuanyuan.cloud/zh/r/filebrowser/filebrowser轩辕镜像https://xuanyuan.cloud总结File Browser 私有化 Web 文件管理镜像约 44MB、一条命令就能跑。个人试用选第三节单容器docker logs读admin 随机密码→ 浏览器登录 → 建文件夹 → 上传文件长期运行选第四节 Compose配合数据备份与反向代理 HTTPS文件完全在自己服务器磁盘上。