首页/云/Docker 容器速查/退出码 255:应用约定错误
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条
容器排障52 条

退出码 255:应用约定错误

255 不是 Docker 定义的码:常见于应用以 exit(-1)、ssh 类工具错误退出等约定,属于应用层问题,按应用日志定位。

Docker 容器速查云更新于 2026-10-12
含义应用自定义(常为 -1 归一化)
对比Docker 层失败是 125,信号是 128+N
排查应用日志与参数

示例

示例
docker run --rm app/tool:1.0 check-config
echo "exit=$?"
docker logs --tail 100 <容器名> 2>/dev/null | tail -20
一次性任务用 --rm 运行后通过 shell 的 $? 直接拿退出码,比翻 inspect 更直接。

易错点

  • ssh/scp 类命令的 255 是工具自身约定,与 Docker 无关,别按容器错误处理
  • 不同 shell 对超出范围退出码取模,脚本判断要基于实际容器退出码而非猜测

数据来源与参考

  • Docker 官方文档:docker run Exit status 说明(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌