一份可复用笔记的结构
- 背景:设备型号、系统版本、软件版本和网络拓扑。
- 目标:希望实现什么,哪些行为必须保持不变。
- 现状:关键配置片段、日志和可复现的现象。
- 操作:按顺序记录命令与修改,不省略关键参数。
- 验证:用明确的测试证明目标已经实现。
- 回滚:说明如何恢复原配置,以及备份放在哪里。
保留上下文
单独一行命令往往缺少上下文。记录命令时,补充执行位置、权限、预期输出和异常分支。涉及密钥、令牌、私钥或公网凭据时,使用脱敏占位符,不要把真实秘密写进公开笔记。
区分事实与推测
事实:抓包显示客户端发出了 SYN,但没有收到 SYN-ACK。
推测:上游网络可能过滤了目标端口。
把两者分开记录,可以避免下一次排障把未经验证的猜测当成既定结论。
让笔记保持轻量
不必追求一次写成完整教程。先保存最小可复现信息,之后再补充背景、图示和注意事项。笔记的价值在于下一次能更快恢复上下文。