上传与媒体设置
「上传与媒体设置」决定整个站点的上传策略——不论运营在哪里上传（媒体库、产品封面、文章配图、Logo），都遵循这里的规则。
后台入口：站点设置 → 上传与媒体
待补充截图 字段：普通文件大小 / 视频文件大小 / 允许的文件类型 / 文件命名规则 / 自动压缩 / 视频缩略图开关
6 项核心配置
Section titled “6 项核心配置”| 配置项 | 默认 | 影响 |
|---|---|---|
| 普通文件大小上限 | 50 MB | 图片、PDF、Word、压缩包等 |
| 视频文件大小上限 | 200 MB | 视频文件单独的更大上限 |
| 允许的文件类型 | 见下文 | 白名单——不在列表的扩展名禁止上传 |
| 文件命名规则 | 保留原名 | 决定落地后的文件名长什么样 |
| 图片自动压缩 | 开启 | 上传时是否压缩 |
| 视频自动生成缩略图 | 开启 | 上传视频时是否抓首帧作为封面图 |
文件大小上限
Section titled “文件大小上限”两个独立上限：
- 普通文件：图片、PDF、Word、压缩包等 → 默认 50 MB
- 视频文件：MP4、MOV、WebM 等 → 默认 200 MB
怎么调：
-
在「上传与媒体」面板找到对应字段
-
输入MB 数字（不带单位）：
- 改 100 = 100 MB
- 改 500 = 500 MB
-
保存 → 立即生效，下次上传按新规则
允许的文件类型
Section titled “允许的文件类型”怎么填：扩展名列表，英文逗号分隔：
jpg,jpeg,png,gif,webp,svg,pdf,docx,xlsx,zip,mp4,webm,mov,ogg默认列表包括：
- 图片：jpg / jpeg / png / gif / webp / svg
- 文档：pdf / docx / xlsx
- 压缩包：zip
- 视频：mp4 / webm / mov / ogg
常见追加：
- 设计源文件：
psd / ai / sketch / fig - CAD 文件：
dwg / dxf / step / iges - 数据文件：
csv / json / xml - 字体：
woff / woff2 / ttf / otf
改了类型列表后
Section titled “改了类型列表后”- ✅ 新上传按新规则 — 下次上传立即生效
- ✅ 已上传的文件不受影响 — 即使某个扩展名被移出白名单，已上传的文件仍能正常访问
- ⚠️ 如果你删了某个类型，对应的内容里如果还在用——前台仍能访问，但运营再也无法上传新的
文件命名规则
Section titled “文件命名规则”两种选择：
保留原文件名（默认）
Section titled “保留原文件名（默认）”上传 产品手册.pdf → 落地为 产品手册.pdf（保留中文）。
优势：
- 用户下载时看到的是中文名（友好）
- 不需要数据库维护”原名 ↔ 落地名”映射
- 直观
劣势：
- 文件名暴露业务（如
2026-内部价格表.xlsx） - 中文文件名在某些 CDN / 邮件客户端转码异常
自动随机命名
Section titled “自动随机命名”上传 产品手册.pdf → 落地为 l3k2j-a8f3.pdf（时间戳+随机串）。
优势：
- 文件名不暴露业务，更像 CDN URL
- 100% 避免冲突
- 字符全 ASCII，CDN 友好
劣势：
- 用户下载时看到的是
l3k2j-a8f3.pdf（用户体验差） - 需要主题做”展示文件名 vs URL 文件名”的二次映射
| 业务场景 | 推荐 |
|---|---|
| B2B 内容站、营销站、博客 | 保留原文件名（用户体验优先） |
| 高敏感场景（金融、内部资料、法务） | 自动随机命名（不暴露业务） |
| 不确定 | 保留原文件名（迁移成本低） |
图片自动压缩
Section titled “图片自动压缩”开启（默认）：
- 上传图片时保留原图
- 前台展示时由主题或反向代理（如 imgproxy）按需生成多尺寸
关闭：
- 上传图片直接落地，不做任何处理
- 适合需要保留原始尺寸 / 不希望任何压缩的场景（如设计公司、摄影站）
视频自动生成缩略图
Section titled “视频自动生成缩略图”开启（默认）：上传视频时，前端用 canvas 抓视频第一帧作为缩略图。
用途：
- 媒体库网格里视频卡片显示首帧画面（不再是黑色占位）
- 前台播放器加载前显示首帧（带
<video poster>） - 视频列表页可以用首帧作为预览图
关闭：
- 上传视频时不生成缩略图
- 适合视频本身已经有手动指定的封面图、不需要自动生成
何时改这些设置
Section titled “何时改这些设置”| 配置项 | 改动频率 | 改的原因 |
|---|---|---|
| 文件大小上限 | 偶尔 | 运营频繁报上传失败 / 服务器存储快满了 |
| 允许的文件类型 | 偶尔 | 业务新增需求（如要支持 CAD） |
| 文件命名规则 | 几乎不改 | 业务隐私要求变更 |
| 图片自动压缩 | 几乎不改 | 改主题策略时同步调整 |
| 视频缩略图 | 几乎不改 | 默认开启即可 |
改了上传上限后，前端组件会立刻知道吗？
Section titled “改了上传上限后，前端组件会立刻知道吗？”会。BangNiCMS 所有内置上传组件都从这里实时拉取策略——后台改了，下次进入上传界面就按新值校验。
唯一例外：自定义主题或插件自己写的上传组件——如果开发者硬编码了 maxSize: 10 * 1024 * 1024，运维改了上限不生效。这是开发者的 bug，必须改成从「站点设置」读取。详见 媒体库 - 上传组件统一规范。
文件类型白名单不区分大小写吗？
Section titled “文件类型白名单不区分大小写吗？”不区分——PDF / pdf / Pdf 都算同一个扩展名。系统会统一转小写处理。
视频缩略图清晰度可以调吗？
Section titled “视频缩略图清晰度可以调吗？”当前不可调——固定 400×225（16:9 比例）。如果你需要更高清，需要让开发者改主题代码或扩展插件。
我能不能让某种文件类型只允许某些用户上传？
Section titled “我能不能让某种文件类型只允许某些用户上传？”当前不支持——白名单是全站统一的。
如果你需要”管理员能传 .exe，普通运营不能”，需要通过用户权限控制（详见 用户与权限 章节，建设中）。
上传到外部 CDN（七牛 / 阿里云 OSS）的设置在哪？
Section titled “上传到外部 CDN（七牛 / 阿里云 OSS）的设置在哪？”当前 BangNiCMS 只支持本地文件系统——这里没有 CDN 配置项。
如果你需要外部 CDN：
- 简单方案：让运维把存储目录挂载到 OSS（如阿里云 OSSFS）
- 完整方案：等”对象存储插件”（建设中）
- 媒体库 — 实际上传时的操作
- 邮件通知与 AI 模型 — 配置邮件 / AI
- 媒体库 - 上传组件统一规范 — 给开发者的指南