需完成插件安装、COS权限配置、存储桶对接及计划任务设定:一、安装腾讯云COS插件;二、创建同地域私有存储桶;三、通过CAM创建最小权限子用户并获取密钥;四、在插件中填写SecretId、SecretKey、Region、Bucket四项参数;五、添加定时备份任务并指定COS为目标;六、手动执行测试验证连通性与上传成功。

如果您希望将宝塔面板管理的网站与数据库文件自动备份至腾讯云COS,实现数据异地存储与安全冗余,则需完成插件安装、COS权限配置、存储桶对接及计划任务设定。以下是具体操作步骤:
一、安装腾讯云COS插件
该插件是宝塔与腾讯云COS通信的桥梁,提供API调用能力,使本地备份文件可上传至对象存储。未安装插件前,所有备份任务无法选择COS作为目标位置。
1、登录宝塔面板,在左侧菜单栏点击【软件商店】。
2、在搜索框中输入“腾讯云COS”,找到对应插件(版本号建议为5.4或以上)。
3、点击【安装】按钮,等待状态变为“已安装”。
二、创建腾讯云COS存储桶
存储桶是COS中用于存放文件的顶层容器,相当于一个独立命名空间;其区域(region)必须与服务器所在地域一致,以保障内网传输效率与访问稳定性。
1、登录腾讯云控制台,进入【对象存储 COS】服务页面。
2、点击【存储桶列表】→【创建存储桶】。
3、填写存储桶名称(仅支持小写字母、数字、短横线),选择所属地域(如:ap-beijing、ap-shanghai)。
4、访问权限选择私有读写,其他参数保持默认即可。
三、配置子用户及API密钥
为避免主账号密钥泄露引发全账户风险,应通过腾讯云访问管理(CAM)创建具备最小权限的子用户,并仅授予COS操作权限。
1、进入腾讯云【访问管理 CAM】→【用户】→【用户列表】→【新建用户】。
2、用户类型选择“自定义创建”,勾选“编程访问”。
3、在权限策略中,仅绑定系统策略QcloudAccessForCOSBatchRole。
4、创建完成后,在用户详情页复制SecretId与SecretKey,务必离线保存。
四、填写COS插件配置参数
插件需通过四项核心参数与COS服务建立可信连接,任一参数错误均会导致上传失败或连接超时。
1、在宝塔面板中打开【腾讯云COS】插件设置页。
2、依次填入以下信息:
- SecretId:上一步复制的子用户密钥ID
- SecretKey:上一步复制的子用户密钥内容
- Region:存储桶所属地域标识(如ap-guangzhou)
- Bucket:存储桶名称(不含后缀,如my-backup-2026)
3、点击【保存】,页面自动跳转至文件列表;若显示空白但无报错,可手动创建测试文件夹验证连通性。
五、创建定时备份计划任务
计划任务驱动备份动作执行,支持按日/周/月周期运行,且可指定保留份数防止COS空间被无效备份占满。
1、返回宝塔面板首页,点击【计划任务】→【添加计划任务】。
2、任务类型选择备份网站或备份数据库(可分别创建两个任务)。
3、设置执行周期(如每天凌晨2点),勾选需备份的具体网站或数据库名称。
4、备份到目标处选择腾讯云COS,填写保留备份数(推荐设为7)。
5、点击【添加任务】,状态显示“已启用”即表示配置成功。
六、手动触发测试验证
首次配置后必须执行一次手动运行,确认整个链路(本地打包→加密上传→COS写入→路径生成)是否完整通畅,避免依赖自动周期错过异常。
1、在计划任务列表中,找到刚添加的备份任务。
2、点击右侧【执行】按钮,观察状态栏是否由“执行中”变为“执行成功”。
3、立即登录腾讯云COS控制台,进入对应存储桶的/backup/目录(宝塔默认上传路径),确认出现以日期命名的压缩包文件。










