将一键部署包安装到指定网站

将选中的一键部署软件包（内置或自定义）安装到指定网站。

POST

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

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

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
actionSetupPackagerequired
具体操作名称。
dnamestringrequired
软件包名称（通过 GetList 获取，如 ThinkPHP-5.0、discuz-X3.4）
site_namestringrequired
目标网站域名
project_typeoptionalstring
项目类型，默认 php；Java 项目需传 java

Returns

default

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

JSON

statusoptionalboolean
true 部署成功
admin_usernameoptionalstring
管理员用户名（如有）
admin_passwordoptionalstring
管理员密码（如有）
success_urloptionalstring
部署完成后的访问路径

各操作详细说明

SetupPackageaction=SetupPackage将一键部署包安装到指定网站

将选中的一键部署软件包（内置或自定义）安装到指定网站。

路由：POST /deployment
action：SetupPackage

输入参数

参数名称	必选	类型	描述
action	是	String	固定值 `SetupPackage`
dname	是	String	软件包名称（通过 `GetList` 获取，如 `ThinkPHP-5.0`、`discuz-X3.4`）
site_name	是	String	目标网站域名
project_type	否	String	项目类型，默认 `php`；Java 项目需传 `java`

输出参数

参数名称	类型	描述
status	Boolean	`true` 部署成功
msg.admin_username	String	管理员用户名（如有）
msg.admin_password	String	管理员密码（如有）
msg.success_url	String	部署完成后的访问路径

示例

部署 PHP 框架（ThinkPHP）

POST /deployment HTTP/1.1
Host: 192.168.168.213:8888
Content-Type: application/x-www-form-urlencoded

action=SetupPackage&dname=ThinkPHP-5.0&site_name=testapi.bt.local

{"status": true, "msg": {"admin_username": "", "admin_password": "", "success_url": "/index.php"}}

框架类包部署后直接可访问，success_url 指向入口文件。

部署 CMS（Discuz）

action=SetupPackage&dname=discuz-X3.4&site_name=testapi.bt.local

{"status": true, "msg": {"admin_username": "", "admin_password": "", "success_url": ""}}

CMS 类包 success_url 为空，需访问网站域名进入 Web 安装向导完成数据库配置。