feat: implement ufile sharing service

2026-09-09 20:53:39 -07:00
commit d3016b94db
19 changed files with 4022 additions and 0 deletions
@@ -0,0 +1,35 @@
+# ufile
+
+一个单二进制运行的轻量文件快传服务。支持多用户和三级权限、限时保存、限次访问、6 位取件码，以及无需登录的下载和预览链接。
+
+## 构建
+
+需要 Go 1.24+ 与 Node.js 20+：
+
+```bash
+./build.sh
+```
+
+也可以运行 `make build`。构建脚本会先安装并编译前端，再通过 `go:embed` 将产物写入最终的 `ufile` 二进制；SQLite 使用纯 Go 驱动，不依赖 CGO。
+
+## 运行
+
+```bash
+./ufile --data ./data --address 0.0.0.0:6616
+```
+
+参数：
+
+- `--data`：文件目录，默认 `./data`
+- `--db`：SQLite 文件路径；留空时为 `<data>/data.db`
+- `--address`：监听地址，默认 `0.0.0.0:6616`
+
+首次使用空数据库启动时，终端会输出 `admin` 的随机密码。该账号第一次登录后必须立即修改密码。
+
+## 分享链接
+
+- 下载：`/uf/<file_hash>`
+- 预览：`/uf/<file_hash>?preview=true`
+- 有取件码时追加：`code=<6位取件码>`
+
+预览也会消耗一次访问次数。文件过期、访问次数耗尽或所属用户被删除时，数据库记录和磁盘文件都会被清理。