SKYMirrorPublicTeam/FileShare
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

26.9：版本号统一 + CI 精简 + 前端产物重建
CI 测试 / go vet + go test (push) Successful in 49s
Details

Browse Source 
- 全项目版本号统一：v3.x 迭代号（26.9/26.9/26.9/26.9 及裸 v2/v3）→ 26.9，
  覆盖 Go 注释 / 文档 / openapi.yaml / README×4 / 前端源码（80+ 处）
- v31_test.go 更名 custom_code_test.go；TestV2AccessorDefaults → TestKVAccessorDefaults
- docs/api/00-overview.md 更新日志合并为单条 26.9 条目（修复错位拼接）
- .goreleaser.yaml 头部注释与实际一致（Pro 2.18.1 / GITEA_TOKEN / semver tag 要求）
- CI：release-image.yml → ci.yml，仅保留 vet+test 门禁；
  镜像发布移交 GoReleaser Pro（原 build-push 的 tag 校验与 26.9 版本方案冲突，历史 9 次失败）
- 前端重建：server/web/dist 与 web-embed 同步（docs 文案嵌入更新）
This commit is contained in:
SKYMirror
2026-09-08 03:16:51 +08:00
parent 27432218c4
commit 84df9996cb
122 changed files with 247 additions and 12268 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/api/00-overview.md
+5 -3
View File
@@ -5,8 +5,10 @@
## 更新日志
- **v3.2**：上下行带宽限速（`upload_rate` / `download_rate`，详见《[带宽限速](13-bandwidth.md)》）
- v3.1：站点对外域名（`site_domain`）、自定义提取码（5~8 位）本文档与 `server/internal/api/` 实际实现逐一对齐，
- **26.9**：上下行带宽限速（`upload_rate` / `download_rate`，详见《[带宽限速](13-bandwidth.md)》）、
站点对外域名（`site_domain`）、自定义提取码（5~8 位）
本文档与 `server/internal/api/` 实际实现逐一对齐，
交互式规范见站内 `/openapi`（源文件 `docs/openapi.yaml`）。
## Base URL
@@ -98,7 +100,7 @@
|---|---|
| 站点 Logo 自定义 | [12-logo.md](12-logo.md) |
| 错误码 | [11-errors.md](11-errors.md) |
| 带宽限速（v3.2） | [13-bandwidth.md](13-bandwidth.md) |
| 带宽限速（26.9） | [13-bandwidth.md](13-bandwidth.md) |
## 时间与编码
docs/api/02-text-share.md
+2 -2
View File
@@ -18,7 +18,7 @@
- `day`/`hour`/`minute`：按时间过期，`expired_count = -1`。
- `count`：按次数过期，取件 `expire_value` 次后失效（`expired_count = expire_value`）；
**v2 需求 ④**：`max_save_count>0` 时 `expire_value` 不得超出该上限，超限 403。
**26.9 需求 ④**：`max_save_count>0` 时 `expire_value` 不得超出该上限，超限 403。
- `forever`：永久（需站点允许；`max_save_seconds>0` 时其他方式受最长保存上限约束，超限 403）。
> 可选值与上限来自公开配置 `GET /api/v1/config`（`expireStyle`、`max_save_seconds`、
@@ -88,4 +88,4 @@ curl -s "http://localhost:8466/share/select?code=8XQ2M"
你好，文件快传
```
**v3.1 变更**：① 支持 JSON 提交（`Content-Type: application/json`，字段同名）；② 空文本 400「分享内容不能为空」；③ 可选 `code` 自定义提取码（5-8 位字母数字，占用 400）。
**26.9 变更**：① 支持 JSON 提交（`Content-Type: application/json`，字段同名）；② 空文本 400「分享内容不能为空」；③ 可选 `code` 自定义提取码（5-8 位字母数字，占用 400）。
docs/api/03-file-share.md
+1 -1
View File
@@ -39,7 +39,7 @@ curl -s -X POST http://localhost:8466/share/file \
{ "code": 403, "msg": "大小超过限制,最大为10.00 MB" }
```
> 大小上限为动态策略（v2 需求 ④⑩）：管理端改 `max_file_size`（0=回落 `uploadSize`）后
> 大小上限为动态策略（26.9 需求 ④⑩）：管理端改 `max_file_size`（0=回落 `uploadSize`）后
> **下一次上传立即按新上限执行**，无需重启；上限值可经 `GET /api/v1/config` 的
> `max_file_size`/`maxFileSize` 字段读取。
docs/api/05-chunk-upload.md
+1 -1
View File
@@ -130,7 +130,7 @@ curl -s -X POST http://localhost:8466/chunk/upload/3f6b8c2a4d5e6f708192a3b4c5d6e
> 约束：单分片 ≤ `chunk_size`（init 声明值）且 ≤ **32MiB 硬上限**（init 时 `chunk_size>33554432` 直接 400「chunk_size 过大」）；
> 总大小（init 按分片数上限、上传/合并按累计）受**动态策略上限**约束——`max_file_size>0` 时为其，
> 否则回落 `uploadSize`（v2 需求 ④⑩，管理端改后立即生效，超限清理会话）；首个分片做 magic bytes
> 否则回落 `uploadSize`（26.9 需求 ④⑩，管理端改后立即生效，超限清理会话）；首个分片做 magic bytes
> 防伪校验（403「文件内容校验失败：…」）。分片哈希由服务端计算；合并时与分片记录交叉校验，不一致报 400。
>
> **enableChunk 开关**：管理端关闭分片上传后，`/chunk/upload/*` 全部端点返回 403「分片上传未启用」（后端强制，前端仅隐藏入口）。
docs/api/06-presign.md
+1 -1
View File
@@ -82,7 +82,7 @@ curl -s -X POST http://localhost:8466/presign/upload/init \
{ "code": 403, "msg": "大小超过限制,最大为10.00 MB" }
```
> 大小上限为动态策略（v2 需求 ④⑩）：管理端改 `max_file_size`（0=回落 `uploadSize`）后
> 大小上限为动态策略（26.9 需求 ④⑩）：管理端改 `max_file_size`（0=回落 `uploadSize`）后
> 立即按新上限校验 init 声明的 `file_size`。
```json
docs/api/07-admin.md
+6 -6
View File
@@ -318,7 +318,7 @@ curl -s "http://localhost:8466/admin/file/preview?id=41&maxChars=100" -H "Author
返回运行时配置 KV（含默认值与管理端修改）。`admin_token` 恒返回空串（屏蔽）；
`jwt_secret` 不下发；存储引擎为进程级单例，`_engine_hint` 提示引擎配置修改需重启。
v2 新增键（需求 ①②③④⑩）一并返回：`background_url`、`footer_text`、`footer_beian`、
26.9 新增键（需求 ①②③④⑩）一并返回：`background_url`、`footer_text`、`footer_beian`、
`notify_enabled`、`max_save_count`、`max_file_size` 等。
```json
@@ -351,7 +351,7 @@ v2 新增键（需求 ①②③④⑩）一并返回：`background_url`、`foote
}
```
## 存储引擎热切换：POST /admin/storage/switch（v3）
## 存储引擎热切换：POST /admin/storage/switch（26.9）
运行时切换存储引擎，**无需重启**：
@@ -374,14 +374,14 @@ curl -s -X POST http://localhost:8466/admin/storage/switch \
部分更新（JSON 对象，未提供的键不变；表单亦可）。**PATCH 为主名，POST 为兼容别名**。
- 仅接受管理端可见键（见上响应键集合），未知键忽略。
- 数值型键自动转型：`openUpload`、`enableChunk`、`uploadSize`、`storageLimit`、限流四组、`max_save_seconds`、`adminSessionExpire`、`showAdminAddr`；v2 新增 `max_save_count`、`max_file_size`、`notify_enabled`；`opacity` 为浮点。
- **v3.1**：`site_domain`（站点对外域名）可经本端点设置，非法格式 400（仅 http/https、主机+端口、不带路径）。
- **v3 引擎键**：`storage_engine` 不经本端点修改（走 `POST /admin/storage/switch`）；引擎参数键
- 数值型键自动转型：`openUpload`、`enableChunk`、`uploadSize`、`storageLimit`、限流四组、`max_save_seconds`、`adminSessionExpire`、`showAdminAddr`；26.9 新增 `max_save_count`、`max_file_size`、`notify_enabled`；`opacity` 为浮点。
- **26.9**：`site_domain`（站点对外域名）可经本端点设置，非法格式 400（仅 http/https、主机+端口、不带路径）。
- **26.9 引擎键**：`storage_engine` 不经本端点修改（走 `POST /admin/storage/switch`）；引擎参数键
（`local_storage_path`、`webdav_url`、`webdav_root_path`、`webdav_username`、`webdav_password`、
`s3_endpoint_url`、`s3_region_name`、`s3_bucket_name`、`s3_access_key_id`、`s3_secret_access_key`、
`aws_session_token`、`s3_addressing_style`）可经本端点保存——保存后对应引擎实例缓存失效，
下次切换/构建生效；敏感键空串或 `******` 表示不修改。
- **v2 schema 校验**（`settings.KVSchema`，越界一律 400，中文错误信息）：
- **26.9 schema 校验**（`settings.KVSchema`，越界一律 400，中文错误信息）：
- 整型边界：`max_file_size` ≤ 10GiB（10737418240）、`max_save_count` ≤ 100000、`max_save_seconds` ≤ 31536000（365 天）、`notify_enabled` ∈ {0,1}、`uploadCount` 1~10000、`uploadMinute` 1~1440 等；
- 字符串长度：`background_url` ≤ 2048、`footer_text` ≤ 2000、`footer_beian` ≤ 128、`notify_title` ≤ 128、`notify_content` ≤ 2000 字符；
- 列表键 `expireStyle` / `allowed_file_types`：须为字符串数组（或逗号分隔串）且至少保留一项；
docs/api/09-storage.md
+2 -2
View File
@@ -14,11 +14,11 @@ FCB_STORAGE_ENGINE=webdav
非法值直接启动失败：`FCB_STORAGE_ENGINE 无效值 "xxx"，仅支持 local|s3|webdav`。
**v3 运行时热切换**：管理端 `POST /admin/storage/switch`（或后台设置页「存储引擎」卡）可在不重启的情况下切换引擎——
**26.9 运行时热切换**：管理端 `POST /admin/storage/switch`（或后台设置页「存储引擎」卡）可在不重启的情况下切换引擎——
先构建新引擎并健康检查，通过才生效；失败 503 保持原引擎。当前引擎持久化在 settings KV `storage_engine`（空=回落启动值）。
各引擎参数（存储目录/服务地址/存储桶/密钥）同样在后台设置页运行时可改；保存后对应引擎实例缓存失效，下次切换/构建生效。
## 文件归属引擎（v3）
## 文件归属引擎（26.9）
每条分享记录（`file_codes.engine`）与上传会话（`upload_chunks.engine` / `presign_upload_sessions.engine`）
在创建时戳记当时的引擎名。下载、分片合并、删除按**归属引擎**操作——切换引擎后，旧引擎里的文件仍可正常下载与删除
docs/api/10-config.md
+16 -16
View File
@@ -1,7 +1,7 @@
# 环境变量与配置项
配置分三层：**默认值 → `FCB_*` 环境变量 → 数据库 settings KV（管理端运行时修改）**。
v2 起进程必需的环境变量为空集：数据库默认 **SQLite**（modernc.org/sqlite 纯 Go 驱动，零外部依赖，
26.9 起进程必需的环境变量为空集：数据库默认 **SQLite**（modernc.org/sqlite 纯 Go 驱动，零外部依赖，
DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DSN` 必需（需求 ⑧）。
## 环境变量（进程级）
@@ -31,14 +31,14 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
## 配置项（settings KV，默认值对齐参考实现）
> 键名/类型/默认值/边界以 `server/internal/config/schema.go` 的 `KVSchema()` 为单一事实来源
> （schema 同步测试保证与 defaults() 逐键一致）；v2 新增键统一 snake_case。
> （schema 同步测试保证与 defaults() 逐键一致）；26.9 新增键统一 snake_case。
### 站点信息与展示（需求 ①②③）
| 键 | 类型/边界 | 默认 | 说明 |
|---|---|---|---|
| `site_name` / `name` | string | 文件快传 | 站点名称（`site_name` 优先） |
| `site_domain` | string，≤256 | 空 | **v3.1**：站点对外域名（`http(s)://host[:port]`，不带路径；裸主机自动补 `http://`）。配置后分享链接（结果卡/管理端复制）用该域名生成——内网部署也能把公网链接发出去；留空=用当前访问地址 |
| `site_domain` | string，≤256 | 空 | **26.9**：站点对外域名（`http(s)://host[:port]`，不带路径；裸主机自动补 `http://`）。配置后分享链接（结果卡/管理端复制）用该域名生成——内网部署也能把公网链接发出去；留空=用当前访问地址 |
| `description` | string | 开箱即用的文件快传系统 | 站点描述 |
| `page_explain` | string | （合规声明） | 页面说明文案 |
| `keywords` | string | 文件快传, 文件分享… | SEO 关键词 |
@@ -46,10 +46,10 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
| `favicon_url` | string | 空（前端回落本地打包 `/assets/favicon-*.png`，需求 ⑤） | favicon / 备用 Logo |
| `opacity` | float | 0.9 | 界面不透明度 |
| `background` | string | 空 | 背景图 URL（参考实现既有键，v1 兼容保留） |
| `background_url` | string，≤2048 字符 | 空 | **v2 需求 ①**：背景图 URL 或上传后地址（空=主题默认；取值时 legacy `background` 键兜底）。管理端保存时校验协议白名单：仅 `http(s)`、`data:image/*` 与站内相对路径（防 `javascript:` 注入，非法 400） |
| `footer_text` | string，≤2000 字符 | 空 | **v2 需求 ②**：页脚自定义内容（纯文本或受控 HTML 片段） |
| `footer_beian` | string，≤128 字符 | 空 | **v2 需求 ②**：备案号（如 `京ICP备2024xxxxxx号-1`），展示于页脚 |
| `notify_enabled` | int（0/1） | 1 | **v2 需求 ③**：通知开关（1=前台右上角悬浮窗展示 / 0=关闭） |
| `background_url` | string，≤2048 字符 | 空 | **26.9 需求 ①**：背景图 URL 或上传后地址（空=主题默认；取值时 legacy `background` 键兜底）。管理端保存时校验协议白名单：仅 `http(s)`、`data:image/*` 与站内相对路径（防 `javascript:` 注入，非法 400） |
| `footer_text` | string，≤2000 字符 | 空 | **26.9 需求 ②**：页脚自定义内容（纯文本或受控 HTML 片段） |
| `footer_beian` | string，≤128 字符 | 空 | **26.9 需求 ②**：备案号（如 `京ICP备2024xxxxxx号-1`），展示于页脚 |
| `notify_enabled` | int（0/1） | 1 | **26.9 需求 ③**：通知开关（1=前台右上角悬浮窗展示 / 0=关闭） |
| `notify_title` | string，≤128 字符 | 系统通知 | 通知标题 |
| `notify_content` | string，≤2000 字符 | 欢迎使用… | 通知正文（**服务端白名单净化**：仅保留纯文本与 `<a href>` 为 http(s)/站内相对/`#` 锚点的链接，其余标签与事件属性剥离，保存与读取双侧生效） |
| `showAdminAddr` | int（0/1） | 0 | 是否展示后台入口 |
@@ -59,8 +59,8 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
| 键 | 类型/边界 | 默认 | 说明 |
|---|---|---|---|
| `max_save_seconds` | int64，0~31536000 | 0 | 最长保存秒数上限（0=仅默认 7 天兜底；>0 时按时间过期超限 403「限制最长时间为 X，可换用其他方式」）。**v3**：管理界面以「小时/天」下拉单位编辑（≥1 天自动显示天），提交时前端换算为秒——canonical 单位保持秒，接口语义不变 |
| `max_save_count` | int，0~100000 | 0 | **v2 新增**：单次分享最大可取（保存）次数上限（0=不限制；`expire_style=count` 且 `expire_value` 超上限时 403「限制次数最多为 N 次」） |
| `max_save_seconds` | int64，0~31536000 | 0 | 最长保存秒数上限（0=仅默认 7 天兜底；>0 时按时间过期超限 403「限制最长时间为 X，可换用其他方式」）。**26.9**：管理界面以「小时/天」下拉单位编辑（≥1 天自动显示天），提交时前端换算为秒——canonical 单位保持秒，接口语义不变 |
| `max_save_count` | int，0~100000 | 0 | **26.9 新增**：单次分享最大可取（保存）次数上限（0=不限制；`expire_style=count` 且 `expire_value` 超上限时 403「限制次数最多为 N 次」） |
| `expireStyle` | []string | `["day","hour","minute","forever","count"]` | 允许的过期方式白名单（上传时不在白名单 400「过期时间类型错误」） |
### 存储策略（需求 ④⑩）
@@ -68,7 +68,7 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
| 键 | 类型/边界 | 默认 | 说明 |
|---|---|---|---|
| `uploadSize` | int64，1024~10GiB | 10485760（10MB） | 单文件大小上限（字节），参考实现语义；`max_file_size=0` 时作为生效上限 |
| `max_file_size` | int64，0~10GiB | 0 | **v2 新增**：存储策略-单文件上限（字节），0=回落 `uploadSize`；超出 403（文案 humanSize 自适应 B/KB/MB/GB）。**v3**：管理界面以「MB/GB」下拉单位编辑（≥1 GiB 自动显示 GB），提交时前端换算为字节 |
| `max_file_size` | int64，0~10GiB | 0 | **26.9 新增**：存储策略-单文件上限（字节），0=回落 `uploadSize`；超出 403（文案 humanSize 自适应 B/KB/MB/GB）。**26.9**：管理界面以「MB/GB」下拉单位编辑（≥1 GiB 自动显示 GB），提交时前端换算为字节 |
| `allowed_file_types` | []string | `["*"]` | 允许类型白名单（扩展名/MIME 通配，`*` 不限制；非白名单 403「不允许上传该类型文件」） |
| `storageLimit` | int64，≥0 | 0 | 站点总容量（字节），0=不限制（超限 507） |
| `openUpload` | int（0/1） | 1 | 游客上传开关（0 时上传接口要求管理员令牌 403） |
@@ -79,7 +79,7 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
| 键 | 类型/边界 | 默认 | 说明 |
|---|---|---|---|
| `uploadCount` / `uploadMinute` | int（1~10000 / 1~1440） | 10 / 1 | 窗口内允许上传次数 / 窗口分钟（上传成功才计数，超限 423；管理端修改后运行时同步限流规则，立即生效） |
| `upload_rate` / `download_rate` | int64（0~1 GiB/s） | 0 / 0 | **v3.2**：上下行带宽字节/秒，0=不限速；管理端改后立即生效（每请求动态读 KV）。详见《[带宽限速](13-bandwidth.md)》 |
| `upload_rate` / `download_rate` | int64（0~1 GiB/s） | 0 / 0 | **26.9**：上下行带宽字节/秒，0=不限速；管理端改后立即生效（每请求动态读 KV）。详见《[带宽限速](13-bandwidth.md)》 |
| `errorCount` / `errorMinute` | int | 10 / 1 | 取件错误（失败计数）+ metadata 每次计数 |
| `loginCount` / `loginMinute` | int | 5 / 15 | 登录失败计数 |
@@ -91,9 +91,9 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
| `jwt_secret` | 空 | JWT 签名密钥（初始化/改密时自动生成轮换；不下发；`settings.SensitiveKeys` 双模式下一致屏蔽） |
| `adminSessionExpire` | 604800（7 天） | 管理员会话秒数（须 1~365 整天） |
### 存储引擎（v3 运行时可配 + 热切换）
### 存储引擎（26.9 运行时可配 + 热切换）
**`storage_engine`**（v3 新增键）：string，`local|s3|webdav`，默认空=回落启动值 `FCB_STORAGE_ENGINE`。
**`storage_engine`**（26.9 新增键）：string，`local|s3|webdav`，默认空=回落启动值 `FCB_STORAGE_ENGINE`。
运行时切换走 **`POST /admin/storage/switch`**（JWT 保护）：构建新引擎 → 健康检查通过才生效；
失败返回 503「存储引擎切换失败，已保持原引擎: …」且不改 KV。成功后持久化 `storage_engine`，重启沿用。
`GET /api/v1/config` 公开下发 `storage_engine` 当前名（仅名称，任何引擎参数/凭据不下发）。
@@ -115,10 +115,10 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
| `webdav_root_path` | `filebox_storage` |
| `webdav_proxy` | 0 |
> 敏感键 `webdav_password` / `s3_secret_access_key` / `aws_session_token`（v3 加入 `settings.SensitiveKeys`）：
> 敏感键 `webdav_password` / `s3_secret_access_key` / `aws_session_token`（26.9 加入 `settings.SensitiveKeys`）：
> 管理端 GET 返回掩码 `******`；PATCH 时空串或 `******` 表示不修改。直接写库 settings KV 后重启同样生效。
## 策略动态生效机制（v2 需求 ④⑩）
## 策略动态生效机制（26.9 需求 ④⑩）
上传页通过 `GET /api/v1/config` 的 `config` 字段读取**当前策略快照**并在范围内渲染选项；
上传链路（`/share/file`、`/chunk/*`、`/presign/*`）**每次请求实时读取** settings KV 同一组值校验：
@@ -129,7 +129,7 @@ DSN 缺省落 `./data/fileshare.db`）；`FCB_DB_DRIVER=postgres` 时 `FCB_DB_DS
## 公共配置接口
前端启动时经 `GET /api/v1/config` 获取站点公开配置（无需认证；v2 扩展需求 ①②③④⑩）：
前端启动时经 `GET /api/v1/config` 获取站点公开配置（无需认证；26.9 扩展需求 ①②③④⑩）：
```json
{
docs/api/12-logo.md
+2 -2
View File
@@ -1,13 +1,13 @@
# Logo 自定义
## 默认 Logo（内置，v2 需求 ⑤）
## 默认 Logo（内置，26.9 需求 ⑤）
| 项 | 默认值 | 用途 |
|---|---|---|
| 页面导航 Logo | 前端打包本地资源 `/assets/logo-*.svg`（源：`web/src/assets/brand/logo.svg`） | 导航栏 `<img>`；`config.logo_url` 为空时回落使用 |
| favicon / 备用 Logo | 前端打包本地资源 `/assets/favicon-*.png`（源：`web/src/assets/brand/favicon.png`） | `index.html` `<link rel="icon">` + 动态 favicon 回落 |
v2 起默认不再引用远程 URL：`GET /api/v1/config` 中 `logo_url`/`favicon_url` 默认下发空串，
26.9 起默认不再引用远程 URL：`GET /api/v1/config` 中 `logo_url`/`favicon_url` 默认下发空串，
前端 `displayLogoUrl`/`displayFaviconUrl` 判空后回落到打包的本地资源。
管理端仍可设置任意 URL 全站替换（三步如下）。
docs/api/13-bandwidth.md
+3 -3
View File
@@ -1,6 +1,6 @@
# 带宽限速（v3.2）
# 带宽限速（26.9）
> v3.2 新增。管理端可独立设置**上行（上传）/ 下行（下载）带宽**，单位字节/秒（前端 UI 友好单位为 MB/s），
> 26.9 新增。管理端可独立设置**上行（上传）/ 下行（下载）带宽**，单位字节/秒（前端 UI 友好单位为 MB/s），
> 0=不限速。修改后**立即生效**（每请求动态读取最新 KV，不需重启容器/进程）。
## 适用对象
@@ -38,7 +38,7 @@ return n, err
保证长期速率严格 ≤ `rate`，瞬时由调用方 Read 块大小自然突发。**不按字节微睡眠**——避免单次 Read 在低速场景下被调度抖动放大。
> 早期版本按每字节 sleep 1/rate 秒，被 Mac 调度粒度（约 10µs）放大后实际速率只有目标值的 1/3；v3.2.1 修正为整块对齐 sleep。
> 早期版本按每字节 sleep 1/rate 秒，被 Mac 调度粒度（约 10µs）放大后实际速率只有目标值的 1/3；26.9 修正为整块对齐 sleep。
## 公开接口
docs/openapi.yaml
+6 -6
View File
@@ -93,7 +93,7 @@ paths:
footer_text: { type: string, description: '需求 ② 页脚自定义内容' }
footer_beian: { type: string, description: '需求 ② 备案号' }
storage_engine: { type: string, description: 当前存储引擎名（仅名称，凭据不下发） }
site_domain: { type: string, description: 'v3.1 站点对外域名（空=用当前访问地址）' }
site_domain: { type: string, description: '26.9 站点对外域名（空=用当前访问地址）' }
notify_enabled: { type: integer, enum: [0, 1], description: '需求 ③ 通知开关（1=右上角悬浮窗）' }
notify_title: { type: string }
notify_content: { type: string }
@@ -166,8 +166,8 @@ paths:
loginMinute: { type: integer, default: 15 }
uploadCount: { type: integer, default: 10 }
uploadMinute: { type: integer, default: 1 }
upload_rate: { type: integer, format: int64, default: 0, description: 'v3.2 上行带宽字节/秒；0=不限速' }
download_rate: { type: integer, format: int64, default: 0, description: 'v3.2 下行带宽字节/秒；0=不限速' }
upload_rate: { type: integer, format: int64, default: 0, description: '26.9 上行带宽字节/秒；0=不限速' }
download_rate: { type: integer, format: int64, default: 0, description: '26.9 下行带宽字节/秒；0=不限速' }
allowed_file_types: { type: string, default: '*' }
openUpload: { type: boolean, default: true }
enableChunk: { type: boolean, default: false }
@@ -207,7 +207,7 @@ paths:
文本 ≤222KB（请求体全局上限 1MiB，Content-Length>441KB 直接 403）；上传类接口（成功计数 upload 限流，423 超限），经审计中间件落库。
保存策略（需求 ④）：expire_style 须在 expireStyle 白名单（400）；count 型受
max_save_count 约束（403「限制次数最多为 N 次」）；时间型受 max_save_seconds 约束（403）。
v3.1：支持 JSON 提交（字段同名）；空文本 400「分享内容不能为空」；
26.9：支持 JSON 提交（字段同名）；空文本 400「分享内容不能为空」；
可选 code 自定义提取码（5-8 位字母或数字，占用 400「该提取码已被占用」）。
requestBody:
content:
@@ -1377,8 +1377,8 @@ paths:
storageLimit: { type: integer, format: int64 }
uploadCount: { type: integer }
uploadMinute: { type: integer }
upload_rate: { type: integer, format: int64, description: 'v3.2 上行带宽字节/秒；0=不限速' }
download_rate: { type: integer, format: int64, description: 'v3.2 下行带宽字节/秒；0=不限速' }
upload_rate: { type: integer, format: int64, description: '26.9 上行带宽字节/秒；0=不限速' }
download_rate: { type: integer, format: int64, description: '26.9 下行带宽字节/秒；0=不限速' }
admin_token: { type: string, example: '' }
_engine_hint:
type: object
docs/security-audit-2026-09-05.md
+1 -1
View File
@@ -83,7 +83,7 @@
- 位置：`server/internal/api/helpers.go:114-125`、`validatePickupCode`（4 位下限）
- 原状：`code_generate_type=number` 时仅 9 万空间（5 位数字），默认 `errorCount=10/分/IP` 下单 IP 需约 6 天扫完，分布式多 IP 可显著缩短；自定义码允许 4 位（36⁴≈168 万）。
- ✅ 修复：自定义提码最小长度 4 → **5 位**（`pickupCodeMinLen=5`，36⁵≈6000 万空间）；测试 `v31_test.go` 与 `TestPickupCodeMinLen` 同步更新。
- ✅ 修复：自定义提码最小长度 4 → **5 位**（`pickupCodeMinLen=5`，36⁵≈6000 万空间）；测试 `custom_code_test.go` 与 `TestPickupCodeMinLen` 同步更新。
### L4 `enableChunk` 开关后端不强制 ✅ 已修复