SKYMirror
7f060dd0e4
Go 1.27.1 (Gin+GORM) + Vue 3 文件快传服务： - 安全审计全部修复（docs/security-audit-2026-09-05.md）： bcrypt 密码哈希与自动升级、presign 直传服务端大小/内容校验、 全局请求体上限、依赖升级（govulncheck 0 命中）、janitor 后台清理、 管理端审计动作落库、/admin CORS 收紧、通知内容白名单净化、 会话默认 7 天、限流缓存故障降级、robots.txt 端点等 - 前端：取件链接复制修复（不再重复拼接提取码）、markdown 净化器加固 - Redis 支持库号（FCB_REDIS_DB / redis://…/db URL） - 文档：docs/api/* 与 openapi.yaml 同步最新行为（robots.txt、 提码 5 位起、chunk 32MiB 上限、admin 审计动作等） 验证：gofmt/go vet/go test 全绿；二进制端到端冒烟通过
3.2 KiB
3.2 KiB
文本分享
创建纯文本分享，返回取件码。文本大小上限 222KB（超限建议改用文件分享）；请求体全局上限 1MiB，Content-Length >441KB 时读前直接 403。
经审计中间件落库（action=upload）。
POST /share/text
请求参数（application/x-www-form-urlencoded，亦支持 multipart；text 为必需）：
| 参数 | 类型 | 必需 | 默认 | 说明 |
|---|---|---|---|---|
code |
string，可选；自定义提取码，5-8 位字母或数字（空=随机生成；占用 400「该提取码已被占用」） | |||
text |
string | ✅ | - | 文本内容（≤222KB，按 UTF-8 字节数） |
expire_value |
int | ❌ | 1 |
过期值（配合 expire_style） |
expire_style |
string | ❌ | day |
day/hour/minute/count/forever（须在站点允许列表内） |
过期语义：
day/hour/minute：按时间过期，expired_count = -1。count：按次数过期，取件expire_value次后失效（expired_count = expire_value）； v2 需求 ④：max_save_count>0时expire_value不得超出该上限，超限 403。forever：永久（需站点允许；max_save_seconds>0时其他方式受最长保存上限约束，超限 403）。
可选值与上限来自公开配置
GET /api/v1/config（expireStyle、max_save_seconds、max_save_count），上传页动态读取并在范围内选择；管理端改策略后立即生效。
curl 示例：
# 自定义提取码（可选）：-d 'code=MYCODE1'
curl -s -X POST http://localhost:8466/share/text \
-d 'text=你好，文件快传' \
-d 'expire_value=1' \
-d 'expire_style=day'
成功响应（200）：
{ "code": 200, "msg": "ok", "data": { "code": "8XQ2M" } }
data.code 为 5 位取件码（数字或大写字母+数字，取决于 code_generate_type）。
错误响应：
{ "code": 400, "msg": "过期时间类型错误" }
{ "code": 400, "msg": "过期时间值必须大于 0" }
{ "code": 403, "msg": "内容过多,建议采用文件形式" }
{ "code": 403, "msg": "限制最长时间为 7天，可换用其他方式" }
{ "code": 403, "msg": "限制次数最多为 5 次" }
{ "code": 423, "msg": "请求次数过多，请稍后再试" }
游客上传关闭（
openUpload=0）时需携带管理员令牌，否则 403：{"code":403,"msg":"本站未开启游客上传，如需上传请先登录后台"}
取回文本
文本分享的取回走统一的取件接口（消耗次数）：
GET /share/select?code=<code>→text/plain正文即文本内容（响应头Content-Disposition带文件名，无扩展名时为<prefix>.txt）。POST /share/select（{"code":"8XQ2M"}）→ JSON，data.text/data.content为文本内容。
示例：
curl -s "http://localhost:8466/share/select?code=8XQ2M"
你好，文件快传
v3.1 变更：① 支持 JSON 提交（Content-Type: application/json，字段同名）；② 空文本 400「分享内容不能为空」；③ 可选 code 自定义提取码（5-8 位字母数字，占用 400）。