批量创建网站必须用宝塔API而非手动操作，关键在于严格按文档传参、利用钩子脚本同步配置、关闭“仅首页HTTPS”并用logrotate统一管理日志。
批量创建网站必须用宝塔 API，手动点根本不可行
面对上百个网站，靠面板 UI 一个一个填域名、选 PHP 版本、设根目录，不仅耗时，还极易填错配置项。宝塔的 /api/website/create_site 接口才是真实生产力工具。
关键点在于：所有参数必须严格按文档传，尤其是 type（站点类型）、php_version（如 74 表示 PHP 7.4）、path（绝对路径，不能带末尾斜杠）——少一个或格式错，接口直接返回 {"status":false,"msg":"参数错误"}。
实操建议：
- 先用宝塔后台创建一个标准站，再调用
/api/website/get_site_list查看其完整字段结构，反向推导出模板参数 - 域名列表用 CSV 存，脚本逐行读取并拼接 JSON 请求体，避免硬编码
- 务必在请求头加
X-Requested-With: XMLHttpRequest和有效login_token，否则 401 拒绝访问 - 批量创建时加
sleep(0.3)间隔，防止面板后端并发限流导致部分站点创建失败但无报错
网站配置同步不能靠复制粘贴，得用 conf 模板 + 钩子脚本
上百个站如果每个都手动改 Nginx 配置、开 Gzip、加防盗链规则，后期维护就是灾难。宝塔不提供“全站配置广播”功能，但支持通过 site_before_create 和 site_after_create 这两个系统钩子自动注入配置。
常见踩坑点：
- 钩子脚本必须放在
/www/server/panel/class/下，且文件名含_hook（如custom_site_hook.py），否则不触发 - 修改 Nginx 配置不能直接写
server {}块，得用宝塔封装的WriteConf方法，否则重启 Nginx 时被自动覆盖 - PHP 设置若需统一开启 OPcache，不能只改全局
php.ini，必须在每个站点的php-fpm.conf中显式追加php_admin_value[opcache.enable] = 1，否则子进程不继承
SSL 证书自动续期必须关掉「仅首页 HTTPS」开关
批量部署后，大量站点启用 Let's Encrypt 免费证书。看似勾选「自动续期」就完事，但默认开启的「仅首页 HTTPS」会导致子目录、API 接口、静态资源仍走 HTTP，前端报混合内容警告，且部分 JS/CSS 加载失败。
真正生效的操作是：
- 进入任意一个已部署站点的「SSL」页，点击「设置」按钮
- 取消勾选
仅首页强制 HTTPS，改为勾选全站强制 HTTPS - 该设置会写入站点 Nginx 配置的
rewrite规则，但不会自动同步到其他站点——必须用脚本遍历/www/server/panel/vhost/nginx/下所有*.conf文件，批量替换if ($scheme = http) {块为全站跳转逻辑 - 执行前先
nginx -t校验语法，否则一次改错可能让全部站点 502
日志轮转和磁盘清理必须脱离「计划任务」图形界面
面板自带的「计划任务 → 日志切割」功能只对单个站点有效，且无法按大小而非时间触发。上百个站的日志若不控制，/www/wwwlogs/ 目录几天就能撑爆磁盘。
更可靠的做法是绕过面板，直接操作底层：
- 用
logrotate配置全局策略，在/etc/logrotate.d/bt_sites里定义通配规则，例如匹配/www/wwwlogs/*.log，按周切割 + 保留 4 周 + 超过 100MB 强制压缩 - 禁止在宝塔「计划任务」里添加「删除日志」类任务——它调用的是 Python 的
os.remove()，没有权限校验，容易误删正在写入的活跃日志文件，导致 Nginx 报open() "/www/wwwlogs/xxx.log" failed (9: Bad file descriptor) - 清理临时文件用
find /www/wwwroot -name "*.tmp" -mtime +7 -delete，但必须排除/www/wwwroot/*/runtime等框架缓存目录，否则 Laravel 或 ThinkPHP 站点直接 500
真正卡住效率的从来不是创建动作本身，而是配置漂移、日志失控、证书失效这些「看不见的故障」。API 调用要稳，配置同步要准，日志清理要狠——三者缺一，批量运维就会退化成手动救火。
