Expand description
回收站与站点配置模型。 回收站与站点配置模型。
Structs§
- Asset
Purge Settings - 孤儿素材自动清理配置（uploads/ 中无引用的图片）。
- Backup
Settings - 自动备份配置。
- Backup
Settings View get_backup_settings的响应：设置 + 上次结果 + 下次执行时间。- Image
Cache Settings - 图片磁盘缓存配置（uploads/.cache/ 的容量与保留策略）。
- Image
Limit Settings - 图片处理尺寸限制与尺寸缓存配置。
- Last
Backup Run - 最近一次自动备份结果（落库 settings 键，重启后可查；内存任务表 1 小时即清）。
- Rate
Limit Settings - 限流配置（多级 IP 键控限流器的速率/突发/日限额与 GC 间隔）。
- Runner
Settings - 代码运行器配置（资源限制与并发）。
- Security
Settings - 安全配置（CSRF 可信源、cookie Secure 标志、真实 IP 提取、并发会话上限）。
- Site
Settings - 站点公开配置（前台展示用，所有访客可见）。
- System
Info - 系统启动配置的只读快照（面板展示用）。
- Trash
Settings - 回收站配置。
- Upload
Settings - 素材上传配置（/admin/assets 上传弹窗行为，仅 admin 可见/可改）。
- Webp
Settings - WebP 有损编码配置（质量与方法）。
Constants§
- DEFAULT_
APP_ BASE_ URL - 默认 APP_BASE_URL：空串表示未配置（回退到 Host 头推导，仅本地安全）。
- DEFAULT_
ASSET_ ORPHAN_ PURGE_ ENABLED - 默认启用孤儿素材自动清理。
- DEFAULT_
ASSET_ ORPHAN_ RETENTION_ DAYS - 默认孤儿素材保留 7 天（与 /admin/assets 手动清理的 PURGE_GRACE_DAYS 一致， 保护尚未首次保存的草稿引用）。
- DEFAULT_
AUTO_ PURGE_ ENABLED - 默认不启用自动清理。
- DEFAULT_
BACKUP_ AUTO_ ENABLED - 默认不启用自动备份。
- DEFAULT_
BACKUP_ INCLUDE_ UPLOADS - 默认备份产物包含 uploads 素材包。
- DEFAULT_
BACKUP_ RETENTION_ COUNT - 默认保留最近 30 份自动备份。
- DEFAULT_
BACKUP_ TIME_ UTC - 默认每天 04:00 (UTC) 执行（服务器低峰）。
- DEFAULT_
COOKIE_ SECURE - 默认不给会话 cookie 加 Secure 标志（本地 HTTP 开发需要）。
- DEFAULT_
IMAGE_ DIMENSIONS_ CACHE_ TTL_ SECS - 默认图片尺寸缓存 TTL 86400 秒（24 小时）。
- DEFAULT_
IMAGE_ DISK_ CACHE_ MAX_ AGE_ HOURS - 默认图片磁盘缓存保留 168 小时（7 天）。
- DEFAULT_
IMAGE_ DISK_ CACHE_ MAX_ MB - 默认图片磁盘缓存上限 1024 MB。
- DEFAULT_
IMAGE_ MAX_ DIMENSION - 默认图片单边尺寸上限 8192 像素。
- DEFAULT_
IMAGE_ MAX_ PIXELS - 默认图片像素总数上限 50_000_000（约 7k×7k）。
- DEFAULT_
MAX_ SESSIONS_ PER_ USER - 默认每用户最大并发会话数 5。
- DEFAULT_
RATE_ LIMIT_ CODE_ EXEC_ BURST - DEFAULT_
RATE_ LIMIT_ CODE_ EXEC_ DAILY - 默认代码执行日限额：50 次/天。
- DEFAULT_
RATE_ LIMIT_ CODE_ EXEC_ PER_ SEC - 默认代码执行限流：1 req/s，突发 3。
- DEFAULT_
RATE_ LIMIT_ COMMENT_ BURST - DEFAULT_
RATE_ LIMIT_ COMMENT_ PER_ SEC - 默认评论限流：1 req/s，突发 5。
- DEFAULT_
RATE_ LIMIT_ COMMENT_ UPLOAD_ BURST - DEFAULT_
RATE_ LIMIT_ COMMENT_ UPLOAD_ DAILY - 默认评论图片上传日限额：30 次/天。 评论图片允许匿名上传，磁盘成本需要硬性日上限防滥用（同 code_exec 双层语义）。
- DEFAULT_
RATE_ LIMIT_ COMMENT_ UPLOAD_ PER_ SEC - 默认评论图片上传限流：1 req/s，突发 5。
- DEFAULT_
RATE_ LIMIT_ GC_ INTERVAL_ SECS - 默认限流桶 GC 间隔：300 秒。
- DEFAULT_
RATE_ LIMIT_ IMAGE_ BURST - DEFAULT_
RATE_ LIMIT_ IMAGE_ PER_ SEC - 默认图片访问限流：10 req/s，突发 50。
- DEFAULT_
RATE_ LIMIT_ STRICT_ BURST - DEFAULT_
RATE_ LIMIT_ STRICT_ PER_ SEC - 默认严格限流（注册/登录）：1 req/s，突发 5。
- DEFAULT_
RATE_ LIMIT_ UNKNOWN_ BURST - DEFAULT_
RATE_ LIMIT_ UNKNOWN_ PER_ SEC - 默认 unknown 桶限流：30 req/s，突发 100。
- DEFAULT_
RATE_ LIMIT_ UPLOAD_ BURST - DEFAULT_
RATE_ LIMIT_ UPLOAD_ PER_ SEC - 默认上传限流：2 req/s，突发 15。
- DEFAULT_
RETENTION_ DAYS - 默认保留天数（天）。
- DEFAULT_
RUNNER_ ALLOW_ NETWORK - 默认不允许容器联网。
- DEFAULT_
RUNNER_ MAX_ CONCURRENT - 默认最大并发 4。
- DEFAULT_
RUNNER_ MAX_ CPU_ CORES - 默认每任务最大 CPU 核数 2.0。
- DEFAULT_
RUNNER_ MAX_ MEMORY_ MB - 默认每任务最大内存 1024 MB。
- DEFAULT_
RUNNER_ MAX_ OUTPUT_ BYTES - 默认每任务最大输出 1048576 字节（1 MB）。
- DEFAULT_
RUNNER_ MAX_ SOURCE_ BYTES - 默认每任务最大源码 65536 字节（64 KB）。
- DEFAULT_
RUNNER_ MAX_ TIMEOUT_ SECS - 默认每任务最大执行超时 30 秒。
- DEFAULT_
RUNNER_ QUEUE_ TIMEOUT_ SECS - 默认排队等待超时 30 秒。
- DEFAULT_
RUNNER_ TASK_ TTL_ SECS - 默认历史 task 保留 300 秒。
- DEFAULT_
SITE_ GITHUB_ URL - 默认 GitHub 链接：空字符串表示不展示页脚图标。
- DEFAULT_
TRUSTED_ PROXY_ COUNT - 默认反向代理层数 0（直接对外服务）。
- DEFAULT_
UPLOAD_ CONCURRENCY - 默认并发上传数：worker 池并发 3，张间停顿随之放大（见 asset_upload.rs）， 聚合速率与默认上传限流桶（2/s）对齐。
- DEFAULT_
WEBP_ METHOD - 默认 WebP 编码方法 2。
- DEFAULT_
WEBP_ QUALITY - 默认 WebP 质量 85.0。
- MAX_
ASSET_ ORPHAN_ RETENTION_ DAYS - 保留天数上限（天）。防止误填超大值导致永不清理。
- MAX_
BACKUP_ RETENTION_ COUNT - 保留份数上限。防止误填超大值导致磁盘无限增长。
- MAX_
MAX_ SESSIONS_ PER_ USER MAX_SESSIONS_PER_USER上限，防误填危险大值。- MAX_
RETENTION_ DAYS - 保留天数上限（天）。防止误填超大值导致永不清理。
- MAX_
RUNNER_ MAX_ CONCURRENT - 最大并发上限，防误填危险大值。
- MAX_
RUNNER_ MAX_ CPU_ CORES - CPU 核数上限。
- MAX_
RUNNER_ MAX_ MEMORY_ MB - 内存上限（MB）。
- MAX_
SITE_ GITHUB_ URL_ LEN - GitHub 链接最大长度（字符），防止滥用。
- MAX_
TRUSTED_ PROXY_ COUNT TRUSTED_PROXY_COUNT上限。超过真实代理层数会信任客户端伪造的 IP， 导致限流被绕过；上限给一个宽松天花板防误填危险大值。- MAX_
UPLOAD_ CONCURRENCY - 并发数上限。防止误填超大值瞬间打满浏览器连接与上传限流突发桶。
- MAX_
WEBP_ METHOD WEBP_METHOD上限。- MAX_
WEBP_ QUALITY WEBP_QUALITY上限。- MIN_
ASSET_ ORPHAN_ RETENTION_ DAYS - 保留天数下限（天）。
- MIN_
BACKUP_ RETENTION_ COUNT - 保留份数下限。
- MIN_
IMAGE_ DIMENSIONS_ CACHE_ TTL_ SECS - 尺寸缓存 TTL 下限（秒）。
- MIN_
IMAGE_ DISK_ CACHE_ MAX_ AGE_ HOURS - 缓存保留时长下限（小时）。
- MIN_
IMAGE_ DISK_ CACHE_ MAX_ MB - 磁盘缓存上限下限（MB），防误填危险小值。
- MIN_
IMAGE_ MAX_ DIMENSION - 图片单边尺寸下限（防误调到危险小值导致正常图都传不上）。
- MIN_
IMAGE_ MAX_ PIXELS - 图片像素总数下限（防误调）。
- MIN_
MAX_ SESSIONS_ PER_ USER MAX_SESSIONS_PER_USER下限（至少允许 1 个会话）。- MIN_
RATE_ LIMIT_ BURST - 所有 burst 字段下限：至少允许 1 次突发。
- MIN_
RATE_ LIMIT_ DAILY - 日限额下限：至少允许 1 次/天。
- MIN_
RATE_ LIMIT_ GC_ INTERVAL_ SECS - GC 间隔下限（秒）：至少 1 秒。
- MIN_
RATE_ LIMIT_ PER_ SEC - 所有 per_sec 字段下限：至少 1 req/s（NonZeroU32 不允许 0）。
- MIN_
RETENTION_ DAYS - 保留天数下限（天）。
- MIN_
RUNNER_ MAX_ CONCURRENT - 最大并发下限（至少允许 1 个）。
- MIN_
RUNNER_ MAX_ CPU_ CORES - CPU 核数下限。
- MIN_
RUNNER_ MAX_ MEMORY_ MB - 内存下限（MB）。
- MIN_
RUNNER_ MAX_ TIMEOUT_ SECS - 超时下限（秒）。
- MIN_
UPLOAD_ CONCURRENCY - 并发数下限（1 = 退化为顺序上传）。
- MIN_
WEBP_ QUALITY WEBP_QUALITY下限。
Functions§
- parse_
hhmm 🔒 - 解析 “HH:MM”（容忍单数字与空白）为 (hour, minute)；非法返回 None。