File Browser
为指定服务器目录提供上传、删除、预览和编辑界面的 Web 文件管理器；项目已宣布停止后续发布与安全修复。
File Browser 的用途
File Browser 为指定目录提供浏览器界面，可上传、下载、删除、预览和编辑文件，类似在服务器上建立一个轻量自有文件入口。它使用本地单文件数据库保存配置和用户，首次启动会生成 admin 用户与随机密码。根目录决定用户能够接触的数据范围，因此应始终使用专用目录和低权限账号。
项目停止维护带来的风险
官方已宣布最后一个计划版本发布后不再提供新版本、错误修复或安全修复，并计划归档项目。官方特别指出命令执行功能存在长期安全问题，重新启用应视为授予主机 shell 权限；当前 JWT 会话不能主动撤销，泄露令牌在到期前可能继续有效。它不再适合直接面向公网或承载敏感文件。
仅保留旧实例时的最低措施
如果因迁移过渡必须暂时保留，应只监听本机地址，放在提供 TLS 和独立认证的反向代理之后，阻止任何绕过代理的后端访问；进程使用非特权账号或受限容器，只挂载目标目录，并保持命令执行关闭。与此同时应尽快迁移到仍有安全维护、支持会话撤销和审计的方案。
维护记录
本页于 2026-08-06 根据 File Browser 的停止维护公告、已知命令执行与 JWT 会话风险、首次启动、监听地址和部署文档复核。归档文件为 v2.63.23 Windows amd64。
保存到自己的网盘
打开网盘后可直接获取，也可以先保存到自己的网盘，方便换设备继续使用。
夸克网盘（无需提取码）
推荐将「File Browser」保存到该网盘
百度网盘
将「File Browser」保存到该网盘
File Browser 仅限本机或受控内网的安全运行说明
本项目已宣布不再提供后续安全修复。本教程只用于评估旧环境迁移或短期受控运行，不建议新建公网服务，也不建议处理敏感数据。
安装前准备
- 明确迁移或替代计划；新部署优先选择仍在维护、支持可撤销会话和安全更新的方案。
- 创建专用低权限 Windows 账号，只授予目标文件目录所需权限，不使用管理员账号运行。
- 准备独立测试目录，确认命令执行保持默认禁用，并让服务只监听本机地址。
安装步骤
- 01
解压到受限目录
完整解压单文件程序和配置，把将要共享的测试目录与系统目录、密钥、备份和应用配置隔离。
- 02
只绑定本机地址启动
使用 root 参数指定测试目录，保留默认本机监听地址和命令执行禁用状态；不要直接开放防火墙或映射公网端口。
- 03
保存一次性初始密码
首次启动查看控制台输出，安全记录随机 admin 密码并立即登录更换；数据库不存在时重启可能重新初始化，先确认数据路径。
快速上手
- 01
校验可见目录范围
使用测试账号检查根目录、上传、下载、编辑和删除权限，确认无法通过链接或符号链接越出授权范围。
- 02
增加外层安全控制
如需受控远程访问，使用终止 TLS 且提供独立认证的反向代理，并确保后端端口无法绕过代理直接访问。
- 03
规划下线迁移
记录用户、权限、根目录和共享方式，将文件迁移到受维护方案；完成后撤销端口、账号、令牌和旧数据库。
使用建议
- 命令执行功能保持默认禁用；官方明确指出重新启用等同于向用户提供主机 shell 能力。
- 当前 JWT 会话无法像服务端会话那样主动撤销，密码更改或退出后旧令牌仍可能在到期前有效。
- 不开启匿名访问或默认自注册；如果历史配置启用了注册，必须限制默认用户范围和权限。
故障排查与卸载方法
修改密码后怀疑旧会话仍可访问怎么办？
不要只依赖退出或改密。立即从反向代理或防火墙阻断服务、轮换外层认证并检查日志，再迁移到支持会话撤销的方案。
容器或低权限账号无法读写目录怎么办？
只调整目标目录的所有权和最小必要权限，不要为方便而使用管理员身份或挂载整个系统盘。
- 停止服务并撤销外部入口先关闭反向代理路由、防火墙端口和计划任务，再停止进程；确认文件已迁移后删除程序、数据库、配置和不再需要的账号凭据。
常见问题
File Browser 还适合直接暴露到公网吗？
不适合。项目已宣布停止后续发布、错误和安全修复，并明确建议不要直接暴露公网；如必须临时保留，应置于额外认证的 TLS 反向代理之后并限制来源。
首次登录密码在哪里？
初次启动会创建数据库和 admin 用户，随机密码只在控制台日志显示一次。应立即安全保存并更换，不要依赖重新显示。
为什么必须限制根目录？
用户可执行的上传、修改和删除操作都受所配置根目录影响。若把系统盘或过大的目录作为根，会放大账号泄露和误操作的影响范围。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。