资源存储配置

📅 2026-11-21 👁️ 0

资源存储配置

资源存储配置用于选择上传图片、文件的存放位置,支持本地与多种云存储。

入口路径

后台顶部菜单 →「功能」→「系统功能」→「资源存储配置」。实际地址:/system/plugin/system/storage,需要管理员权限(canAdmin)。

功能说明

页面提供存储方式选择与「资源地址」配置,支持本地存储、阿里云、腾讯云、七牛云、又拍云、谷歌云、亚马逊 S3、Cloudflare R2、FTP、SFTP。

界面截图

资源存储配置

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
存储方式 决定新上传资源的保存位置 单选 10 项:本地存储(默认 [源码])、阿里云、腾讯云、七牛云、又拍云、谷歌云、亚马逊S3、Cloudflare R2、FTP、SFTP 单机小站用本地;多机或大流量用对象存储 非 VIP 不可选;切换不会迁移旧资源,不建议使用中切换
资源地址 对外访问的资源域名 文本,实测预填本站地址 [实测] 用云存储时填对应 CDN/Bucket 域名 填错会导致前台图片全部无法访问
本地存档 云存储时是否保留本地副本 单选:不保留 / 保留;实测「不保留」[实测] 需要本地备份时选保留 仅存储方式非本地时显示
各云存储凭证 连接云服务的参数 随存储方式联动,见下方详解 按云厂商控制台获取 密钥属敏感信息

配置项详解

存储方式与条件字段

出现条件:存储方式始终显示;本地存档仅非本地存储时显示 [源码]。

按所选存储方式,下方出现对应凭证字段:

存储方式 必填字段
本地存储 无(默认)
阿里云 节点 Endpoint、AccessKeyId、AccessKeySecret、存储桶名称
腾讯云 SecretId、SecretKey、存储桶地址
七牛云 AccessKey、SecretKey、存储桶名称、存储区域(7 项:华东 z0/华北 z1/华南 z2/北美 na0/东南亚 as0/华东-浙江2/雾存储华东区)
又拍云 操作员、密码、存储服务名称
谷歌云 项目ID、存储桶名称、密钥 JSON
亚马逊S3 区域(如 us-east-1)、AccessKey、SecretKey、存储桶
Cloudflare R2 Endpoint、AccessKey、SecretKey、存储桶
FTP IP、端口、用户名、密码、上传根目录
SFTP(SSH) IP、端口、用户名、密码或私钥(.crt/.pem/.key)、上传根目录

推荐值:国内站用阿里云/腾讯云 OSS + CDN;海外站用 S3/R2。

填错后果:凭证或区域错误会导致上传失败;切换存储方式不自动同步已上传资源,会造成新旧资源分散。

FTP 注意事项

源码提示:宝塔面板自带的 PureFtp 无法正常使用,需自行安装其它 FTP 服务 [源码]。

操作步骤

  1. 进入「功能 → 系统功能 → 资源存储配置」。
  2. 选择存储方式,填写对应凭证与资源地址。
  3. 点击「提交」保存。
  4. 上传一张测试图片,确认前台可正常加载。

操作步骤

  1. 进入「功能 → 系统功能 → 资源存储配置」。
  2. 选择存储方式并填写对应凭证与资源地址。
  3. 点击「提交」保存。
  4. 上传一张测试图片,确认前台可正常加载。

适用场景与建议

  • 单机小站使用本地存储即可。
  • 多机部署或流量较大时使用对象存储 + CDN。

注意事项

  • 切换存储方式不会自动迁移已上传资源,使用中切换会造成新旧资源分散。
  • 云存储密钥属于敏感信息,不要写进公开文档或截图。
  • 资源地址填写错误会导致前台图片全部无法访问。

相关文档