Skip to content

文件存储 ​

配置用户上传的图片、视频等文件的保存位置,支持服务器本地或主流云对象存储。

配置用户上传的图片、视频等文件的保存位置,支持服务器本地或主流云对象存储。

系统设置 → 系统配置 → 文件存储文件存储
  • 若选云存储:已在云厂商创建 Bucket 并获取访问密钥
  • 站点系统配置读写权限
  • 视频水印功能额外要求服务器安装 ffmpeg

本地存储(local)

  • 适用:小规模部署、内网测试
  • 文件保存在应用服务器磁盘,需自行备份与扩容
  • 通过站点域名下的静态路径访问,依赖反向代理配置

云存储

页面若提供「本地备份」选项,可在云存储为主的同时保留一份本地副本。

存储类型腾讯云 COS / 阿里云 OSS / 七牛云等
AccessKey / SecretKey必填云账号 API 密钥
Bucket 名称必填存储桶
地域 / Endpoint必填与 Bucket 所在区域一致
自定义域名(可选)CDN 加速域名

区域配置

  • 文件存储为全站统一配置,不按区域区分
  • 各区域可在笔记配置、用户配置中限制上传格式与大小

验证是否生效

  • 客户端发布带图笔记或更换头像,上传正常且图片可访问
  • 若使用云存储:云控制台 Bucket 中出现新对象

常见问题

上传失败或 413检查功能与上传中大小限制与 Nginx client_max_body_size。
图片链接打不开local 模式确认静态目录可公网访问;云模式检查 Bucket 读权限。
切换存储方式后旧图失效历史 URL 仍指向旧位置;迁移需运维协助批量同步。

灵萌 Lingmeng 使用手册