少女祈祷中...
Xrq13-Blog

如何维护个人技术资源导航:官方文档、工具清单、脚本和排障手册

资源导航要解决什么问题

收藏夹里有几百个链接,并不代表真正能用。技术资源导航的目标是让你在遇到问题时快速找到可信入口:查官方配置、找排障命令、确认参数含义、复用脚本模板、回顾以前的处理记录。

建议分成六类

1. 官方文档

官方文档是优先级最高的资源。框架 API、数据库参数、Web 服务器配置、语言标准库,都应该优先查官方文档。资源导航里不需要复制整篇文档,只需要记录入口、适用场景和你常查的关键词。

  • 语言和运行时:语法、标准库、包管理器。
  • 框架:路由、配置、生命周期、部署方式。
  • 数据库:索引、事务、备份恢复、权限。
  • 服务器软件:Nginx、Docker、Linux systemd 等。

2. 常用工具

工具类资源要写清用途,不要只放名字。例如“接口调试工具”可以记录适合调试 HTTP 请求;“日志查看命令”可以记录适合定位服务启动失败。

网络检查:curl、ping、traceroute、dig
进程端口:ps、top、htop、ss、lsof
日志排查:journalctl、docker logs、tail
性能观察:free、df、iostat、vmstat

3. 命令片段

命令片段必须注明风险。比如删除、重启、覆盖配置、数据库变更都应该写清使用前提和回滚方式。

# 查看 443 端口监听进程
ss -lntp | grep ':443'

# 检查 Nginx 配置并重载
nginx -t && systemctl reload nginx

危险命令不要只保存一行。至少补充“会影响什么”“执行前检查什么”“失败后怎么恢复”。

4. 配置模板

常用配置可以模板化,例如 Nginx 反向代理、Docker Compose、systemd 服务文件、数据库备份脚本。模板里要用占位符,不要混入真实密钥。

server {
  server_name example.com;
  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
  }
}

5. 排障手册

排障手册应该按问题组织,而不是按工具组织。例如“网站打不开”“接口超时”“磁盘满了”“证书过期”“数据库连接失败”。每个问题下面放检查顺序。

网站打不开:
1. dig 域名,确认解析
2. curl -I 域名,确认 HTTP 状态
3. 检查 Nginx 状态
4. 检查上游应用端口
5. 查看最近 30 分钟日志

6. 学习路线

学习路线不要写成大而全的清单,应该围绕当前目标组织。例如“能独立部署一个 Web 服务”需要 Linux 基础、Nginx、进程管理、数据库、备份和日志,而不是同时学习所有云原生工具。

资源入库标准

  • 来源可信,优先官方文档或长期维护项目。
  • 写清适用场景,不只保存标题。
  • 标记更新时间,过期资源定期清理。
  • 命令和脚本要有风险说明。
  • 同类资源控制数量,保留最常用的入口。

维护节奏

建议每月清理一次资源导航:删除失效链接,合并重复工具,更新常用命令,把最近排查过的问题补进手册。资源导航越用越准,关键不在一次整理得多完整,而在每次解决问题后及时沉淀。

一个好的资源导航,应该像自己的技术控制台:遇到问题时能快速进入正确方向,而不是在搜索结果里从头试错。

评论