# 宝塔面板 btcli 交互式命令行工具

> 宝塔面板（BT Panel）v11.5 新增交互式命令行工具 btcli，可在 SSH 终端快速管理网站、数据库与 FTP，适用于无法访问面板后台与脚本化运维场景。

# 宝塔面板命令行管理工具（btcli）

宝塔面板 11.5.0 版本新增了交互式命令行管理工具 `btcli`，可在 SSH 终端中快速管理网站、数据库和 FTP，无需登录面板后台。

:::info 版本要求
此功能从宝塔面板 11.5.0 版本开始支持。
:::

:::tip 工具区别
- **`bt` 命令：** 用于管理面板本身（修改密码、端口、重启服务等）
- **`btcli` 命令：** 用于管理面板中的资源（网站、数据库、FTP 等）
:::

## 启动工具

在 SSH 终端中输入以下命令启动交互式管理工具：

```bash
btcli
```

![启动 btcli](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121174330211.png)

## 功能模块

btcli 提供三大管理模块：

- **网站管理：** 创建、删除网站，查看网站列表
- **数据库管理：** 创建、删除数据库，查看数据库信息
- **FTP 管理：** 创建、删除 FTP 账户，查看 FTP 列表

![功能模块](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121174521327.png)

:::warning 前置条件
使用前需要确保对应的服务已安装：
- 网站管理需要安装 Nginx/Apache 和 PHP
- 数据库管理需要安装 MySQL
- FTP 管理需要安装 Pure-Ftpd
:::

:::tip 快速部署
可以配合【[宝塔面板自动部署网站](../practical-tutorials/install-panel-auto-deploy-website.md)】功能，在安装面板时自动安装所需环境。
:::

### 操作提示

在操作过程中如需中止，随时可以按 **Ctrl+C** 退出当前操作。

## 网站管理

在主菜单中选择 **网站管理** 选项。

![网站管理菜单](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121174854576.png)

### 1. 显示网站列表

选择选项 `1` 可以查看当前面板中所有已创建的网站。

![网站列表](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121180041348.png)

### 2. 添加 PHP 网站

选择选项 `2` 可以创建一个 PHP 网站，需要输入：

- **域名：** 网站访问域名
- **网站目录：** 网站文件存放路径
- **PHP 版本：** 选择 PHP 运行版本
- **备注：** 网站说明（可选）

![添加PHP网站](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121175339560.png)

### 3. 创建反向代理网站

选择选项 `3` 可以创建反向代理网站，需要输入：

- **域名：** 访问域名
- **反代地址：** 目标服务器地址
- **发送域名：** 转发的域名（可选）

![创建反向代理](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121180315459.png)

### 4. 删除网站

选择选项 `4` 可以删除指定网站。

:::danger 重要警告
删除网站会同时删除网站文件、数据库、FTP 等所有相关资源，操作不可恢复，请谨慎操作！
:::

![删除网站](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181040183.png)

## 数据库管理

在主菜单中选择 **数据库管理** 选项。

### 1. 显示数据库列表

选择选项 `1` 可以查看当前所有数据库。

![数据库列表](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181357151.png)

### 2. 添加数据库

选择选项 `2` 可以创建新数据库，需要输入：

- **数据库名：** 数据库标识名称
- **用户名：** 数据库访问用户
- **密码：** 数据库密码

![添加数据库](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181436701.png)

### 3. 删除数据库

选择选项 `3` 可以删除指定数据库。

:::warning 警告
删除数据库会清空所有数据，操作不可恢复！
:::

![删除数据库](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181530487.png)

### 4. 获取数据库密码

选择选项 `4` 可以查看指定数据库的访问密码。

![获取数据库密码](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181626991.png)

### 5. 获取 MySQL root 密码

选择选项 `5` 可以查看 MySQL 管理员（root）密码。

![获取root密码](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181648277.png)

## FTP 管理

在主菜单中选择 **FTP 管理** 选项。

### 1. 显示 FTP 列表

选择选项 `1` 可以查看所有 FTP 账户。

![FTP列表](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181733784.png)

### 2. 添加 FTP 账户

选择选项 `2` 可以创建新的 FTP 账户，需要输入：

- **FTP 用户名：** 登录账号
- **FTP 密码：** 登录密码
- **根目录：** FTP 可访问的根目录路径

![添加FTP账户](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181819271.png)

### 3. 删除 FTP 账户

选择选项 `3` 可以删除指定的 FTP 账户。

![删除FTP账户](https://docs.bt.cn/img/getting-started/btci-tool/image-20260121181903085.png)

## 使用场景

btci 命令行工具特别适合以下场景：

### 批量部署

通过编写脚本调用 btcli，可以快速批量创建网站、数据库等资源，提高部署效率。

### 远程管理

在无法访问面板 Web 界面的情况下（如防火墙限制），可以通过 SSH 使用 btci 进行管理。

### 自动化运维

结合 CI/CD 流程，使用 btcli 实现网站和数据库的自动化部署和管理。

### 快速操作

对于熟悉命令行的用户，btcli 提供了比 Web 界面更快捷的操作方式。

## 常见问题

### btci 命令不存在？

确保面板已升级到 11.5.0 或更高版本。升级后重启面板服务：

```bash
bt restart
```

### 提示服务未安装？

根据提示安装对应的服务：

- 网站管理：安装 Nginx/Apache 和 PHP
- 数据库管理：安装 MySQL
- FTP 管理：安装 Pure-Ftpd

可以在面板【软件商店】中搜索安装，或使用面板一键安装脚本。

### 操作被中断如何恢复？

重新执行 `btcli` 命令即可重新进入交互式菜单，之前的操作如果已完成则会保留。

## 与 bt 命令的对比

| 对比项 | bt 命令 | btci 命令 |
| --- | --- | --- |
| **功能定位** | 面板管理工具 | 资源管理工具 |
| **管理对象** | 面板设置、服务、密码等 | 网站、数据库、FTP 等 |
| **适用场景** | 配置和维护面板本身 | 管理网站和业务资源 |
| **交互方式** | 菜单式交互 | 菜单式交互 |
| **版本要求** | 所有版本 | 11.5.0+ |

:::tip 建议
两个工具各有侧重，建议结合使用：
- 使用 `bt` 管理面板配置和服务
- 使用 `btcli` 管理网站、数据库等业务资源
:::