宝塔面板博客官方技术博客
宝塔面板

宝塔面板 btcli 命令怎么用?SSH 里管理网站、数据库、FTP 的交互式工具

宝塔面板从 11.5.0 版本开始新增了一个交互式命令行工具 btcli:SSH 登录服务器后输入 btcli,就能在终端里创建、删除网站、数据库和 FTP 账户,全程不用登录面板后台。它和 bt 命令是两回事——bt 管面板本身,btcli 管面板里的资源。

btcli 和 bt 命令有什么区别

一句话区分:bt 管面板,btcli 管资源。

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

日常可以结合使用:用 bt 维护面板配置和服务,用 btcli 管理网站、数据库等业务资源。

btcli 怎么启动

通过 SSH 登录服务器后,在终端输入:

btcli

回车后进入交互式菜单。操作过程中随时按 Ctrl+C 退出当前操作。

在 SSH 终端输入 btcli 启动交互式管理工具

三大功能模块

btcli 主菜单提供三个管理模块:

btcli 主菜单,提供网站管理、数据库管理、FTP 管理三个模块

  • 网站管理:创建、删除网站,查看网站列表;
  • 数据库管理:创建、删除数据库,查看数据库信息;
  • FTP 管理:创建、删除 FTP 账户,查看 FTP 列表。

使用前需要确保对应服务已安装:网站管理需要 Nginx/Apache 和 PHP,数据库管理需要 MySQL,FTP 管理需要 Pure-Ftpd。缺哪个,就到面板软件商店搜索安装。

网站管理:创建、删除网站

在主菜单选择「网站管理」后,有四个选项:

  1. 显示网站列表:查看当前面板所有已创建的网站。
  2. 添加 PHP 网站:依次输入域名、网站目录、PHP 版本、备注(可选)。
  3. 创建反向代理网站:输入域名、反代地址(目标服务器地址)、发送域名(可选)。
  4. 删除网站:删除指定网站。

btcli 添加 PHP 网站,需输入域名、网站目录、PHP 版本、备注

删除网站会同时删除网站文件、数据库、FTP 等所有相关资源,操作不可恢复,删除前务必谨慎确认。

数据库管理:创建、删除、查密码

在主菜单选择「数据库管理」后,有五个选项:

  1. 显示数据库列表:查看当前所有数据库。
  2. 添加数据库:输入数据库名、用户名、密码。
  3. 删除数据库:删除指定数据库(会清空所有数据,不可恢复)。
  4. 获取数据库密码:查看指定数据库的访问密码。
  5. 获取 MySQL root 密码:查看 MySQL 管理员(root)密码。

FTP 管理:创建、删除账户

在主菜单选择「FTP 管理」后,有三个选项:

  1. 显示 FTP 列表:查看所有 FTP 账户。
  2. 添加 FTP 账户:输入 FTP 用户名、密码、根目录(FTP 可访问的根目录路径)。
  3. 删除 FTP 账户:删除指定的 FTP 账户。

btcli 适合哪些场景

  • 批量部署:写脚本调用 btcli,批量创建网站、数据库等资源,提高部署效率;
  • 远程管理:无法访问面板 Web 界面时(比如防火墙限制),通过 SSH 用 btcli 管理;
  • 自动化运维:结合 CI/CD 流程,用 btcli 实现网站和数据库的自动化部署管理;
  • 快速操作:熟悉命令行的用户,btcli 比 Web 界面更快捷。

常见问题

输入 btcli 提示命令不存在? 说明面板版本低于 11.5.0,先升级到 11.5.0 或更高版本,升级后执行 bt restart 重启面板服务再重试。

提示服务未安装? 根据提示安装对应服务:网站管理装 Nginx/Apache 和 PHP,数据库管理装 MySQL,FTP 管理装 Pure-Ftpd,到面板软件商店搜索安装即可。

操作被中断怎么恢复? 重新执行 btcli 命令即可重新进入交互式菜单,之前已完成的操作会保留。

常见问题

btcli 和 bt 命令有什么区别?

两者都是 SSH 终端里的交互式菜单,但分工不同:bt 命令用于管理面板本身(改密码、改端口、重启面板服务等),btcli 命令用于管理面板中的资源(创建/删除网站、数据库、FTP 账户)。btcli 从宝塔面板 11.5.0 版本开始支持。

btcli 怎么启动?

SSH 登录服务器后,在终端输入 btcli 并按回车,就会进入交互式菜单。主菜单提供网站管理、数据库管理、FTP 管理三个模块,按数字选择即可;操作过程中随时按 Ctrl+C 退出当前操作。

用 btcli 管理网站需要先装什么?

使用前需要确保对应服务已安装:网站管理需要安装 Nginx/Apache 和 PHP;数据库管理需要安装 MySQL;FTP 管理需要安装 Pure-Ftpd。如果提示服务未安装,到面板软件商店搜索安装对应服务即可。

btcli 删除网站会同时删掉数据库吗?

会。btcli 里删除网站会同时删除网站文件、数据库、FTP 等所有相关资源,且操作不可恢复,删除前务必谨慎确认。删除数据库同样会清空所有数据、不可恢复。

输入 btcli 提示命令不存在怎么办?

说明面板版本低于 11.5.0。先把面板升级到 11.5.0 或更高版本,升级后在 SSH 里执行 bt restart 重启面板服务,再重新执行 btcli 即可。