中文 | English
Web 文件管理器 · Vue 3 + TypeScript
screenshot
项目提供 两种服务端实现,共享同一套前端,可按部署场景选择其一:
Node.js 后端 (backend/) |
Go 后端 (backend-go/) |
|
|---|---|---|
| 技术 | Express.js + TypeScript,使用 Bun 开发与打包 | Echo,单文件可执行程序 |
| 典型用途 | npm i -g file-lite 全局安装、快速迭代与插件式扩展 |
资源占用低、容器 / 边缘设备单二进制分发 |
| 文档 | 见下文「开发」与配置说明 | backend-go/README.md |
前端构建:Go 镜像需先执行
frontend:build-go,将静态资源输出到backend-go/frontend/(详见 Go 后端 README)。
- 打包体积:单包不超过约 20MB
- 功能
- 文件与目录:创建、删除、重命名、移动、复制
- 传输:批量上传、上传文件夹、下载、将文件夹打包为 ZIP 下载
- 文本编辑器
- 预览:图片、视频、音频;音乐播放器(播放列表、封面、歌词展示)
- 视频:ArtPlayer.js 与原生
<video>在菜单中一键切换(偏好持久化) - Endless Gallery:类短视频流的纵向滑动浏览,聚合当前目录下支持的图片 / 视频 / 音频,触屏与键鼠操作
- 资源管理器:路径级布局与排序状态持久化、按扩展名设置默认打开方式等
- 安全
- 密码登录后签发 JWT 会话令牌
- 控制台链接使用短时
ticket登录参数,有效期 2 分钟;重新打印链接会生成新的ticket - 支持"记住登录状态":持久 Cookie 或浏览器会话 Cookie
- 密码错误超次数可封禁 IP
- 可限制允许访问的根路径范围
- 支持 HTTPS(含自签名证书)
- 访问频率限制
# 全局安装(Windows 需要管理员权限) npm i -g file-lite # 运行 file-lite # 卸载 npm uninstall -g file-lite
使用 Bun 安装依赖与执行脚本;默认产物面向 Node.js 运行时(由 backend 打包并嵌入前端)。
# Node.js 后端 cd backend bun i bun run dev bun run build
# 前端 cd frontend bun i bun run frontend:dev bun run frontend:build
# 一键构建(后端嵌入前端) cd backend bun run build:auto cd dist node file-lite.min.mjs
- Go 后端:编译与
frontend:build-go说明见 backend-go/README.md
- 配置文件路径:
${cwd}/data/config.json - 配置类型说明:IConfig
- 环境变量示例:.env.development
- 使用 mkcert 生成并信任自签名证书
password为空时会自动生成随机密码;如果配置文件已存在,会写回到配置文件中jwtToken是 JWT 签名密钥;如果配置文件已存在但为空,会自动生成并写回- 控制台不会打印 JWT 或签名密钥;请通过配置文件查看登录密码