Поиск
Справочник

Команда timeout: как ограничить время работы команды

timeout запускает команду и следит за временем. Если команда не закончила работу за отведённый срок, timeout посылает ей сигнал остановки. Так зависшая загрузка или проверка не задержит скрипт и не будет часами висеть в cron.

≈ 4 мин чтения
Содержание 11

Что сделать прямо сейчас

  1. Подключитесь к серверу — инструкция.
  2. Выполните timeout 3 sleep 10; echo $?. Через 3 секунды команда остановится, а ответ будет 124 — так timeout сообщает, что время вышло.
  3. Выполните timeout 10 sleep 2; echo $?. Ответ — 0: sleep успела закончить работу, и timeout передала её код.

Как записать срок

ЗаписьСрок
timeout 30 команда30 секунд
timeout 30s команда30 секунд
timeout 5m команда5 минут
timeout 2h команда2 часа
timeout 1d командаодни сутки
timeout 0.5 командаполсекунды
timeout 0 командабез ограничения

Дробную часть пишите через точку. Суффикс у срока один и стоит сразу после числа: запись 1h30m timeout не примет — пишите 90m.

Что происходит, когда время вышло

timeout посылает команде сигнал TERM — просьбу завершиться. Программа может закрыть файлы и выйти сама. Если она не отвечает на TERM, добавьте -k: через указанное время после TERM timeout пошлёт KILL, а его программа перехватить не может.

timeout -k 10s 5m ./backup.sh

Скрипт работает не больше 5 минут. Потом он получает TERM, а если через 10 секунд ещё жив — KILL.

Другой сигнал задаёт ключ -s: timeout -s INT 30s команда пошлёт INT, как при нажатии Ctrl+C. Что такое сигналы — Процессы: ps, top и kill.

Коды выхода

КодЧто значит
124время вышло, команда остановлена
125ошибка самой команды timeout, например неверно записан срок
126команда найдена, но запустить её нельзя, например нет права на запуск
127команда не найдена
137команда остановлена сигналом KILL
другойкод, с которым закончила работу сама команда

С ключом --preserve-status timeout возвращает код самой команды, даже когда время вышло.

timeout в скрипте

#!/bin/bash
timeout 60s ./check.sh
code=$?
if [ "$code" -eq 124 ]; then
    echo "check.sh не уложился в минуту"
fi

Код сохраняют в переменную сразу: следующая команда заменит $? своим кодом. Подробно о кодах — Код возврата.

timeout в cron

*/10 * * * * timeout 9m /home/ivan/sync.sh

Задача запускается раз в 10 минут, а timeout не даёт скрипту работать дольше 9 минут. Если скрипт завис, он не наложится на следующий запуск. Как устроены строки расписания — Планировщик cron.

Функции и alias не запускаются

timeout запускает отдельную программу. Функцию из скрипта или alias она не найдёт и вернёт код 127. Если нужна функция или цикл, запустите внутри timeout отдельный bash:

timeout 30s bash -c 'while ! test -f /tmp/ready; do sleep 1; done'

Команда ждёт появления файла /tmp/ready, но не дольше 30 секунд. Как работает цикл — Цикл while.

Ключи timeout

КлючЧто делает
-k 10sпослать KILL через 10 секунд после первого сигнала
-s INTпослать другой сигнал вместо TERM — имя или номер
-vсообщить в поток ошибок, какой сигнал послан
--preserve-statusвернуть код команды, даже если время вышло
--foregroundдать команде читать ввод с клавиатуры, когда timeout запущена из скрипта; дочерние процессы команды тогда по сроку не останавливаются

Ошибки и как их исправить

Что видноЧто значитЧто сделать
код 124команда не уложилась в срокувеличьте срок или найдите, где команда зависает
код 127 у функции или aliastimeout ищет программу, а не команду bashзапустите timeout 30s bash -c '…'
код 125 и ошибка про сроксрок записан неверно, например 1h30mодно число и один суффикс: 90m
программа не остановилась после срокаона перехватывает TERMдобавьте -k 10s

Источники

Сверено 20 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше