From 933c7a8c9386da23fee4ff2d9baa880bd5b6a7e8 Mon Sep 17 00:00:00 2001 From: xfy Date: Wed, 24 Jun 2026 13:26:11 +0800 Subject: [PATCH] docs(env): document hardcoded image upload size limits MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 本次上传尺寸统一为硬编码 const(非环境变量),但 .env.example 已有 记录硬编码默认值的体例(如图片缓存头)。补一段说明上限数值与超限行为, 便于部署者知晓 4096/25M 的存在及调整方式。 --- .env.example | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/.env.example b/.env.example index a3345ba..ebd2487 100644 --- a/.env.example +++ b/.env.example @@ -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/，后台清理任务每小时扫描一次） # ─────────────────────────────────────────────────────────────