必须关闭未认证的API接口，因宝塔7.9.x及更早版本默认允许任意IP直接调用GetSystemInfo、ExecShell等高危接口窃取信息或执行命令，已有公开PoC流通；修复核心是关闭裸露接口并启用登录态校验。
宝塔面板默认开启的 API 接口（/api/ 路径）若未设防，攻击者可直接调用 GetSystemInfo、LoginSafe 甚至 ExecShell 等高危接口，无需登录即可执行命令或窃取服务器信息。修复核心就两条：关掉裸露接口 + 用白名单锁死可信来源。
为什么必须关闭未认证的 API 接口
宝塔 7.9.x 及更早版本默认允许任意 IP 访问 /api/，只要知道接口名和参数格式（比如 GET /api/GetSystemInfo），就能拿到 CPU、内存、磁盘、运行进程等完整系统快照。这不是“可能被利用”，而是已有公开 PoC 在 GitHub 和漏洞平台流通。
- 常见错误现象：
curl "http://your-server:8888/api/GetSystemInfo?login_token=xxx"直接返回 JSON 数据，没报错也没跳转 - 使用场景：攻击者常先扫开放的
:8888端口，再批量请求/api/*列表试探接口可用性 - 性能影响：无；但一旦被用于横向扫描或爆破，会触发大量日志写入，拖慢面板响应
如何开启 API 白名单（仅限宝塔 7.9.10+）
白名单不是加个 IP 就完事——它只对「通过面板登录后发起的 AJAX 请求」生效，对直接 curl 或浏览器访问 /api/ 的请求无效。真正起作用的是「API 接口开关」+「登录态校验强制」。
- 登录宝塔后台 → 左侧「安全」→「API接口管理」→ 关闭「允许通过API接口直接访问」开关（这是最关键的一步）
- 保持「API接口密钥」开启，但不要用默认值；点击「重新生成密钥」，密钥长度必须 ≥32 位，含大小写字母+数字+符号
- 白名单填写格式严格为 CIDR，例如：
192.168.1.0/24、2001:db8::/32；单个 IP 写成1.2.3.4/32，不能写1.2.3.4 - 若需脚本调用（如监控脚本），必须在请求头中带上
X-BT-KEY，且该 KEY 必须与面板中配置的完全一致，大小写敏感
定期更换密钥的实际操作与坑点
密钥不是“换一次就高枕无忧”。宝塔不会自动轮换，也不会提示过期；所有依赖旧密钥的自动化脚本、监控工具、CI/CD 流程都会立刻中断。
- 更换前务必 grep 全局：在服务器上执行
grep -r "X-BT-KEY\|BT_API_KEY" /path/to/your/scripts/，找出所有硬编码位置 - 新密钥生成后，旧密钥**不会立即失效**，而是进入 24 小时共存期（仅限 7.9.10+），这期间新旧都可用，但日志里会告警
deprecated api key used - 切勿在 crontab 里写自动更换脚本——密钥变更后需人工确认所有下游服务已同步，否则可能引发批量故障
- 密钥明文不能进 Git：如果脚本托管在 GitHub/GitLab，请改用环境变量注入，例如 Python 中用
os.getenv("BT_API_KEY")，而非写死字符串
最易被忽略的一点：白名单只限制「调用来源 IP」，不校验「调用者身份」。如果你的运维机本身被黑，白名单形同虚设。真正关键的防线是——永远关闭「允许通过API接口直接访问」，让所有 API 调用必须经过面板登录态（session）校验，这才是宝塔原生支持的最小权限模型。
