如何限制docker run执行时长？--stop-timeout参数使用异常求助

你确实误解了--stop-timeout参数的作用，这也是很多刚接触Docker的用户容易踩的坑。

先澄清--stop-timeout的真实含义 #

根据Docker官方文档的说明，这个参数的作用是：当你主动执行docker stop命令时，Docker会先向容器发送SIGTERM信号，让容器优雅退出；如果容器在指定的超时时间内没有自行退出，Docker才会发送SIGKILL信号强制终止容器。它完全不是用来自动监控容器运行时长、超时后停止容器的参数。

你之前执行的命令：

docker run -d --stop-timeout 3 ubuntu:14.04 sleep 100

这个命令的意思是：后台启动一个运行sleep 100的容器；当你之后手动执行docker stop <容器ID>时，Docker会等3秒，如果容器还没退出，就强制杀掉它。所以容器会一直运行到sleep 100结束，完全符合预期。

实现「命令执行超过3秒则删除容器」的正确方法 #

要实现你的需求，最直接的方式是在容器内部用timeout命令限制目标命令的运行时长，再配合--rm参数让容器退出后自动删除：

docker run --rm ubuntu:14.04 timeout 3 sleep 100

这个命令的逻辑是：

1. timeout 3 sleep 100：让sleep 100最多运行3秒，超时后timeout会终止sleep进程
2. 当容器内的主进程（这里是timeout）结束后，容器会自动退出
3. --rm参数会在容器退出后自动删除它

如果你的命令比sleep更复杂，只需要把timeout 3加在你的命令前面即可，比如：

docker run --rm your-image timeout 3 your-complex-command

补充说明 #

你的Docker版本（17.12.0-ce）完全支持上述所有命令，不需要担心兼容性问题。如果是更复杂的场景（比如需要监控容器的运行状态而非命令时长），可以考虑结合Docker健康检查和自动重启策略，但对于你当前的需求，timeout + --rm是最简洁高效的方案。

内容的提问来源于stack exchange，提问作者Brian