跳到主要内容
版本：latest

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

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

版本要求

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

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

启动工具​

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

btcli

启动btci

功能模块​

btcli 提供三大管理模块：

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

功能模块

前置条件

使用前需要确保对应的服务已安装：

  • 网站管理需要安装 Nginx/Apache 和 PHP
  • 数据库管理需要安装 MySQL
  • FTP 管理需要安装 Pure-Ftpd
快速部署

可以配合【宝塔面板自动部署网站】功能，在安装面板时自动安装所需环境。

操作提示​

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

网站管理​

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

网站管理菜单

1. 显示网站列表​

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

网站列表

2. 添加 PHP 网站​

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

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

添加PHP网站

3. 创建反向代理网站​

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

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

创建反向代理

4. 删除网站​

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

重要警告

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

删除网站

数据库管理​

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

1. 显示数据库列表​

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

数据库列表

2. 添加数据库​

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

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

添加数据库

3. 删除数据库​

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

警告

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

删除数据库

4. 获取数据库密码​

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

获取数据库密码

5. 获取 MySQL root 密码​

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

获取root密码

FTP 管理​

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

1. 显示 FTP 列表​

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

FTP列表

2. 添加 FTP 账户​

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

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

添加FTP账户

3. 删除 FTP 账户​

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

删除FTP账户

使用场景​

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

批量部署​

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

远程管理​

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

自动化运维​

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

快速操作​

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

常见问题​

btci 命令不存在？​

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

bt restart

提示服务未安装？​

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

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

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

操作被中断如何恢复？​

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

与 bt 命令的对比​

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

两个工具各有侧重，建议结合使用：

  • 使用 bt 管理面板配置和服务
  • 使用 btcli 管理网站、数据库等业务资源