搬瓦工 KiwiVM API 安全教程：API Key 保存、脚本自动化、权限边界和泄露处置

BandwagonHost 官方网站

一、先看结论

KiwiVM API 适合自动化查询 VPS 状态、流量、重启、脚本化管理和批量运维，但 API Key 一旦泄露，风险可能比 SSH 密码泄露更隐蔽：攻击者不一定登录系统，也可能通过 API 执行重启、关机、重装、迁移、快照相关操作，导致业务中断或数据损失。

安全原则很简单：Key 不硬编码、日志不明文、危险操作不自动裸跑、脚本有审计、失败能回滚、泄露能立刻停用。生产业务不要把 API 当作“万能按钮”，所有破坏性动作都应该有二次确认和维护窗口。

二、KiwiVM API 主要风险

三、API Key 应该怎么保存？

四、脚本示例：读取环境变量和脱敏日志

下面示例只演示安全写法，不包含真实 API 地址或真实 Key。实际参数以 KiwiVM 当前面板显示为准。

# Linux / macOS 设置环境变量，注意不要写入公开脚本
export KIWI_API_KEY="替换为你的Key"
export KIWI_VPS_ID="替换为你的VPS编号"

# 权限收紧的配置文件示例
cat > ~/.kiwivm.env <<'EOF'
KIWI_API_KEY=替换为你的Key
KIWI_VPS_ID=替换为你的VPS编号
EOF
chmod 600 ~/.kiwivm.env

# Bash 中读取配置，不打印完整 Key
set -a
. ~/.kiwivm.env
set +a

mask_key() {
    local value="$1"
    printf "%s****%s" "${value:0:4}" "${value: -4}"
}

echo "Using KiwiVM API Key: $(mask_key "$KIWI_API_KEY")"
echo "Target VPS: $KIWI_VPS_ID"

// C# 读取环境变量，不把完整 Key 写入日志
string apiKey = Environment.GetEnvironmentVariable("KIWI_API_KEY") ?? "";
string vpsId = Environment.GetEnvironmentVariable("KIWI_VPS_ID") ?? "";

if (string.IsNullOrWhiteSpace(apiKey) || string.IsNullOrWhiteSpace(vpsId))
{
    throw new InvalidOperationException("KiwiVM API configuration is missing.");
}

string masked = apiKey.Length > 8
    ? apiKey.Substring(0, 4) + "****" + apiKey.Substring(apiKey.Length - 4)
    : "****";

Console.WriteLine("KiwiVM API Key: " + masked);
Console.WriteLine("Target VPS: " + vpsId);

五、哪些 API 动作必须二次确认？

六、安全自动化流程

1. 明确用途。只为必要动作写 API 脚本，不要把所有按钮都自动化。
2. 隔离环境。测试环境先跑，生产环境再执行。
3. 限制入口。脚本只放在受控服务器或 CI/CD 中，不放到 Web 目录。
4. 脱敏日志。记录动作、时间、目标 VPS、结果，不记录完整 Key。
5. 危险确认。重装、迁移、恢复快照、关机等动作必须二次确认。
6. 失败处理。超时、失败、重复调用要有限制，不能无限循环。
7. 通知机制。生产环境动作完成或失败后，发送 Telegram、邮件或日志告警。
8. 定期轮换。按用途和周期轮换 Key，废弃脚本及时停用。

七、日志和审计应该记录什么？

八、API Key 泄露后怎么处理？

1. 立即停用或重置 Key。先阻断继续调用。
2. 暂停自动化任务。禁用 cron、CI/CD、后台服务和相关脚本。
3. 检查近期操作。确认是否有重启、关机、迁移、重装、快照恢复等动作。
4. 检查公开位置。Git 历史、日志文件、网页目录、备份包、截图和报错页面。
5. 清理历史记录。仅删除当前文件不够，Git 历史和备份里可能还存在。
6. 检查 VPS 状态。确认 IP、机房、系统、磁盘、流量和业务访问是否正常。
7. 重新生成配置。更新环境变量、配置文件和 CI/CD Secrets。
8. 补充审计。记录泄露时间、影响范围、处理动作和后续防护。

# 查找当前目录中疑似泄露的 Key / Token 字段
grep -RniE "api[_-]?key|token|secret|password" . 2>/dev/null

# 检查最近修改过的脚本和配置
find . -type f -mtime -7 -ls 2>/dev/null

# 检查 crontab 和 systemd 任务
crontab -l
systemctl list-timers --all
systemctl list-unit-files --type=service | grep enabled

九、上线前检查清单

• API Key 没有写死在脚本里。
• 配置文件权限已经限制到运行用户，例如 chmod 600。
• 日志中不会出现完整 Key、Token、密码、敏感 URL。
• 危险操作默认关闭，必须手动加 --confirm 或人工输入确认。
• 脚本有超时、重试次数上限和失败通知。
• 生产动作前已经备份，并确认维护窗口。
• 脚本所在服务器本身已做好 SSH 安全加固。
• Key 有轮换计划，废弃脚本和旧配置会及时删除。

十、常见问题（FAQ）

相关教程

参考资料

• BandwagonHost 官方网站
• BandwagonHost 服务条款中文参考