FileBrowser for Windows 后，如何变成一个？

一、基本介绍 FileBrowser 是一个基于 Web 的文件管理器，支持文件上传、下载、编辑、分享等功能。 二、快速开始 1. 下载 文件：windows-amd64-filebrowser 重命名：filebrowser.exe 2. 首次启动 # 方法1：直接运行（默认配置） filebrowser.exe # 默认地址：http://localhost:8080 # 默认账号：admin/admin # 方法2：带参数运行 filebrowser.exe --port 8080 --database filebrowser.db --scope D:\Files 三、配置文件管理 1. 配置文件不会自动读取 必须用 -c 参数指定： filebrowser.exe -c config.json 2. 创建配置文件 # 生成默认配置 filebrowser.exe config init config.json # 编辑配置 filebrowser.exe config edit config.json 3. 配置文件示例 { "port": 8080, "address": "0.0.0.0", "database": "filebrowser.db", "scope": "D:\\Files", "root": "D:\\Files", "allowCommands": true, "allowEdit": true, "allowNew": true } 四、用户管理 重要：不能直接在 config.json 中设置密码 首次运行自动创建默认账号：admin/admin 1. 创建用户 # 创建管理员 filebrowser.exe users add 用户名 密码 --perm.admin # 创建普通用户 filebrowser.exe users add user1 pass123 --perm.execute --perm.download 2. 权限选项 --perm.admin # 管理员权限 --perm.execute # 执行权限 --perm.create # 创建权限 --perm.modify # 修改权限 --perm.delete # 删除权限 --perm.share # 分享权限 --perm.download # 下载权限 3. 修改密码 filebrowser.exe users update admin --password 新密码 五、自动化脚本 1. 启动脚本 (start.bat) @echo off chcp 65001 echo 正在启动 FileBrowser... timeout /t 2 if exist config.json ( filebrowser.exe -c config.json ) else ( echo 未找到配置文件，使用默认配置... filebrowser.exe --port 8080 --database filebrowser.db --scope . ) pause 2. 安装脚本 (install.bat) @echo off chcp 65001 echo ======================================== echo FileBrowser 初始化设置 echo ======================================== set /p USERNAME=请输入管理员用户名（默认admin）: if "%USERNAME%"=="" set USERNAME=admin set /p PASSWORD=请输入管理员密码: REM 生成配置文件 filebrowser.exe config init config.json REM 删除旧数据库 if exist filebrowser.db del filebrowser.db REM 创建管理员 filebrowser.exe users add %USERNAME% %PASSWORD% --perm.admin echo. echo 安装完成！ echo 访问地址: http://localhost:8080 echo 用户名: %USERNAME% echo 请妥善保存密码！ pause 六、作为服务运行 1. 使用 NSSM nssm install FileBrowser # 路径: C:\path\to\filebrowser.exe # 参数: -c C:\path\to\config.json 2. 使用 WinSW 创建 filebrowser.xml： <service> <id>filebrowser</id> <name>FileBrowser</name> <executable>C:\filebrowser\filebrowser.exe</executable> <argument>-c</argument> <argument>config.json</argument> </service> 七、安全设置 1. 只允许本地访问 filebrowser.exe --address 127.0.0.1 --port 8080 2. 修改默认端口 filebrowser.exe --port 8081 3. 配置 SSL/HTTPS 在 config.json 中添加： { "tls": { "cert": "cert.pem", "key": "key.pem" } } 八、常用命令 基本命令 # 查看版本 filebrowser.exe version # 查看帮助 filebrowser.exe help # 查看用户列表 filebrowser.exe users ls 服务管理 # 启动 filebrowser.exe -c config.json # 后台运行（Windows） start /B filebrowser.exe -c config.json 九、目录结构建议 filebrowser/ ├── filebrowser.exe # 主程序 ├── config.json # 配置文件 ├── filebrowser.db # 用户数据库 ├── start.bat # 启动脚本 ├── install.bat # 安装脚本 ├── logs/ # 日志目录 └── certs/ # SSL证书（可选） 十、故障排除 1. 端口被占用 # 更换端口 filebrowser.exe --port 8081 2. 权限不足 以管理员身份运行 CMD 检查防火墙设置 3. 忘记密码 # 方法1：重置密码 filebrowser.exe users update admin --password 新密码 # 方法2：删除数据库重新开始 del filebrowser.db 4. 无法访问 检查服务是否运行：netstat -ano | findstr :8080 检查防火墙设置 确认绑定地址：0.0.0.0 或 127.0.0.1 十一、最佳实践 首次启动后立即修改密码 为不同用户设置不同权限 使用强密码 定期备份数据库（filebrowser.db） 配置日志记录 设置适当的访问范围（scope） 十二、备份与恢复 备份数据库 copy filebrowser.db filebrowser_backup_%date%.db 恢复数据库 copy filebrowser_backup.db filebrowser.db 快速参考命令卡 启动：filebrowser.exe -c config.json 新建用户：filebrowser.exe users add 用户名 密码 --perm.admin 修改密码：filebrowser.exe users update 用户名 --password 新密码 生成配置：filebrowser.exe config init config.json 端口测试：netstat -ano | findstr :8080 重要提醒：首次登录后必须修改默认密码！