无根容器出问题时的排查顺序:从现象到根因

Docker · 3 分钟阅读· 90 次阅读

用户服务默认随登录会话退出,loginctl enable-linger 才能开机自启

正确的第一步是分类:起不来、连不上、跑得慢,三条路完全不同。

先说结论

先分三类,再由外向内查:网络、进程、配置、依赖、资源。

  • 先确认现象能复现,且能描述清楚
  • 由外向内:端口、进程、配置、依赖、资源
  • 读第一条错误,不是最后一条
  • 改一个变量,验证一次,别一次改五处
  • 留下记录:现象、假设、验证、结论

第一类:起不来

先看进程在不在,再看它为什么退出:用户服务默认随登录会话退出,loginctl enable-linger 才能开机自启。

  • 查看服务状态与最近日志(不是全部日志)
  • 确认端口是否被占用、权限是否足够
  • 确认配置文件语法(多数服务支持 test 模式)
  • 确认依赖的数据目录存在且可写

第二类:连不上

按「本机、网络、代理、应用」四层查:

层级 验证方式 典型原因
本机 本机 curl / telnet 端口 没监听、只听 127.0.0.1
网络 从另一台机器访问 防火墙、安全组、VLAN
代理 检查反代配置与证书 路径、超时、头部大小
应用 看访问日志与错误日志 鉴权、限流、连接池耗尽

第三类:跑得慢

subuid 分配不足 65536 时,解压稍大的镜像就会报权限错误。

慢的问题先分清是「等」还是「算」:CPU 高是算,CPU 低但延迟高是等(IO、锁、网络)。

无根容器出问题时的排查顺序

这个服务的高频故障点

同类的坑基本集中在这些位置:

  • 普通用户无法绑定 1024 以下端口,要么改内核参数,要么用反代转发
  • 用户服务默认随登录会话退出,loginctl enable-linger 才能开机自启
  • subuid 分配不足 65536 时,解压稍大的镜像就会报权限错误
  • slirp4netns 的转发吞吐通常只有宿主直接网络的 30-50%

别做的事

没开 linger,SSH 一退出容器全停

/etc/subuid 只配了一半的 UID,解压大镜像直接失败

一次改多个参数,会让下一次故障更难查。

把结论写下来

排查记录不是给别人看的,是给三个月后的自己看的。slirp4netns 的转发吞吐通常只有宿主直接网络的 30-50%。

还有几处容易忽略的

都是小地方,但出问题时往往就卡在这里。

  • rootless 容器的 UID 被映射到宿主高位区间,容器内 root 在宿主只是普通用户
  • podman 不需要 daemon,docker.sock 那类「挂上就等于 root」的风险不存在
  • rootless 下映射 80 端口失败,以为是防火墙没开

排障能力不是知道更多命令,是知道先查什么。

评论 (3)

K
Kevin

版本差异要强调,我照着做结果参数名全变了。

L
lin

最小可用配置这个说法很好,先跑起来再优化。

阿
阿哲

排查顺序那段直接抄进值班手册了。

发表评论

验证码

提交后需站长审核,通过后才会显示。