资源存储配置
📅 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 服务 [源码]。
操作步骤
- 进入「功能 → 系统功能 → 资源存储配置」。
- 选择存储方式,填写对应凭证与资源地址。
- 点击「提交」保存。
- 上传一张测试图片,确认前台可正常加载。
操作步骤
- 进入「功能 → 系统功能 → 资源存储配置」。
- 选择存储方式并填写对应凭证与资源地址。
- 点击「提交」保存。
- 上传一张测试图片,确认前台可正常加载。
适用场景与建议
- 单机小站使用本地存储即可。
- 多机部署或流量较大时使用对象存储 + CDN。
注意事项
- 切换存储方式不会自动迁移已上传资源,使用中切换会造成新旧资源分散。
- 云存储密钥属于敏感信息,不要写进公开文档或截图。
- 资源地址填写错误会导致前台图片全部无法访问。