深浅模式
文件存储
配置用户上传的图片、视频等文件的保存位置,支持服务器本地或主流云对象存储。
配置用户上传的图片、视频等文件的保存位置,支持服务器本地或主流云对象存储。
本地存储(local)
- 适用:小规模部署、内网测试
- 文件保存在应用服务器磁盘,需自行备份与扩容
- 通过站点域名下的静态路径访问,依赖反向代理配置
云存储
页面若提供「本地备份」选项,可在云存储为主的同时保留一份本地副本。
存储类型腾讯云 COS / 阿里云 OSS / 七牛云等
AccessKey / SecretKey必填云账号 API 密钥
Bucket 名称必填存储桶
地域 / Endpoint必填与 Bucket 所在区域一致
自定义域名(可选)CDN 加速域名
区域配置
- 文件存储为全站统一配置,不按区域区分
- 各区域可在笔记配置、用户配置中限制上传格式与大小
验证是否生效
- 客户端发布带图笔记或更换头像,上传正常且图片可访问
- 若使用云存储:云控制台 Bucket 中出现新对象
常见问题
上传失败或 413检查功能与上传中大小限制与 Nginx client_max_body_size。
图片链接打不开local 模式确认静态目录可公网访问;云模式检查 Bucket 读权限。
切换存储方式后旧图失效历史 URL 仍指向旧位置;迁移需运维协助批量同步。
