改错也不怕:tcpfit快照回滚机制详解,一键还原全部32项参数

原创2026-10-24 14:53:191,685 阅读

改错也不怕: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 中,按顺序完成四件事:

  1. 清掉 tcpfit 的持久化文件:删除 /etc/sysctl.d/99-tcpfit.conf、qdisc 服务单元、路由 hook、bbr 模块加载配置,并 systemctl disable 掉整形服务;
  2. 拆除出向整形:tc qdisc del 删掉网卡上的队列配置;
  3. 逐项写回快照值:从快照文件读出每一条 参数 = 值,用 sysctl -qw 精确还原 32 项参数——注意是"按快照值写回",而不是"恢复内核默认",两者对自定义过的机器完全不同;
  4. 处理 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 的回滚机制把"可回退"做成了四个硬性保障:

  1. ✅ 自动快照:首次改动前自动存档,只保留最早基线,不会漂移;
  2. ✅ 逐项精确还原:32 项参数按快照原值写回,而非粗暴恢复默认;
  3. ✅ 拒绝假基线:检测到"有配置无快照"直接中止,避免回滚永久失效;
  4. ✅ 保守处理危险项:swap 默认不动,文件锁防并发互踩。

对新手来说,这意味着你可以放心让 tcpfit 全自动跑完约 10 分钟的一键调优:收益不满意、或者遇到任何异常,tcpfit rollback 一条命令就能回到改动前的状态。

相关资料:README.md(回滚章节)、install.sh(安装脚本,含 tcpfit rollback # 随时可回滚 提示)、LICENSE(MIT)。

登录后查看全文
tcpfit