web-fss

English | 简体中文

web-fss 是简单静态文件服务场景下的实用替代方案。

功能

• 目录浏览 Web UI
• 断点下载（HTTP Range / 206）
• 上传按钮 + 分片上传
• 上传前同名冲突检测
• 同名冲突支持：覆盖 / 重命名 / 取消
• 支持覆盖上传 / 断点续传
• 用 .upload 元数据记录上传进度
• 上传完成自动删除 .upload
• UI 支持删除文件和文件夹
• UI 支持打开模式切换：Preview（按浏览器 MIME 预览）/ Download
• 支持 --serve-index-html：目录请求时自动返回 index.html/index.htm

Node.js 兼容版本：>=18.17。

安装

本地开发安装依赖：

npm install

全局安装（发布后）：

npm install -g web-fss

启动

默认（当前目录，端口 8000）：

web-fss

或者：

node ./bin/web-fss.js

提示（快速启动）：

npx web-fss

指定端口和目录：

web-fss 9000 -d /data/files

只监听本地：

web-fss -b 127.0.0.1

关闭上传：

web-fss --no-upload

显示隐藏文件（dotfile）：

web-fss --show-hidden

设置上传分片大小（默认 4MB）：

web-fss --chunk-size 1048576

目录请求自动返回 index.html/index.htm：

web-fss --serve-index-html

续传逻辑

上传 a.zip 时会创建：

• a.zip（目标文件）
• a.zip.upload（JSON 元数据）

元数据字段：

• file_size
• uploaded_ranges（[start, end)）
• bytes_received
• completed

再次上传同名文件时：

1. 检查现有文件与 .upload
2. 状态有效则续传
3. 否则覆盖
4. 上传完成删除 .upload

API 接口

• GET /.api/list?directory=/path/
• POST /.upload/check
• POST /.upload/init
• POST /.upload/chunk
• POST /.upload/delete
• DELETE /.upload/delete

许可证

MIT