批量修改宝塔网站配置前必须确认三件事：一、在面板设置中开启API并记录key和secret；二、请求头必须包含X-Requested-With: XMLHttpRequest；三、后续操作依赖/api/website/get_sites返回的网站id，而非域名或网站名。
宝塔 API 批量修改网站配置前必须确认的三件事
宝塔面板没有“批量改网站配置”的图形界面按钮，所有批量操作都得走 /api/website 系列接口，且默认关闭 API 访问——不提前开权限、不拿对密钥、不搞清接口鉴权方式，发一百个请求也全返回 {"status":false,"msg":"API密钥错误"}。
实操前先确认：
- 在「面板设置 → API 接口」里已开启 API，并记下
key和secret - 用
curl或 Python 调用时，request.headers必须带X-Requested-With: XMLHttpRequest，否则 403 -
/api/website/get_sites返回的每个网站都有id字段，后续所有修改（如改 PHP 版本、改伪静态）都靠这个id，不是域名也不是网站名
用 Python 调用 set_php_version 批量切 PHP 版本
这是最常批量做的操作：把几十个 WordPress 站从 PHP 7.4 升到 8.1。别手点，但注意 set_php_version 接口只认 PHP 运行环境 ID，不是版本字符串。
查可用 PHP ID 的方法：curl -X POST "https://你的面板地址:8888/api/soft/get_php_versions" -d "type=php"，返回里找 "id": 12 这种数字——PHP 8.1 对应的 ID 在不同面板版本可能不同，不能硬编码。
批量调用示例（Python）：
import requests
url = "https://your-panel:8888/api/website/set_php_version"
headers = {
"X-Requested-With": "XMLHttpRequest",
"Content-Type": "application/x-www-form-urlencoded"
}
data = {
"id": 15, # 网站 ID，从 get_sites 拿
"php_version": "12" # 注意：是字符串格式的 ID，不是 "81" 或 "8.1"
}
# 签名计算省略，实际必须加 sign 参数
requests.post(url, headers=headers, data=data)容易踩的坑：
-
php_version值填"8.1"会静默失败，必须填后台返回的数字 ID - 一次只能改一个网站，想批量就得循环调用，别试图塞多个
id进去——接口不支持数组 - 改完不会自动重载 PHP-FPM，得额外调
restart_php接口，否则新配置不生效
通过 set_rewrite 批量更新伪静态规则
给一批 Laravel 站统一加 try_files $uri $uri/ /index.php?$query_string？直接改 Nginx 配置文件风险高，用 set_rewrite 更稳，但要注意它只接受「规则名」，不接受原始配置文本。
宝塔的伪静态是预设模板机制：你得先把规则存成模板（比如叫 laravel8），再用接口绑定。没提前存，调 set_rewrite 会返回 "msg":"指定的伪静态规则不存在"。
操作链路：
- 手动在面板「网站 → 设置 → 伪静态」里新建并保存一个模板，名字记牢（如
laravel8） - 调用
/api/website/set_rewrite，传id（网站 ID）和rewrite_name（就是刚才存的模板名） -
rewrite_name区分大小写，填laravel8和Laravel8效果不同
没存模板就跑脚本？只会批量失败，还可能触发面板频率限制被临时封 API 请求。
为什么 save_nginx_conf 不适合批量改配置
有人想绕过所有接口，直接读写 /www/server/panel/vhost/nginx/ 下的 conf 文件，再调 save_nginx_conf 强制重载——这做法在单站没问题，批量时极易出问题。
原因很实在：
- 宝塔会校验 conf 文件语法，批量写错一处（比如少个分号），整个
nginx -t失败，所有网站 502 -
save_nginx_conf接口不接受文件路径参数，它只重载当前面板缓存的配置内容，而缓存是单次加载的，不是实时映射磁盘文件 - 并发调用该接口，可能因锁机制导致部分请求被丢弃，返回
"status":true但实际没生效
真要动底层配置，宁可逐个调 get_nginx_conf → 本地改 → set_nginx_conf，至少每步可控、可回滚。
API 批量的核心约束就一条：它设计来改「面板管理维度」的设置，不是替代 shell 脚本的通用配置工具。越想一步到位，越容易卡在签名、ID 映射或状态同步上。
