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

十一、最佳实践

1. 首次启动后立即修改密码
2. 为不同用户设置不同权限
3. 使用强密码
4. 定期备份数据库（filebrowser.db）
5. 配置日志记录
6. 设置适当的访问范围（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

重要提醒：首次登录后必须修改默认密码！