无根容器出问题时的排查顺序:从现象到根因
用户服务默认随登录会话退出,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)
版本差异要强调,我照着做结果参数名全变了。
最小可用配置这个说法很好,先跑起来再优化。
排查顺序那段直接抄进值班手册了。
发表评论