改错也不怕:tcpfit快照回滚机制详解,一键还原全部32项参数
改错也不怕:tcpfit快照回滚机制详解,一键还原全部32项参数
tcpfit 是一款按每台机器实测推导的 TCP 调优工具——不套用固定参数,而是实测带宽时延积(BDP)与限速器拐点来设置拥塞控制、缓冲区、队列等内核参数。很多人不敢对服务器做 TCP 调优,怕改坏了回不去。tcpfit 的答案是:首次改动前自动存一份出厂快照,之后一条命令即可把全部 32 项 sysctl 参数逐项还原。这就是本文要详解的 tcpfit 快照与回滚机制。
一、tcpfit 到底改了哪些参数?
跑完一键调优后,tcpfit 会改动这几类内核参数(共 32 个 sysctl 参数):
| 类别 | 参数 |
|---|---|
| 拥塞控制 | tcp_congestion_control=bbr + default_qdisc=fq |
| 缓冲区 | tcp_rmem / tcp_wmem / rmem_max / wmem_max / tcp_mem |
| 窗口 | tcp_window_scaling / tcp_moderate_rcvbuf / tcp_adv_win_scale |
| 队列 | netdev_max_backlog / netdev_budget / somaxconn 等 |
| 连接 | tcp_tw_reuse / tcp_fin_timeout / ip_local_port_range 等 |
| 起步 | tcp_slow_start_after_idle=0 / initcwnd 32 |
| 出向整形 | HTB 全局上限 + fq 叶子 pacing |
其中缓冲区和整形值是按你这台机器的实测数据推导的,不是抄来的固定值,这也是为什么回滚必须"精确到原始值"——它们没有统一的"出厂默认"可言。
完整清单以源码中的 TUNED_KEYS 变量为准(见 tcpfit.sh)。这段注释很能说明设计者的严谨态度:
调优会动到的全部内核参数。快照和回滚都以这份清单为准——早期版本快照只记了 14 项而 tune 设了 31 项,回滚后有 17 项在重启前仍是调优值。加参数时必须同时加到这里,否则那个参数就回滚不掉。
📌 关键点:快照与回滚共用同一份参数清单,保证"改了什么,就能还原什么"。
二、快照是怎么生成的?
首次改动前自动存档
只要你第一次执行会改系统的命令(如 tune),tcpfit 会先调用 take_snapshot 函数,把改动前那一刻的全部 32 项参数原始值写进快照文件:
/var/lib/tcpfit/pre-tune.snapshot
快照内容很简单,就是"参数 = 原始值"的逐行记录,外加时间戳、内核版本、默认路由和网卡 qdisc 状态作为辅助信息(见 tcpfit.sh):
# tcpfit pre-tune snapshot 2026-10-24T02:00:00Z
KERNEL=6.8.0-40-generic
net.core.default_qdisc = fq_codel
net.ipv4.tcp_congestion_control = cubic
net.ipv4.tcp_rmem = 4096 131072 6291456
...(其余 29 项参数)
# route: default via 10.0.0.1 dev eth0
# qdisc: qdisc noqueue 0: root
快照只存"最早那份"
[ -f "$SNAPSHOT" ] && { info "Snapshot already exists, keeping the earliest one"; return; }
快照已存在时直接跳过(见 tcpfit.sh)。这保证了快照永远是最早那次调优前的基线——之后你再跑多少次 tune、换多少组参数,回滚目标都不会漂移。
🔒 防"假基线"保护
这是机制里最聪明的地方。如果检测到你机器上已经有调优配置文件却没有出厂快照(比如你手工改过 sysctl,或用了旧版本),tcpfit 会拒绝继续并明确报错:
检测到本机已有调优配置, 但没有出厂快照。 现在存快照会把「已调优状态」误记成基线, 导致 rollback 失效。
因为这种情况下存快照,等于把"调优后的状态"当成出厂值——回滚只会回到调优后,永远回不去。脚本会给你三个出路:手工写入真实出厂值、先回滚再重新调优、或显式放弃回滚能力(touch 空快照文件)。宁可中止,也不留一个"看起来能回滚、实际回不到"的假快照(源码见 tcpfit.sh)。
三、tcpfit rollback 回滚都做什么?
一条命令,菜单选 7 或命令行执行:
tcpfit rollback # 按快照逐项写回, 不是恢复默认
tcpfit rollback --purge-swap # 同时删掉 harden 建的 /swapfile
回滚逻辑在 cmd_rollback 中,按顺序完成四件事:
- 清掉 tcpfit 的持久化文件:删除
/etc/sysctl.d/99-tcpfit.conf、qdisc 服务单元、路由 hook、bbr 模块加载配置,并systemctl disable掉整形服务; - 拆除出向整形:
tc qdisc del删掉网卡上的队列配置; - 逐项写回快照值:从快照文件读出每一条
参数 = 值,用sysctl -qw精确还原 32 项参数——注意是"按快照值写回",而不是"恢复内核默认",两者对自定义过的机器完全不同; - 处理 swap(默认保守):
harden --swap建过的/swapfile默认保留,因为删掉正在使用的 swap 可能让机器立刻 OOM,必须显式加--purge-swap才动它。
即使快照意外丢失,回滚也不会"半残":它会移除全部 tcpfit 配置文件并提示"重启后内核默认值生效"(见 tcpfit.sh)。
改动落点也有限定范围,tcpfit 不碰 /etc/sysctl.conf(见 README "回滚"一节):
/etc/sysctl.d/99-tcpfit.conf
/etc/systemd/system/tcpfit-qdisc.service
/usr/local/sbin/tcpfit-qdisc.sh
/etc/networkd-dispatcher/routable.d/50-tcpfit-initcwnd
/etc/modules-load.d/tcpfit-bbr.conf
/var/lib/tcpfit/
四、更多安全细节
文件锁:防止两个实例打架
回滚和调优一样,执行前会先抢文件锁 /var/lock/tcpfit.lock。如果另一个 tcpfit 正在跑(或上次异常退出把锁卡住了),它会列出锁的持有者 PID 和已运行时长,并提供一键结束(见 take_lock)。两个实例同时抢 qdisc、快照和 sysctl 是最常见的翻车场景,串行化是底线。
参数校验先于快照
早期版本有个坑:shape --rate abc 会先存快照、再让 tc 报错,留下一堆垃圾状态。现在所有参数都先校验、校验通过才存快照(源码注释见 tcpfit.sh)——打错参数不留任何状态。
从 nettune 升级?快照自动搬迁
项目 v0.3.1 从 nettune 改名为 tcpfit。老机器上的产物文件名还是 nettune-*,新版会先执行 migrate_legacy 把旧文件逐个搬到新路径,然后提示:
快照保留在 /var/lib/tcpfit/pre-tune.snapshot, rollback 仍然可用.
注意注释里提到的一个隐蔽风险:如果直接按新名字找文件,99-tcpfit.conf 在旧部署眼里"不存在",就会把已调优状态误存成出厂基线,rollback 从此永久错误且无任何报错。所以必须搬迁而不是假装老部署不存在。老用户直接跑新版即可,快照和回滚能力完整保留。
五、常见问题速查(FAQ)
| 问题 | 答案 |
|---|---|
| 快照在哪看? | tcpfit status 会显示 Snapshot 路径;文件在 /var/lib/tcpfit/pre-tune.snapshot |
| 想只去掉整形、保留调优? | 用 tcpfit shape --off,它不动 sysctl,基础调优完整保留 |
| 回滚后 swap 还在? | 正常设计,防 OOM;要一并删用 tcpfit rollback --purge-swap |
| 快照丢了还能回滚吗? | 能,会移除全部 tcpfit 文件,重启后内核默认值生效 |
| 机器已手工调过、没有快照? | 脚本会中止并提示你先明确基线(见上文"防假基线保护") |
| 多机怎么回滚? | 编排端可用 python3 orchestrator/fleet.py rollback(fleet.py;多机编排未上线,仅供参考) |
总结:为什么说"改错也不怕"
tcpfit 的回滚机制把"可回退"做成了四个硬性保障:
- ✅ 自动快照:首次改动前自动存档,只保留最早基线,不会漂移;
- ✅ 逐项精确还原:32 项参数按快照原值写回,而非粗暴恢复默认;
- ✅ 拒绝假基线:检测到"有配置无快照"直接中止,避免回滚永久失效;
- ✅ 保守处理危险项:swap 默认不动,文件锁防并发互踩。
对新手来说,这意味着你可以放心让 tcpfit 全自动跑完约 10 分钟的一键调优:收益不满意、或者遇到任何异常,tcpfit rollback 一条命令就能回到改动前的状态。
相关资料:README.md(回滚章节)、install.sh(安装脚本,含
tcpfit rollback # 随时可回滚提示)、LICENSE(MIT)。