宝塔面板备份至云存储需先安装并正确配置插件,再在计划任务中选择对应备份项;阿里云盘须填refresh_token,腾讯云cos/七牛云须严格匹配region、bucket名及密钥地域,且必须通过测试连接验证。

宝塔面板可以直接把网站和数据库备份到阿里云盘、腾讯云COS、七牛云等云存储,但必须分两步走:先装对应插件并填对密钥,再在计划任务里选“备份到XXX云盘”——跳过插件配置这步,备份任务会静默失败,连错误提示都不给。
阿里云盘插件要填对 Token,不是账号密码
阿里云盘不走标准 OAuth 流程,宝塔插件只认 refresh_token。这个值必须从浏览器开发者工具里手动复制:
- 登录阿里云盘后按
F12→ 切到【Application】标签 → 展开【Local Storage】→ 找https://www.aliyundrive.com下的refresh_token项 → 右键复制值 - 粘贴进宝塔插件的【设置API】框,别填错位置;填错会导致上传时卡在“准备中”,日志里只显示
login failed -
是否使用系统路径开关影响最终存放位置:关掉就传到云盘根目录,打开则进系统/备份文件夹(部分用户反馈开启后上传失败,建议先关着测试)
腾讯云COS/七牛云要核对 Region 和 Bucket 名大小写
COS 的 region(如 ap-beijing)和 Bucket 名必须和腾讯云控制台里显示的**完全一致**,包括中划线、大小写、前后缀:
- 错填成
ap_beijing或mybucket(实际是mybucket-1250000000)会导致连接测试通过但上传失败,报错403 Forbidden或InvalidBucketName - 七牛云的 AK/SK 要从【个人中心 → 密钥管理】拿,不是对象存储控制台里的“空间密钥”;创建空间时选的地域(如
z0华东)必须和插件里填的zone匹配 - 所有插件保存设置后,务必点一次【测试连接】,成功才继续下一步——很多问题其实卡在这一步没验证
计划任务里选“备份到云盘”前,得确认插件已启用且权限正常
插件安装完只是静态文件,不等于服务已运行。常见断点:
- 插件设置页打不开?可能是面板 SSL 证书异常或插件进程崩溃,执行
bt 16重启面板试试 - 任务执行后日志为空或只写“开始备份”,说明插件未真正挂载云盘路径,此时需检查服务器时间是否准确(误差 >5 分钟会导致 COS/Tencent 签名失效)
- 备份任务类型选
备份网站或备份数据库,在“备份到”下拉菜单里才能看到已启用的云盘选项;如果列表为空,回去重进插件设置页点一次【保存】触发初始化
最常被忽略的是:云存储插件本身不负责打包逻辑,它只上传已存在的 .zip 或 .sql 文件。所以如果你改过默认备份路径(比如设成 /mnt/aliyun-backup),插件可能根本找不到文件——它默认只扫 /www/backup/ 下的产出。










