tmp-upload
一个自托管的临时文件分享服务。上传文件后获得一个下载链接,24 小时后自动删除。
- Single binary,no runtime dependencies
- Built-in web UI (zero external assets)
- 10 GB default quota (configurable)
- Daily audit log (optional)
快速开始
go build -o server .
./server
# → 浏览器打开 http://localhost:8080
# 命令行上传
curl -F "file=@report.pdf" http://localhost:8080/upload
# → {"filename":"report.pdf","url":"/download/report-2026-08-27-abc123.pdf","expires_at":"..."}
配置(命令行 flag)
-dir ./data/uploads 上传文件保存目录
-listen :8080 HTTP 监听地址
-ttl 24h 文件过期 TTL
-scan 1h 清理扫描间隔
-quota 10737418240 总目录配额(字节,默认 10 GB;0 = 不限)
-audit-dir ./data/audit 审计日志目录(每天一个 YYYY-MM-DD.log 文件;空字符串禁用)
示例:把 TTL 改成 1 小时、配额 1 GB:
./server -ttl 1h -quota 1073741824
HTTP API
| Method | Path | 说明 |
|---|---|---|
| GET | / |
Web UI(单 HTML 响应,内联 CSS + JS) |
| POST | /upload |
上传文件(multipart/form-data,字段名 file) |
| GET | /files |
列出当前未过期文件 |
| GET | /download/:filename |
下载文件 |
| POST | /download-zip |
批量下载 (body: {"files":[...]}, 最多 100 项) |
| DELETE | /files/:filename |
删除文件 |
目录结构
tmp-upload/
├── main.go # 入口、配置、路由注册 (61 行)
├── embed.go # //go:embed + init() 拼接 (38 行)
├── audit.go # 审计日志子系统 (102 行)
├── quota.go # 配额管理 + formatSize (112 行)
├── handlers.go # HTTP handlers + DTOs (440 行)
├── cleaner.go # TTL 过期清理 (57 行)
├── audit_test.go # audit 单元测试
├── security_test.sh # HTTP 端到端测试
├── go.mod / go.sum
└── static/
├── index.html.tpl # HTML 骨架 (含 /*EMBED_CSS*/、/*EMBED_JS*/ 占位符)
├── app.css # CSS (357 行)
├── app.js # JS — 主程序 (441 行)
├── helpers.js # JS — 纯函数 + 倒计时 (58 行)
└── batch.js # JS — 批量选择 / 批量下载 (87 行)
单文件部署说明
embed.go 用 //go:embed 把三个静态文件全部编入二进制,
在 init() 中用 strings.Replace 把 CSS/JS 拼到 HTML 骨架里生成 pageHTML。
浏览器访问 / 拿到的是一个完整 HTML 响应(HTML+CSS+JS 全部内联),
不产生额外的 <link> / <script src=> 请求。
测试
go test ./... # 单元测试(audit 日志格式)
bash security_test.sh # 端到端安全 / 接口测试
go vet ./... # 静态检查
安全相关
DELETE /files/:filename不要求鉴权 — 部署时建议放在反代之后或加防火墙- 文件名采用时间戳 + 随机串避免冲突与枚举
- 没有请求体大小硬限制(超出
-quota时上传会失败)
License
Personal project. Use at your own risk.