SKYMirror
9686fe887a
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 全绿；二进制端到端冒烟通过
98 lines
6.5 KiB
Go
98 lines
6.5 KiB
Go
// Package config — schema.go 定义 v2 新增配置键（KV）schema：
|
||
// 键名常量、类型、默认值与取值边界。管理与 API 层（t2）按下表读写与校验，
|
||
// 文档（t4）按本表生成说明。键名除参考实现既有 camelCase 键外，
|
||
// v2 新增键统一 snake_case。
|
||
package config
|
||
|
||
// —— v2 新增/沿用键名常量（单一事实来源；settings 包会 re-export）——
|
||
// 命名规则：v2 新增键 snake_case；与参考实现对齐的既有键保持原拼写。
|
||
const (
|
||
// 需求 ①：背景图
|
||
KeyBackground = "background" // 参考实现既有键（v1 兼容保留）
|
||
KeyBackgroundURL = "background_url" // v2 新增：背景图 URL 或上传后的访问地址（空=默认主题）
|
||
// 需求 ②：页脚
|
||
KeyFooterText = "footer_text" // v2 新增：页脚自定义内容（纯文本或受控 HTML 片段）
|
||
KeyFooterBeian = "footer_beian" // v2 新增：备案号（如 京ICP备2024xxxxxx号-1）
|
||
// 需求 ③：系统通知
|
||
KeyNotifyEnabled = "notify_enabled" // v2 新增：通知开关，1 开启 / 0 关闭
|
||
KeyNotifyTitle = "notify_title" // 既有键：通知标题
|
||
KeyNotifyContent = "notify_content" // 既有键：通知内容（允许 <a> 等受控 HTML）
|
||
// 需求 ④：保存策略（上传页动态读取并在范围内选择）
|
||
KeyMaxSaveSeconds = "max_save_seconds" // 既有键：最长保存秒数，0=不限制（仅受默认 7 天兜底）
|
||
KeyMaxSaveCount = "max_save_count" // v2 新增：单次分享最大可取（保存）次数上限，0=不限制
|
||
KeyExpireStyle = "expireStyle" // 既有键：允许的过期方式白名单
|
||
// 需求 ④：上传频率限制（既有键，对齐参考 ip_limit["upload"]）
|
||
KeyUploadCount = "uploadCount" // 窗口内允许上传次数
|
||
KeyUploadMinute = "uploadMinute" // 频率窗口（分钟）
|
||
// 需求 ④⑩：存储策略（最大文件大小/允许类型/总容量）
|
||
KeyUploadSize = "uploadSize" // 既有键：单文件上限（字节），参考实现语义
|
||
KeyMaxFileSize = "max_file_size" // v2 新增：存储策略-单文件上限（字节），0=回落 uploadSize
|
||
KeyAllowedTypes = "allowed_file_types" // 既有键：允许类型白名单（"*" 不限制）
|
||
KeyStorageLimit = "storageLimit" // 既有键：站点总容量（字节），0=不限制
|
||
KeyOpenUpload = "openUpload" // 既有键：游客上传开关
|
||
// v3：存储引擎运行时可配（热切换；file_storage 为参考既有键保留兼容）
|
||
KeyStorageEngine = "storage_engine" // 当前存储引擎：local|s3|webdav
|
||
KeySiteDomain = "site_domain" // 站点对外域名（空=分享链接用当前地址）
|
||
)
|
||
|
||
// —— 取值边界（管理端保存与 API 校验用）——
|
||
const (
|
||
// 保存时间上限：最长 365 天，0 表示不限制。
|
||
MaxSaveSecondsMax = 365 * 24 * 60 * 60
|
||
// 保存次数上限：最长 100000 次，0 表示不限制。
|
||
MaxSaveCountMax = 100000
|
||
// 单文件大小上限：最长 10 GiB，0 表示回落 uploadSize。
|
||
MaxFileSizeMax = 10 * 1024 * 1024 * 1024
|
||
// 背景图 URL 最大长度（含 data: 之外的普通 http(s) URL）。
|
||
BackgroundURLMaxLen = 2048
|
||
// 页脚自定义内容最大长度。
|
||
FooterTextMaxLen = 2000
|
||
// 备案号最大长度。
|
||
FooterBeianMaxLen = 128
|
||
// 通知标题/内容最大长度。
|
||
NotifyTitleMaxLen = 128
|
||
NotifyContentMaxLen = 2000
|
||
)
|
||
|
||
// KVSchemaEntry 配置键元数据：类型 / 默认值 / 说明，供管理端 UI 与文档生成。
|
||
type KVSchemaEntry struct {
|
||
Key string // KV 键名
|
||
Type string // string | int | int64 | bool | []string
|
||
Default any // 默认值（与 defaults() 保持一致，测试保证同步）
|
||
Min int64 // 数值键最小值（字符串键为长度下界）
|
||
Max int64 // 数值键最大值（字符串键为长度上界；-1 不限制）
|
||
Description string // 中文说明
|
||
}
|
||
|
||
// KVSchema v2 全量配置键 schema 表（含既有策略键，供管理端/文档/AI 校验）。
|
||
// 注意：Default 与 config defaults() 逐一对应（schema_test 保证）。
|
||
func KVSchema() []KVSchemaEntry {
|
||
return []KVSchemaEntry{
|
||
// —— 需求 ① 背景图 ——
|
||
{KeyBackgroundURL, "string", "", 0, BackgroundURLMaxLen, "背景图 URL 或上传后地址（空=主题默认）"},
|
||
// —— 需求 ② 页脚 ——
|
||
{KeyFooterText, "string", "", 0, FooterTextMaxLen, "页脚自定义内容（纯文本或受控 HTML 片段）"},
|
||
{KeyFooterBeian, "string", "", 0, FooterBeianMaxLen, "备案号，展示于页脚"},
|
||
// —— 需求 ③ 系统通知 ——
|
||
{KeyNotifyEnabled, "int", 1, 0, 1, "系统通知开关：1 右上角悬浮窗展示 / 0 关闭"},
|
||
{KeyNotifyTitle, "string", "系统通知", 0, NotifyTitleMaxLen, "通知标题"},
|
||
{KeyNotifyContent, "string", "欢迎使用文件快传，拖拽或粘贴即可分享文本与文件。", 0, NotifyContentMaxLen, "通知内容（允许 <a> 等受控 HTML）"},
|
||
// —— 需求 ④ 保存策略 ——
|
||
{KeyMaxSaveSeconds, "int64", int64(0), 0, MaxSaveSecondsMax, "最长保存秒数上限，0=不限制（默认 7 天兜底）"},
|
||
{KeyMaxSaveCount, "int", 0, 0, MaxSaveCountMax, "单次分享最大可取次数上限，0=不限制"},
|
||
{KeyExpireStyle, "[]string", []string{"day", "hour", "minute", "forever", "count"}, -1, -1, "上传页可选过期方式白名单"},
|
||
// —— 需求 ④ 上传频率限制（既有键对齐参考）——
|
||
{KeyUploadCount, "int", 10, 1, 10000, "频率窗口内允许的上传次数"},
|
||
{KeyUploadMinute, "int", 1, 1, 1440, "上传频率窗口（分钟）"},
|
||
// —— 需求 ④⑩ 存储策略 ——
|
||
{KeyMaxFileSize, "int64", int64(0), 0, MaxFileSizeMax, "存储策略-单文件上限（字节），0=回落 uploadSize"},
|
||
{KeyUploadSize, "int64", int64(1024 * 1024 * 10), 1024, MaxFileSizeMax, "单文件上限（字节），参考实现语义"},
|
||
{KeyAllowedTypes, "[]string", []string{"*"}, -1, -1, "允许上传类型白名单（\"*\" 不限制）"},
|
||
{KeyStorageLimit, "int64", int64(0), 0, -1, "站点总容量（字节），0=不限制"},
|
||
{KeyOpenUpload, "int", 1, 0, 1, "游客上传开关：1 开 / 0 需管理员登录"},
|
||
// —— v3 存储引擎（热切换；引擎参数键沿用 defaults() 既有键，管理端经 config get/update 读写）——
|
||
{KeyStorageEngine, "string", "", 0, 16, "当前存储引擎：local|s3|webdav（热切换，健康检查通过才生效；空=回落启动值 FCB_STORAGE_ENGINE）"},
|
||
{KeySiteDomain, "string", "", 0, 256, "站点对外域名（http(s)://host[:port]，不带路径；空=分享链接用当前访问地址）"},
|
||
}
|
||
}
|