前言作为运维或多服务器使用者你是否遇到过这样的困扰——手里有多台云服务器每台都要单独打开SSH工具输入IP、端口、密码登录宝塔面板也要逐个输入地址访问切换来切换去繁琐又耗时今天就分享一套实操方案教你搭建多台SSH与宝塔面板统一管理平台一次登录、集中操作彻底解放双手让运维效率直接拉满本文全程实操适配CentOS、Ubuntu等主流Linux系统无论是新手还是老运维跟着步骤走都能快速上手原创首发严禁转载建议收藏备用一、搭建前准备必看1.1 环境要求一台核心管理服务器建议2核4G及以上系统CentOS 7/8、Ubuntu 20.04/22.04确保网络通畅能访问外网和其他被控服务器多台被控服务器需安装SSH服务、宝塔面板系统无强制要求只要能与管理服务器互通所有服务器关闭防火墙限制或开放对应端口下文会详细说明管理服务器需安装Python 3.6大部分Linux系统默认自带无则手动安装。1.2 核心工具选择本次统一管理平台核心采用「Ansible Shell脚本 宝塔API」组合优势如下Ansible轻量级自动化运维工具无需在被控服务器安装客户端通过SSH协议实现批量管理上手简单Shell脚本实现宝塔面板的集中调用、状态监控简化重复操作宝塔API宝塔面板自带的接口可实现远程登录、站点管理、插件操作等无需手动打开网页。补充无需额外搭建复杂的Web管理界面通过终端和简单配置即可实现多台SSH宝塔的统一管控兼顾轻便性和实用性。二、分步搭建从基础配置到统一管控找源码就来会员源码网第一步管理服务器基础配置核心步骤先对管理服务器进行初始化配置确保能正常连接所有被控服务器这是统一管理的前提。1. 关闭防火墙/开放端口管理服务器需要与被控服务器通过SSH22端口、宝塔面板默认8888端口通信建议临时关闭防火墙生产环境可开放对应端口。CentOS系统命令# 关闭防火墙 systemctl stop firewalld # 禁止防火墙开机自启 systemctl disable firewalld # 查看防火墙状态确认已关闭 systemctl status firewalldUbuntu系统命令# 关闭防火墙 ufw disable # 查看防火墙状态 ufw status2. 安装Ansible管理服务器Ansible是批量管理SSH的核心通过yum或apt命令快速安装步骤如下CentOS系统yum安装# 安装epel源Ansible依赖epel源 yum install -y epel-release # 安装Ansible yum install -y ansible # 查看Ansible版本确认安装成功 ansible --versionUbuntu系统apt安装# 更新apt源 apt update # 安装Ansible apt install -y ansible # 查看版本 ansible --version安装成功提示出现ansible [version]说明安装完成若失败可尝试重启服务器后重新安装。3. 配置SSH免密登录关键为了让管理服务器能无密码登录所有被控服务器需要配置SSH免密认证避免每次登录都输入密码。# 1. 管理服务器生成SSH密钥一路回车无需输入密码 ssh-keygen -t rsa # 2. 复制密钥到被控服务器替换【被控服务器IP】为实际IP按提示输入被控服务器密码 ssh-copy-id root【被控服务器IP】 # 3. 测试免密登录无需输入密码即可登录说明配置成功 ssh root【被控服务器IP】注意每台被控服务器都要执行「ssh-copy-id」命令将管理服务器的密钥复制过去完成免密配置。如果被控服务器SSH端口不是默认22需在命令后加上「-p 端口号」例如ssh-copy-id -p 2222 root192.168.1.100。第二步Ansible批量管理SSH核心功能实现配置Ansible主机清单将所有被控服务器的信息录入即可实现批量登录、批量执行命令无需逐台操作。1. 编辑Ansible主机清单Ansible的主机清单默认路径为 /etc/ansible/hosts编辑该文件添加被控服务器信息# 编辑主机清单 vim /etc/ansible/hosts在文件末尾添加如下内容按实际情况修改可分组管理方便区分服务器用途# 分组web服务器可自定义组名 [web_servers] web1 ansible_host192.168.1.101 ansible_port22 ansible_userroot web2 ansible_host192.168.1.102 ansible_port2222 ansible_userroot # 非默认端口 # 分组数据库服务器 [db_servers] db1 ansible_host192.168.1.201 ansible_port22 ansible_userroot保存退出vim编辑器按Esc输入:wq回车。2. 测试批量连接执行如下命令测试管理服务器能否批量连接所有被控服务器# 测试所有服务器连接all表示所有分组 ansible all -m ping # 测试单个分组如web_servers ansible web_servers -m ping成功提示每台服务器返回「pong」说明批量连接成功若失败检查SSH免密配置、被控服务器IP/端口是否正确以及防火墙是否关闭。3. 批量执行SSH命令实用功能连接成功后即可通过Ansible批量执行命令无需逐台登录示例如下# 批量查看所有服务器系统版本 ansible all -m command -a cat /etc/redhat-release # CentOS系统 ansible all -m command -a cat /etc/lsb-release # Ubuntu系统 # 批量重启所有web服务器 ansible web_servers -m command -a reboot # 批量查看服务器CPU使用率 ansible all -m command -a top -b -n 1 | grep Cpu补充Ansible支持更多复杂操作如批量安装软件、批量修改配置后续可根据需求拓展核心是通过「ansible 分组/所有 -m 模块 -a 命令」实现批量管控。第三步宝塔面板统一管理API调用实现宝塔面板默认需要通过网页登录多台面板切换繁琐我们通过「宝塔API Shell脚本」在管理服务器上集中调用所有宝塔面板的功能实现统一管理。1. 开启被控服务器宝塔API每台被控服务器的宝塔面板都需要开启API接口并获取API密钥用于管理服务器调用步骤如下登录被控服务器的宝塔面板网页访问http://被控服务器IP:8888输入账号密码进入「面板设置」→「API接口」勾选「开启API接口」复制「API密钥」和「API地址」格式http://IP:8888/api保存备用每台服务器的密钥不同需单独记录建议关闭「API接口仅允许本地访问」若生产环境可设置允许管理服务器IP访问更安全。注意宝塔面板默认端口是8888若修改过端口需在API地址中替换如http://192.168.1.101:8889/api。2. 管理服务器编写Shell脚本统一调用宝塔API在管理服务器上编写Shell脚本整合所有被控服务器的宝塔API信息实现批量查询、操作宝塔面板无需逐个打开网页。示例脚本实现批量查看宝塔面板状态、站点列表# 新建脚本文件命名为bt_manage.sh vim bt_manage.sh # 脚本内容按实际情况修改服务器信息、API密钥 #!/bin/bash # 宝塔面板统一管理脚本 # 定义被控服务器宝塔信息可添加多台格式IP 端口 API密钥 bt_servers( 192.168.1.101 8888 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 192.168.1.102 8888 yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy ) # 批量查看所有宝塔面板状态 echo 所有宝塔面板状态 for server in ${bt_servers[]}; do IP$(echo $server | cut -d -f1) PORT$(echo $server | cut -d -f2) KEY$(echo $server | cut -d -f3) # 调用宝塔API查询面板状态 status$(curl -s http://$IP:$PORT/api?actionGetPanelStatusrequest_token$KEYversion1.0.0) echo 服务器$IP:$PORT 状态$status done # 批量查看所有宝塔面板站点列表 echo -e \n 所有宝塔面板站点列表 for server in ${bt_servers[]}; do IP$(echo $server | cut -d -f1) PORT$(echo $server | cut -d -f2) KEY$(echo $server | cut -d -f3) # 调用宝塔API查询站点列表 sites$(curl -s http://$IP:$PORT/api?actionGetWebSiteListrequest_token$KEYversion1.0.0) echo -e 服务器$IP:$PORT 站点$sites done保存退出后给脚本添加执行权限并运行# 添加执行权限 chmod x bt_manage.sh # 运行脚本 ./bt_manage.sh运行结果会依次输出每台服务器的宝塔面板状态、站点列表无需逐个登录网页实现集中查看。3. 拓展宝塔API功能按需添加宝塔API支持更多操作如创建站点、重启面板、安装插件、备份站点等可在脚本中添加对应API调用示例如下重启宝塔面板curl -s http://IP:PORT/api?actionRestartPanelrequest_tokenKEYversion1.0.0创建站点curl -s http://IP:PORT/api?actionAddWebSiterequest_tokenKEYversion1.0.0domainxxx.compath/www/wwwroot/xxx.com备份站点curl -s http://IP:PORT/api?actionBackupWebSiterequest_tokenKEYversion1.0.0domainxxx.com宝塔API完整文档登录宝塔面板进入「API接口」点击「API文档」可查看所有支持的操作及参数按需修改脚本即可。第四步统一管理平台优化提升实用性基础搭建完成后可进行如下优化让管理更便捷、更安全。1. Ansible配置优化简化命令编辑Ansible配置文件 /etc/ansible/ansible.cfg添加如下配置简化批量操作命令[defaults] # 默认用户无需每次输入ansible_userroot remote_user root # 超时时间避免连接超时 timeout 30 # 开启详细输出便于排查错误 verbose 12. 脚本优化添加交互、错误处理对宝塔管理脚本进行优化添加交互功能如选择操作类型、错误处理如连接失败提示示例如下新增部分# 交互选择操作 echo 请选择要执行的操作 echo 1. 查看所有宝塔面板状态 echo 2. 查看所有站点列表 echo 3. 重启所有宝塔面板 read -p 输入操作编号 opt case $opt in 1) # 查看状态省略重复代码 ;; 2) # 查看站点省略重复代码 ;; 3) # 重启面板省略重复代码 ;; *) echo 输入错误请重新运行脚本 exit 1 ;; esac3. 安全优化生产环境必做关闭SSH密码登录仅允许密钥登录修改被控服务器 /etc/ssh/sshd_config设置 PasswordAuthentication no重启SSH服务systemctl restart sshd限制API访问宝塔面板API仅允许管理服务器IP访问在「API接口」中设置「允许访问的IP」定期更换API密钥、SSH密钥避免泄露开启管理服务器防火墙仅开放必要端口如22端口供本地登录管理。三、常见问题排查避坑指南1. Ansible ping失败原因及解决方法SSH免密配置失败重新执行 ssh-copy-id 命令确保密钥复制成功被控服务器防火墙未关闭检查防火墙状态开放22端口主机清单配置错误检查IP、端口、用户名是否正确无多余空格。2. 宝塔API调用失败原因及解决方法API未开启登录宝塔面板确认「API接口」已开启API密钥错误核对每台服务器的API密钥避免混淆端口错误若宝塔面板修改过默认端口需在API地址中替换网络不通检查管理服务器能否访问被控服务器的宝塔面板网页http://IP:PORT。3. 批量执行命令无响应原因及解决方法部分被控服务器离线检查服务器状态确保网络通畅命令不适用于部分系统如CentOS和Ubuntu的系统版本查询命令不同需按分组执行Ansible超时修改配置文件中的timeout参数延长超时时间。四、总结本文通过「Ansible 宝塔API」的组合实现了多台SSH与宝塔面板的统一管理核心优势的是「轻量、无客户端、易上手」无需搭建复杂的Web平台仅通过终端和简单脚本就能完成批量登录、批量执行命令、宝塔面板集中管控等操作。无论是个人运维多台服务器还是企业级批量管控这套方案都能大幅提升效率减少重复操作。后续可根据需求拓展Ansible的自动化功能如批量部署项目、批量备份数据以及宝塔API的更多操作让运维工作更轻松。