Repository navigation
Upload Config
zyx3721 edited this page Apr 24, 2026
·
1 revision
配置文件的存储方式，支持本地存储和多种云存储服务。
文件的存储方式，默认为本地存储。
限制单次上传文件的最大大小，仅影响博客端的上传限制，管理端不受影响。
自定义文件存储时的命名规则，默认为 {timestamp}_{random}{ext}。
当存储类型非本地时显示，不同云存储服务需要配置不同的参数： Access Key / Secret Key：云存储服务的凭证，用于身份认证 地域（Region）：用于生成对应的 API 端点地址 Bucket：存储桶名称，云存储中存放文件的最大容器 Endpoint（服务端点）：用于指定存储服务地址 域名：用于生成文件访问 URL，填写后会替代默认域名 HTTPS：R2/MinIO 可根据服务器是否配置 HTTPS 决定
| 存储类型 | 说明 | 备注 |
|---|---|---|
| 本地存储 | 文件存储在服务器本地 uploads 目录 | 可用 |
| 亚马逊 S3 | 兼容 S3 协议的对象存储服务 | 未测试 |
| 阿里云 OSS | 阿里云对象存储服务 | 未测试 |
| 腾讯云 COS | 腾讯云对象存储服务 | 可用 |
| 七牛云 Kodo | 七牛云对象存储服务 | 可用 |
| Cloudflare R2 | Cloudflare R2 对象存储 | 可用 |
| MinIO | 自建 MinIO 对象存储 | 未测试 |
| 占位符 | 说明 | 示例 |
|---|---|---|
| {timestamp} | 时间戳 | 20260319123045 |
| {random} | 8位随机字符串 | a1b2c3d4 |
| {YYYY} | 4位年份 | 2026 |
| {MM} | 2位月份 | 03 |
| {DD} | 2位日期 | 19 |
| {HH} | 2位小时（24小时制） | 14 |
| {mm} | 2位分钟 | 30 |
| {ss} | 2位秒数 | 45 |
| {type} | 上传用途类型 | avatar、article、attachment |
| {userid} | 上传用户 ID | 1 |
| {filename} | 原始文件名（不含扩展名） | image |
| {ext} | 文件扩展名 | .jpg |
| 存储类型 | Access Key | Secret Key | 地域 | Bucket | Endpoint | 域名 | HTTPS |
|---|---|---|---|---|---|---|---|
| 亚马逊 S3 | Access Key | Secret Key | ✅ | ✅ | 可选 | 可选 | ❌ |
| 腾讯云 COS | SecretId | SecretKey | ✅ | ✅ | ❌ | 可选 | ❌ |
| 阿里云 OSS | AccessKeyId | AccessKeySecret | ✅ | ✅ | ❌ | 可选 | ❌ |
| 七牛云 Kodo | AccessKey | SecretKey | ✅ | ✅ | ❌ | ✅ | ❌ |
| Cloudflare R2 | Access Key | Secret Key | ❌ | ✅ | ✅ | 可选 | ✅ |
| MinIO | Access Key | Secret Key | 可选 | ✅ | ✅ | 可选 | ✅ |
| ✅：必需 ❌：无需 |
| 类型 | 文件格式 |
|---|---|
| 图片 | jpg, jpeg, png, gif, webp, svg, bmp, tiff |
| 视频 | mp4, webm, quicktime, avi, mkv, mpeg, 3gpp, flv |
| 音频 | mp3, wav, ogg, aac, flac |
| 文档 | txt, pdf, doc, docx |
| 压缩包 | zip, rar, 7z |
| 其他 | json（配置文件） |
相关页面：