宝塔面板官方文档

设置自动备份任务的配置

为网站或数据库设置自动备份计划任务。任务不存在时自动创建，已存在时更新状态。

POST

https://your-panel.example.com:8888/crontab

更新于 2026年7月10日查看 Markdown

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
actionset_auto_configrequired
具体操作名称。
namestringrequired
"mysql" 数据库备份 / "site" 网站备份
statusstringrequired
"1" 开启 / "0" 关闭
houroptionalstring
执行时间（时）
minuteoptionalstring
执行时间（分）
saveoptionalstring
保留份数
backupTooptionalstring
备份目标

Returns

default

接口响应，业务状态见下方详细说明。

各操作详细说明

set_auto_configaction=set_auto_config设置自动备份任务的配置

为网站或数据库设置自动备份计划任务。任务不存在时自动创建，已存在时更新状态。

路由：POST /crontab
action：set_auto_config

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `set_auto_config`
name	是	String	`"mysql"` 数据库备份 / `"site"` 网站备份
status	是	String	`"1"` 开启 / `"0"` 关闭
hour	否	String	执行时间（时）
minute	否	String	执行时间（分）
save	否	String	保留份数
backupTo	否	String	备份目标

注意：name=site 时如果任务已存在，set_status 方法有 bug（硬编码查 mysql 任务），可能导致设置失败。

示例

设置 MySQL 自动备份

{"status": true, "msg": "设置成功！"}

设置自动备份任务的配置

curl --request POST \
  --url "https://your-panel.example.com:8888/crontab" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "action=set_auto_config" \
  --data-urlencode "name=<name>" \
  --data-urlencode "status=<status>"

Response example

{
  "status": true,
  "msg": "设置成功！"
}