宝塔面板官方文档

备份指定 MySQL 数据库

备份指定数据库，生成 .sql.gz 文件存入面板备份目录。

POST

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

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

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
actionToBackuprequired
具体操作名称。
idintegerrequired
数据库在 databases SQLite 表中的 ID
sidintegerrequired
服务器 ID，0 = 本地

Returns

default

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

JSON

statusoptionalboolean
请求结果，true 表示成功
msgoptionalstring
提示信息

各操作详细说明

ToBackupaction=ToBackup备份指定 MySQL 数据库

备份指定数据库，生成 .sql.gz 文件存入面板备份目录。

路由：POST /database
action：ToBackup

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `ToBackup`
id	是	Integer	数据库在 `databases` SQLite 表中的 ID
sid	是	Integer	服务器 ID，`0` = 本地

示例

POST /database HTTP/1.1
Content-Type: application/x-www-form-urlencoded

action=ToBackup&id=1&sid=0

输出参数

参数名称	类型	描述
status	Boolean	请求结果，`true` 表示成功
msg	String	提示信息

{"status": true, "msg": "备份成功!"}

备份指定 MySQL 数据库

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

Response example

{
  "status": true,
  "msg": "备份成功!"
}