xfy/yggdrasil
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(env): document hardcoded image upload size limits

Browse Source 
本次上传尺寸统一为硬编码 const(非环境变量),但 .env.example 已有
记录硬编码默认值的体例(如图片缓存头)。补一段说明上限数值与超限行为,
便于部署者知晓 4096/25M 的存在及调整方式。
This commit is contained in:
xfy 2026-06-24 13:26:11 +08:00
parent 0777fd469a
commit 933c7a8c93
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
.env.example
View File

@ -102,6 +102,17 @@ COMPRESSION_ALGORITHMS=gzip,brotli,deflate,zstd
# - 原始上传：更改其文件路径；
# - 处理变体：更改处理参数（查询串不同即视为新资源）。
# ─────────────────────────────────────────────────────────────
# 上传图片尺寸/像素上限（硬编码默认值，非环境变量）
# ─────────────────────────────────────────────────────────────
# 上传时在 header 阶段统一校验(JPEG/PNG/WebP/GIF 同一路径),超限直接 400 拒绝:
# 单边最大 4096px(MAX_IMAGE_DIMENSION,见 src/api/image.rs)
# 总像素最大约 2500 万(MAX_IMAGE_PIXELS,约 5000×5000)
# 超限返回:"图片尺寸过大,请压缩到 4096×4096 以内或单图不超过约 5000 万像素后再上传"。
# 这两个值同时也是图片解码的安全护栏(防超大图撑爆内存),不宜轻易下调。
# 如需调整,改 src/api/image.rs 的 const 后重新编译。
# 注:读取侧 GET /uploads/* 的动态处理(?w= 等)沿用同一上限,无参数取原图不查像素。
# ─────────────────────────────────────────────────────────────
# 图片磁盘缓存上限（uploads/.cache/，后台清理任务每小时扫描一次）
# ─────────────────────────────────────────────────────────────