--- title: "宝塔面板 btcli 交互式命令行工具" description: "宝塔面板（BT Panel）v11.5 新增交互式命令行工具 btcli，可在 SSH 终端快速管理网站、数据库与 FTP，适用于无法访问面板后台与脚本化运维场景。" --- > Documentation Index > Fetch the complete documentation index at: https://docs.bt.cn/llms.txt > Use this file to discover all available pages before exploring further. # 宝塔面板 btcli 交互式命令行工具 ## 宝塔面板命令行管理工具（btcli） 宝塔面板 11.5.0 版本新增了交互式命令行管理工具 `btcli`，可在 SSH 终端中快速管理网站、数据库和 FTP，无需登录面板后台。 :::info 版本要求 此功能从宝塔面板 11.5.0 版本开始支持。 ::: :::tip 工具区别 - **`bt` 命令：** 用于管理面板本身（修改密码、端口、重启服务等） - **`btcli` 命令：** 用于管理面板中的资源（网站、数据库、FTP 等） ::: ## 启动工具 在 SSH 终端中输入以下命令启动交互式管理工具： ```bash btcli ``` ![启动 btcli](/img/getting-started/btci-tool/image-20260121174330211.png) ## 功能模块 btcli 提供三大管理模块： - **网站管理：** 创建、删除网站，查看网站列表 - **数据库管理：** 创建、删除数据库，查看数据库信息 - **FTP 管理：** 创建、删除 FTP 账户，查看 FTP 列表 ![功能模块](/img/getting-started/btci-tool/image-20260121174521327.png) :::warning 前置条件 使用前需要确保对应的服务已安装： - 网站管理需要安装 Nginx/Apache 和 PHP - 数据库管理需要安装 MySQL - FTP 管理需要安装 Pure-Ftpd ::: :::tip 快速部署 可以配合【[宝塔面板自动部署网站](/practical-tutorials/install-panel-auto-deploy-website)】功能，在安装面板时自动安装所需环境。 ::: ### 操作提示 在操作过程中如需中止，随时可以按 **Ctrl+C** 退出当前操作。 ## 网站管理 在主菜单中选择 **网站管理** 选项。 ![网站管理菜单](/img/getting-started/btci-tool/image-20260121174854576.png) ### 1. 显示网站列表 选择选项 `1` 可以查看当前面板中所有已创建的网站。 ![网站列表](/img/getting-started/btci-tool/image-20260121180041348.png) ### 2. 添加 PHP 网站 选择选项 `2` 可以创建一个 PHP 网站，需要输入： - **域名：** 网站访问域名 - **网站目录：** 网站文件存放路径 - **PHP 版本：** 选择 PHP 运行版本 - **备注：** 网站说明（可选） ![添加PHP网站](/img/getting-started/btci-tool/image-20260121175339560.png) ### 3. 创建反向代理网站 选择选项 `3` 可以创建反向代理网站，需要输入： - **域名：** 访问域名 - **反代地址：** 目标服务器地址 - **发送域名：** 转发的域名（可选） ![创建反向代理](/img/getting-started/btci-tool/image-20260121180315459.png) ### 4. 删除网站 选择选项 `4` 可以删除指定网站。 :::danger 重要警告 删除网站会同时删除网站文件、数据库、FTP 等所有相关资源，操作不可恢复，请谨慎操作！ ::: ![删除网站](/img/getting-started/btci-tool/image-20260121181040183.png) ## 数据库管理 在主菜单中选择 **数据库管理** 选项。 ### 1. 显示数据库列表 选择选项 `1` 可以查看当前所有数据库。 ![数据库列表](/img/getting-started/btci-tool/image-20260121181357151.png) ### 2. 添加数据库 选择选项 `2` 可以创建新数据库，需要输入： - **数据库名：** 数据库标识名称 - **用户名：** 数据库访问用户 - **密码：** 数据库密码 ![添加数据库](/img/getting-started/btci-tool/image-20260121181436701.png) ### 3. 删除数据库 选择选项 `3` 可以删除指定数据库。 :::warning 警告 删除数据库会清空所有数据，操作不可恢复！ ::: ![删除数据库](/img/getting-started/btci-tool/image-20260121181530487.png) ### 4. 获取数据库密码 选择选项 `4` 可以查看指定数据库的访问密码。 ![获取数据库密码](/img/getting-started/btci-tool/image-20260121181626991.png) ### 5. 获取 MySQL root 密码 选择选项 `5` 可以查看 MySQL 管理员（root）密码。 ![获取root密码](/img/getting-started/btci-tool/image-20260121181648277.png) ## FTP 管理 在主菜单中选择 **FTP 管理** 选项。 ### 1. 显示 FTP 列表 选择选项 `1` 可以查看所有 FTP 账户。 ![FTP列表](/img/getting-started/btci-tool/image-20260121181733784.png) ### 2. 添加 FTP 账户 选择选项 `2` 可以创建新的 FTP 账户，需要输入： - **FTP 用户名：** 登录账号 - **FTP 密码：** 登录密码 - **根目录：** FTP 可访问的根目录路径 ![添加FTP账户](/img/getting-started/btci-tool/image-20260121181819271.png) ### 3. 删除 FTP 账户 选择选项 `3` 可以删除指定的 FTP 账户。 ![删除FTP账户](/img/getting-started/btci-tool/image-20260121181903085.png) ## 使用场景 btcli 命令行工具特别适合以下场景： ### 批量部署 通过编写脚本调用 btcli，可以快速批量创建网站、数据库等资源，提高部署效率。 ### 远程管理 在无法访问面板 Web 界面的情况下（如防火墙限制），可以通过 SSH 使用 btcli 进行管理。 ### 自动化运维 结合 CI/CD 流程，使用 btcli 实现网站和数据库的自动化部署和管理。 ### 快速操作 对于熟悉命令行的用户，btcli 提供了比 Web 界面更快捷的操作方式。 ## 常见问题 ### btcli 命令不存在？ 确保面板已升级到 11.5.0 或更高版本。升级后重启面板服务： ```bash bt restart ``` ### 提示服务未安装？ 根据提示安装对应的服务： - 网站管理：安装 Nginx/Apache 和 PHP - 数据库管理：安装 MySQL - FTP 管理：安装 Pure-Ftpd 可以在面板【软件商店】中搜索安装，或使用面板一键安装脚本。 ### 操作被中断如何恢复？ 重新执行 `btcli` 命令即可重新进入交互式菜单，之前的操作如果已完成则会保留。 ## 与 bt 命令的对比 | 对比项 | bt 命令 | btcli 命令 | | --- | --- | --- | | **功能定位** | 面板管理工具 | 资源管理工具 | | **管理对象** | 面板设置、服务、密码等 | 网站、数据库、FTP 等 | | **适用场景** | 配置和维护面板本身 | 管理网站和业务资源 | | **交互方式** | 菜单式交互 | 菜单式交互 | | **版本要求** | 所有版本 | 11.5.0+ | :::tip 建议 两个工具各有侧重，建议结合使用： - 使用 `bt` 管理面板配置和服务 - 使用 `btcli` 管理网站、数据库等业务资源 ::: Source: https://docs.bt.cn/getting-started/btcli-interactive-tool/index.mdx