alibaba ktuner — 内核参数自动调优
核心能力
ktuner 是确定性规则引擎（非 LLM），评估 207 条内核调优规则，输出 JSON 格式的诊断结果和建议。
所有输出在 stdout，格式为 JSON。错误输出在 stderr，格式也是 JSON。
使用流程
第一步：诊断
ktuner check
输出示例：
{
"score": 30,
"predicted_score": 100,
"total_checked": 196,
"recommendations": [
{
"param": "net.ipv4.tcp_rfc1337",
"current": "0",
"recommended": "1",
"reason": "防止 TIME_WAIT 状态下的 RST 攻击",
"confidence": "high",
"category": "security",
"writable": true
}
],
"system": { "kernel": "6.6.102+", "cpu_cores": 2, "memory_gb": 8 },
"workload": "mixed",
"services": ["Nginx", "PostgreSQL"]
}
根据 score 判断是否需要调优：90+ 优秀，70-89 良好，低于 70 建议调优。
可选参数：
--category net|mem|io|cpu|security— 只看某一类--conservative— 只看高置信度建议
第二步：向用户解释建议
遍历 recommendations 数组，用中文向用户解释每条建议的 reason 和影响。
如果用户想了解某个具体参数：
ktuner why <参数名>
第三步：应用（需要 root，必须用户确认后才执行）
⚠️ 重要：tune 和 fix 会修改内核参数，必须先向用户展示建议内容，得到明确确认后再执行。
预览模式（不修改）：
sudo ktuner tune --dry-run
应用全部建议：
sudo ktuner tune
只修一个参数：
sudo ktuner fix <参数名>
第四步：回滚（如果需要）
sudo ktuner rollback
输出：
{ "restored": 5, "failed": 0, "skipped": 0, "status": "Full" }
退出码
| 退出码 | 含义 |
|---|---|
| 0 | 成功（check 时表示系统已最优） |
| 1 | check 发现有建议（不是错误，表示可以优化） |
| 2 | 错误（详见 stderr 的 JSON） |
约束
- tune / fix / rollback 需要 root 权限（使用
sudo） - check / why 不需要 root
kernel.core_pattern、kernel.modprobe等代码执行参数被禁止写入- 调优后如发现性能劣化，使用
sudo ktuner rollback恢复