多台服务器怎么批量执行命令、分发文件？宝塔节点分发管理功能教程

多台服务器要维护时，不用再逐台登录重复操作。宝塔面板【节点管理】里的【分发管理】功能，可以一次性勾选多台节点批量执行命令、脚本，也能把文件或整个目录从一台节点批量发到其他节点，任务还能存成模板复用。

分发管理能做什么？

宝塔的节点管理用单个面板统一管理多台服务器，除状态监控、负载均衡、主从复制、文件互传外，还提供分发管理能力，专注两件事：

• 批量执行命令：对多节点批量执行命令或脚本，用于日志清理、系统健康检查、节点状态信息收集、软件批量更新、配置批量修改等。
• 文件批量分发：网站程序更新后，无需逐台登录上传，从任意节点发起文件传输、批量发送到多个目标节点，保持文件一致性。

前置准备：先把服务器添加成节点

用分发管理前，需先把服务器加入节点管理。进入【节点管理】-【添加节点】：

节点添加支持三种方式：

添加方式	说明	推荐度
API 密钥	使用面板 API 接口添加	⭐⭐⭐ 推荐
APP 插件	通过宝塔 APP 扫码授权	⭐⭐
SSH 连接	使用 SSH 账号密码添加	⭐

注意：API 密钥方式需在目标面板把当前服务器 IP 加入 API 白名单；SSH 方式默认用 root 用户，需填写正确的 root 账户信息；APP 插件若不弹窗授权，建议改用 API 方式。

功能一：批量执行命令

1. 进入分发管理并勾选节点

点击【分发管理】进入管理界面：

勾选需要执行命令的节点，点击【添加任务】。

2. 配置执行命令

选择【执行命令】-【自定义命令】-【Shell 脚本】，输入脚本内容，或从脚本库选择。官方文档给了一个收集服务器 CPU、内存、磁盘信息的 Shell 脚本示例（读取 CPU 核数与使用率、用 free -h 取内存、用 df -h 取磁盘占用），可直接套用或改写成自己的维护脚本。

3. 执行并查看结果

填写完脚本内容后点【确认】保存任务，再点【执行】等待完成。任务执行完成后，点【详情】查看各节点的执行结果和收集到的系统信息：

保存为模板复用

常用任务可点【另存为模板】，输入模板名称和描述保存；下次在【任务模板】里选择已保存的模板、添加到任务列表、选好执行节点后直接执行。

功能二：文件分发

网站内容在一台节点更新后，要同步到其他节点时用文件分发最方便。

1. 进入【分发管理】，选择目标节点，点【添加任务】，选【文件分发】。
2. 配置分发参数：源节点（要获取文件的源服务器）、文件路径（文件的绝对路径，或点文件夹图标选择）、目标路径（传输到目标节点的绝对路径）。
3. 点【确认】添加任务，再点【执行】开始传输，等待完成即可查看传输结果。

文件分发支持传输单个文件或整个目录；源节点可以是任意已添加的节点；目标路径不存在时会自动创建。

文件分发任务同样可以保存为模板，方便后续网站更新时快速同步。

执行日志怎么查？

所有任务执行都会记录在执行日志中，可随时查看历史执行记录，日志包含任务名称和类型、执行时间、目标节点、执行状态（成功/失败）和执行结果详情。

本文操作步骤以宝塔官方文档《宝塔面板节点分发管理功能教程》为准。