# 宝塔面板命令行工具使用指南

> 宝塔面板（BT Panel）提供强大的 bt 命令行工具，可在 SSH 终端快速完成面板重启、密码修改、端口调整、防火墙释放、账号重置与面板修复等运维操作，无需登录后台。

# 宝塔面板命令行工具使用指南

宝塔面板提供了强大的命令行工具 `bt`，可在 SSH 终端中快速执行常用的面板管理操作，无需登录面板后台。

:::tip 快速开始
**第一步：** 通过 SSH 连接到服务器  
**第二步：** 在终端中输入 `bt` 命令并按回车  
**第三步：** 根据菜单提示，输入对应的数字编号执行操作
:::

## 使用方法

**首先**，通过 SSH 连接到您的服务器，然后在终端中输入以下命令：

```bash
bt
```

执行 `bt` 命令后，会显示如下交互式菜单：

```
==================================宝塔面板命令行====================================
(1) 重启面板服务                  (8) 改面板端口                                   |
(2) 停止面板服务                  (9) 清除面板缓存                                 |
(3) 启动面板服务                  (10) 清除登录限制                                |
(4) 重载面板服务                  (11) 设置是否开启IP + User-Agent验证             |
(5) 修改面板密码                  (12) 取消域名绑定限制                            |
(6) 修改面板用户名                (13) 取消IP访问限制                              |
(7) 强制修改MySQL密码             (14) 查看面板默认信息                            |
(22) 显示面板错误日志             (15) 清理系统垃圾                                |
(23) 关闭BasicAuth认证            (16) 修复面板(安装当前版本的最新bug修复包)       |
(24) 关闭动态口令认证             (17) 设置日志切割是否压缩                        |
(25) 设置是否保存文件历史副本     (18) 设置是否自动备份面板                        |
(26) 关闭面板ssl                  (19) 关闭面板登录地区限制                        |
(28) 修改面板安全入口             (29) 取消访问设备验证                            |
(30) 取消访问UA验证               (32) 开启/关闭【80、443】端口访问面板            |
(34) 更新面板(更新到最新版本)                                                      |
(0) 取消                                                                           |
====================================================================================
```

输入对应的数字编号并按回车即可执行相应操作。

## 常用命令说明

### 面板服务管理

| 命令 | 功能 | 说明 |
| --- | --- | --- |
| `bt 1` | 重启面板服务 | 重启宝塔面板服务 |
| `bt 2` | 停止面板服务 | 停止宝塔面板服务 |
| `bt 3` | 启动面板服务 | 启动宝塔面板服务 |
| `bt 4` | 重载面板服务 | 重载面板配置，不中断服务 |

### 账户与密码

| 命令 | 功能 | 说明 |
| --- | --- | --- |
| `bt 5` | 修改面板密码 | 修改面板登录密码 |
| `bt 6` | 修改面板用户名 | 修改面板登录用户名 |
| `bt 7` | 强制修改MySQL密码 | 强制重置 MySQL root 密码 |
| `bt 14` | 查看面板默认信息 | 查看面板地址、用户名、密码等信息 |

### 访问设置

| 命令 | 功能 | 说明 |
| --- | --- | --- |
| `bt 8` | 改面板端口 | 修改面板访问端口 |
| `bt 28` | 修改面板安全入口 | 修改面板安全入口路径 |
| `bt 32` | 开启/关闭 80、443 端口访问面板 | 控制是否允许通过 80/443 端口访问面板 |

### 安全设置

| 命令 | 功能 | 说明 |
| --- | --- | --- |
| `bt 10` | 清除登录限制 | 清除登录失败次数限制 |
| `bt 11` | 设置 IP + User-Agent 验证 | 开启或关闭 IP 和 UA 双重验证 |
| `bt 12` | 取消域名绑定限制 | 取消面板域名绑定 |
| `bt 13` | 取消 IP 访问限制 | 取消面板 IP 访问白名单限制 |
| `bt 19` | 关闭面板登录地区限制 | 关闭基于地区的登录限制 |
| `bt 23` | 关闭 BasicAuth 认证 | 关闭 HTTP 基础认证 |
| `bt 24` | 关闭动态口令认证 | 关闭二次验证（2FA） |
| `bt 26` | 关闭面板 SSL | 关闭面板 HTTPS 访问 |
| `bt 29` | 取消访问设备验证 | 取消设备绑定验证 |
| `bt 30` | 取消访问 UA 验证 | 取消 User-Agent 验证 |

### 维护与修复

| 命令 | 功能 | 说明 |
| --- | --- | --- |
| `bt 9` | 清除面板缓存 | 清除面板运行缓存 |
| `bt 15` | 清理系统垃圾 | 清理系统临时文件和日志 |
| `bt 16` | 修复面板 | 安装当前版本的最新 bug 修复包 |
| `bt 22` | 显示面板错误日志 | 查看面板错误日志 |
| `bt 34` | 更新面板 | 更新面板到最新版本 |
| `bt 36` | 磁盘清理工具 | 扫描并清理日志、缓存、临时文件 |

### 其他设置

| 命令 | 功能 | 说明 |
| --- | --- | --- |
| `bt 17` | 设置日志切割是否压缩 | 控制日志切割后是否压缩 |
| `bt 18` | 设置是否自动备份面板 | 开启或关闭面板自动备份 |
| `bt 25` | 设置是否保存文件历史副本 | 控制文件编辑时是否保存历史版本 |

## 快捷命令

`bt` 命令支持直接在终端执行，无需进入交互菜单：

```bash
bt 14    # 查看面板默认信息
bt 1     # 重启面板
bt 16    # 修复面板
bt 34    # 更新面板
bt 5     # 修改面板密码
```

## 常见使用场景

### 忘记面板密码

**操作步骤：**
1. SSH 连接到服务器
2. 输入 `bt` 命令进入菜单
3. 输入编号 `5` 并按回车
4. 按提示输入新密码

或直接执行：
```bash
bt 5
```

### 忘记面板地址或安全入口

**操作步骤：**
1. SSH 连接到服务器
2. 输入 `bt` 命令进入菜单
3. 输入编号 `14` 并按回车

或直接执行：
```bash
bt 14
```

会显示完整的面板访问地址、用户名和密码。

### 面板无法访问

**操作步骤：**
1. SSH 连接到服务器
2. 输入 `bt` 命令进入菜单
3. 依次尝试以下操作：

```bash
# 1. 先尝试重启面板（输入编号 1）
bt 1

# 2. 如果还是无法访问，查看错误日志（输入编号 22）
bt 22

# 3. 尝试修复面板（输入编号 16）
bt 16
```

### 被安全设置锁定

**操作步骤：**
1. SSH 连接到服务器
2. 输入 `bt` 命令进入菜单
3. 根据情况选择对应编号：

```bash
# 清除登录限制（输入编号 10）
bt 10

# 取消 IP 访问限制（输入编号 13）
bt 13

# 关闭二次验证（输入编号 24）
bt 24
```

## 磁盘清理工具（bt 36）

:::info 新功能
该功能在宝塔面板最新版本中新增，用于解决磁盘空间占用过高的问题。
:::

`bt 36` 是一个专门的磁盘清理工具，可以扫描并清理服务器上的日志、缓存和临时文件，帮助释放磁盘空间。清理操作不会影响正常项目运行。

### 进入磁盘清理工具

```bash
bt
```

执行后会显示菜单，输入 `36` 进入磁盘清理工具：

![磁盘清理菜单](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205094424867.png)

:::tip 提示
首次进入需要手动输入 `4` 进入磁盘清理选项。
:::

![选择磁盘清理](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095109366.png)

### 磁盘清理功能说明

磁盘清理工具提供三个主要功能：

![功能菜单](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095232868.png)

#### 1. 扫描磁盘空间

扫描服务器磁盘，分析可清理的文件类型和大小。

**操作步骤：**
1. 在磁盘清理菜单中输入 `1`
2. 等待扫描完成

**扫描内容包括：**
- 面板日志文件
- 系统日志文件
- 缓存文件
- 临时文件

![扫描结果](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095310917.png)

:::info 说明
扫描的内容不包括网站文件和项目数据，清理这些文件不会影响正常业务运行。
:::

#### 2. 查看扫描结果

查看上一次扫描得到的日志和缓存统计结果。

**操作步骤：**
1. 在磁盘清理菜单中输入 `2`
2. 查看扫描结果详情

![查看结果](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095430227.png)

#### 3. 清理日志/缓存/临时文件

根据扫描结果清理指定类型的文件。

:::warning 前提条件
执行清理前必须先执行"扫描磁盘空间"操作，否则无法清理。
:::

**操作步骤：**
1. 在磁盘清理菜单中输入 `3`
2. 根据扫描结果，选择要清理的项目：
   - 输入对应的编号清理指定类型
   - 输入 `all` 清理所有可清理内容

![开始清理](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095450884.png)

**清理示例：**

![清理过程](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095613958.png)

![清理完成](https://docs.bt.cn/img/getting-started/bt-command-line-tool/image-20260205095627168.png)

### 使用场景

**适合使用 bt 36 的情况：**

1. **磁盘空间不足**
   - 磁盘使用率超过 80%
   - 需要快速释放空间
   - 不确定哪些文件占用空间

2. **定期维护**
   - 服务器运行时间较长
   - 日志文件累积过多
   - 定期清理系统缓存

3. **排查问题**
   - 查找磁盘占用原因
   - 分析可清理的文件类型
   - 了解各类日志的大小

### 清理频率建议

- **高负载服务器**：建议每周清理一次
- **普通服务器**：建议每月清理一次
- **低负载服务器**：建议每季度清理一次

:::tip 最佳实践
建议先扫描查看可清理的空间大小，再决定是否清理。如果可清理空间较小（小于 100MB），可以暂不清理。
:::

## 注意事项

- 执行 `bt` 命令需要 **root 权限**
- 修改端口、安全入口后，需要在防火墙中放行新端口
- 关闭安全验证功能会降低面板安全性，建议问题解决后重新开启