Коротко: как записать вывод bash-скрипта в файл
Стандартный вывод (stdout, дескриптор 1) уходит в файл оператором > file с перезаписью или >> file с дозаписью. Ошибки идут отдельным потоком stderr (дескриптор 2): без перенаправления они остаются в терминале, даже когда stdout уже пишется в файл. Чтобы оба потока попали в один лог, поставьте 2>&1 после > file. Чтобы одновременно видеть вывод и хранить копию, добавьте в конвейер tee или tee -a.
Для длинного скрипта есть приём на весь файл: exec > >(tee -a logfile) 2>&1 в начале. После этой строки каждый echo, printf и вывод внешних команд дублируется в терминал и в лог с дозаписью.
Примеры рассчитаны на bash 4 и новее. В dash, busybox ash и частично в zsh синтаксис отличается, поэтому проверяйте приёмы в целевом окружении до выкатки.
Мини-шпаргалка: задача → команда
| Задача | Команда |
|---|---|
| Перезаписать stdout в файл | cmd > file |
| Дописать stdout в конец файла | cmd >> file |
| Записать stdout и stderr в один файл | cmd > file 2>&1 |
| Дописать оба потока | cmd >> file 2>&1 |
| Видеть stdout и перезаписать файл | cmd | tee file |
| Видеть stdout и дописать файл | cmd | tee -a file |
| Видеть оба потока и дописать файл | cmd 2>&1 | tee -a file |
| Развести потоки по разным файлам | cmd > out.log 2> err.log |
| Bash-сокращение для двух потоков | cmd &>> file |
| Дублировать весь скрипт в лог | exec > >(tee -a logfile) 2>&1 |
Порядок операторов значим: 2>&1 работает только после того, как stdout уже перенаправлен. Строка cmd 2>&1 > file отправит ошибки в терминал, а в файл положит один stdout. Механику разбираем ниже.
Оператор > обрезает файл до запуска команды. Если команда упадёт на первом шаге, вы получите пустой лог и потеряете предыдущий. Для логов используйте >> или tee -a, а > оставьте для разовых выгрузок.
В конвейере с tee код возврата по умолчанию берётся от tee, а не от вашей команды. Включайте set -o pipefail, иначе скрипт посчитает упавший шаг успешным.
stdout и stderr: зачем разделять потоки и как это влияет на логи
Каждый процесс в Linux получает три стандартных файловых дескриптора: 0 (stdin), 1 (stdout) и 2 (stderr). Ядро не различает полезный вывод и диагностику, это соглашение самих программ: результат работы пишется в 1, сообщения об ошибках и предупреждения в 2. Bash меняет адреса, куда указывают эти дескрипторы, и передаёт новые адреса дочерним процессам.
Отсюда типичная ситуация: строка ./backup.sh > /var/log/backup.log пишет в файл только успешный вывод, а сообщения rsync об ошибках остаются на экране. Ночью скрипт отработал по cron, лог пустой, причина сбоя потеряна вместе с закрытой сессией ssh.
Разделение потоков даёт три практических выгоды. Поиск по логу ошибок идёт по файлу в десятки строк вместо мегабайтов прогресса. Файлы ротируются независимо: успешный лог можно сжимать и хранить неделю, ошибки месяц. Шум от прогресса не мешает grep по ERROR в отдельном файле.
Почему 2>&1 работает только в правильном порядке
Запись 2>&1 не объединяет потоки, а копирует текущую цель дескриптора 1 в дескриптор 2 на момент выполнения. Bash обрабатывает перенаправления слева направо, поэтому важен порядок.
# ошибки уйдут в терминал, в файле только stdout bash -c 'echo out; echo err >&2' 2>&1 > /tmp/out.log # оба потока в файле bash -c 'echo out; echo err >&2' > /tmp/out.log 2>&1
Проверка занимает секунду: cat /tmp/out.log. В первом случае в файле одна строка out, во втором две. Тот же результат даёт сокращение &> file, это bash-форма записи > file 2>&1, в POSIX sh её нет.
Раздельные логи stdout и stderr
./backup.sh > /var/log/backup.out.log 2> /var/log/backup.err.log
В терминале при таком запуске не видно ничего. Если нужно и разделить файлы, и следить за процессом, продублируйте каждый поток своим tee:
./backup.sh > >(tee -a /var/log/backup.out.log) 2> >(tee -a /var/log/backup.err.log >&2)
Конструкция > >(...) требует bash. Порядок строк между потоками в терминале не гарантирован, и на каждый поток появляется отдельный процесс tee. Для большинства задач проще писать всё в один лог с префиксом уровня (шаблон ниже) и не платить за два конвейера и две ротации.
tee и tee -a: видеть вывод в терминале и писать в файл
tee читает stdin и пишет в stdout и в файлы из аргументов. Отсюда рабочий однострочник для отладки и CI:
./deploy.sh 2>&1 | tee -a /var/log/deploy.log
tee file перезаписывает файл при каждом запуске, tee -a дописывает в конец. Разница та же, что между > и >>. Сам tee печатает в stdout, поэтому конвейер можно продолжать: ./deploy.sh 2>&1 | tee -a deploy.log | grep -E "ERROR|FATAL".
В CI-раннере без tty tee всё равно печатает строки в журнал задачи, так что лог сборки в веб-интерфейсе и файл на агенте остаются синхронными.
Код возврата и pipefail при использовании tee
Конвейер по умолчанию возвращает код последней команды. В false | tee /tmp/t.log код будет 0, хотя исходная команда упала. Скрипт с set -e в такой ситуации не остановится и пойдёт дальше по разрушительному сценарию.
false | tee /tmp/t.log; echo "rc=$?" # rc=0 set -o pipefail false | tee -a /tmp/t.log; echo "rc=$?" # rc=1
С включённым pipefail код возврата конвейера равен коду самой правой команды, завершившейся с ненулевым статусом, или нулю, если все команды конвейера успешны. По умолчанию опция отключена. Поэтому падение исходной команды больше не маскируется. Побочный эффект полезен: если сам tee не смог записать файл (нет прав, кончилось место), скрипт тоже остановится. Копии лога нет, продолжать смысла нет.
Переносимость проверяйте в целевом окружении: не все оболочки поддерживают pipefail и process substitution одинаково. Проверьте окружение через echo "$BASH_VERSION" и ls -l /bin/sh, а на Debian и Ubuntu помните, что /bin/sh обычно указывает на dash.
exec > >(tee -a logfile): дублирование всего вывода скрипта
exec без команды применяет перенаправление к текущей оболочке. Весь последующий вывод скрипта и всех его дочерних процессов уходит в файл и остаётся в терминале.
#!/usr/bin/env bash
set -Eeuo pipefail
LOG_FILE="${LOG_FILE:-/var/log/${0##*/}.log}"
exec > >(tee -a "$LOG_FILE") 2>&1
echo "start"
echo "warning: free space below 10%" >&2
Порядок важен и здесь: сначала stdout получает адрес пайпа в tee, затем stderr дублируется на тот же адрес. Вариант exec 2>&1 > >(tee -a "$LOG_FILE") оставит ошибки в терминале и не положит их в лог.
Если нужно гарантировать запись в исходный терминал после любых дальнейших перенаправлений stdout, сохраните его на свободный дескриптор:
exec 3>&1 exec > >(tee -a "$LOG_FILE" >&3) 2>&1
Ограничения и подводные камни exec с tee
- Только bash. >(...) это process substitution, в dash и busybox ash такой синтаксис даёт ошибку разбора, скрипт не запустится вообще. Переносимая альтернатива: обернуть тело в { ... ; } 2>&1 | tee -a "$LOG_FILE".
- Хвост лога может потеряться. tee работает отдельным процессом, а код возврата подставленного процесса не доступен напрямую в $? — там виден только статус потребителя. Приём с сохранением PID подстановки в $! и ожиданием в trap EXIT не подтверждён документацией: проверьте его на тестовом запуске в вашей версии bash, прежде чем полагаться на него в продакшене.
- Буферизация. Программа, чей stdout стал пайпом, может перейти с построчной буферизации на блочную, и хвост из буфера теряется при аварийном завершении. Обычно stdout построчно буферизован, и при завершении аргумента printf переводом строки строку можно ожидать сразу. Для принудительной построчной буферизации используйте stdbuf --output=L ./tool (режим L — построчный, 0 — небуферизованный, число — полная буферизация с указанным размером). Учтите: если команда сама меняет буферизацию своих потоков (например, tee), это переопределяет stdbuf, а фильтры вроде dd и cat не используют потоки для I/O и потому не подвержены его действию. Встроенные echo и printf пишут сразу, их это не касается.
- tee может умереть. Если кончилось место или файл удалили, tee завершится, пайп закроется, и запись в stdout начнёт возвращать SIGPIPE. Скрипт при этом способен упасть в неожиданном месте.
- Права и рост файла. Лог открывается от имени пользователя скрипта, и без ротации он растёт до заполнения диска.
Самопроверка приёма:
cat > /tmp/exec-test.sh <<'EOF' #!/usr/bin/env bash set -Eeuo pipefail exec > >(tee -a /tmp/exec-test.log) 2>&1 echo "to stdout" echo "to stderr" >&2 EOF chmod +x /tmp/exec-test.sh rm -f /tmp/exec-test.log /tmp/exec-test.sh cat /tmp/exec-test.log
В терминале и в файле должны появиться обе строки. Запустите скрипт дважды: с tee -a файл должен содержать четыре строки, а не две.
Защита от потери вывода при падении скрипта
Строгий режим задаёт предсказуемое поведение: set -e останавливает скрипт на ошибке, set -u запрещает обращение к неинициализированным переменным, set -o pipefail сохраняет код ошибки в конвейере, set -E передаёт ERR-ловушку внутрь функций и подстановок. Разбор типичных ошибок строгого режима и готовый каркас есть в материале про структуру bash-скриптов для администрирования Linux.
set -e не срабатывает в условиях: команда внутри if, в левой части && или ||, а также в конвейере без pipefail. Такие места проверяйте явно через if ! cmd; then. Перенаправления ставьте до первого рискованного вызова: если exec идёт после монтирования или долгого rsync, вывод этих шагов в лог не попадёт.
trap для фиксации кода выхода и строки ошибки
set -Eeuo pipefail trap 'rc=$?; printf "%s [ERROR] rc=%s line=%s cmd=%s\n" \ "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$rc" "$LINENO" "$BASH_COMMAND" >&2' ERR trap 'printf "%s [INFO] finish rc=%s\n" \ "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$?" >&2' EXIT
ERR-ловушка печатает код возврата, номер строки и упавшую команду, EXIT фиксирует завершение при любом исходе. Ставьте оба trap до потенциально опасных участков: ловушка, включённая после rsync, про падение rsync уже ничего не расскажет. Поведение LINENO внутри ERR-ловушки зависит от версии bash и может указывать на строку с trap — проверьте фактический вывод на своём хосте, прежде чем строить на номере строки автоматику.
Границы приёма: SIGKILL, OOM-killer и отключение питания не перехватываются. Данные, уже отданные в write(), при SIGKILL выживают в page cache и будут сброшены ядром, а stdio-буфер процесса пропадёт. Поэтому построчный вывод и stdbuf там, где важна каждая строка.
Для отладочной трассировки держите set -x отдельно от основного лога:
exec 4>>/var/log/deploy.trace BASH_XTRACEFD=4 set -x
BASH_XTRACEFD направляет трассировку в указанный дескриптор; при сбросе или установке нового значения BASH_XTRACEFD старый дескриптор закрывается. Доступность переменной проверьте в вашей версии bash. Не включайте set -x на участках, где в аргументах бывают пароли и токены: трассировка печатает их открытым текстом. Сценарии отката и обработки частично применённых изменений при деплое разобраны в статье про обработку ошибок и логирование в скриптах развёртывания.
Готовый шаблон логирования с датой и уровнем
Шаблон даёт единый формат строки: время в ISO-8601 по UTC, уровень, сообщение. Всё пишется в stderr, поэтому конструкция работает и с exec-дублированием, и при обычном запуске в терминале.
#!/usr/bin/env bash
set -Eeuo pipefail
LOG_FILE="${LOG_FILE:-/var/log/myscript.log}"
umask 027
log() {
local level="$1"
shift
printf '%s [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$level" "$*" >&2
}
info() { log INFO "$@"; }
warn() { log WARN "$@"; }
error() { log ERROR "$@"; }
: >>"$LOG_FILE" || { echo "cannot write $LOG_FILE" >&2; exit 1; }
exec > >(tee -a "$LOG_FILE") 2>&1
trap 'error "failed rc=$? line=$LINENO cmd=$BASH_COMMAND"' ERR
trap 'info "finished rc=$?"' EXIT
info "start pid=$$ host=$(hostname)"
DATA_DIR="${DATA_DIR:-/srv/data}"
info "sync from $DATA_DIR"
# rsync -a --delete "$DATA_DIR/" /backup/latest/
info "done"
Пример вывода:
2026-11-16T09:14:02Z [INFO] start pid=2481 host=backup-01 2026-11-16T09:14:02Z [INFO] sync from /srv/data 2026-11-16T09:14:37Z [ERROR] failed rc=23 line=24 cmd=rsync -a --delete /srv/data/ /backup/latest/ 2026-11-16T09:14:37Z [INFO] finished rc=23
UTC и суффикс Z дают сортируемые строки, которые сходятся с journald и централизованным сборщиком. Нужно локальное время, замените date -u на date -Is без -u, но не смешивайте оба варианта в одном файле. Шаблон рассчитан на bash и требует проверки в вашем окружении: путь к логу, права и доступность tee зависят от инфраструктуры.
Права на файл лога и ротация
Логи содержат имена хостов, пути и иногда токены из аргументов, поэтому ограничьте доступ. umask 027 создаёт файл с правами 640, umask 077 с правами 600. Для заранее созданного файла используйте install -m 0640 -o root -g adm /dev/null /var/log/myscript.log. Каталог /var/log не должен быть доступен на запись обычным пользователям.
Не пишите в лог секреты: пароли, токены, содержимое .env и заголовки Authorization. Практика выноса секретов в файл с правами 600 и ограничения привилегий описана в статье про безопасность скриптов администрирования. Там же приёмы контроля молча сломанного cron.
Для скрипта, который держит файл открытым через exec, ротация требует copytruncate: при переименовании старый дескриптор продолжает указывать на переименованный файл, и скрипт пишет в архив, пока процесс жив. copytruncate создаёт копию файла журнала, а затем обрезает исходный файл вместо перемещения старого файла и создания нового — это как раз случай, когда программе нельзя указать закрыть её журнал. С помощью директивы olddir ротированные копии можно хранить на другом устройстве.
/var/log/myscript.log {
weekly
rotate 8
maxsize 100M
compress
delaycompress
missingok
notifempty
copytruncate
}
Директива create при copytruncate не имеет силы: старый файл журнала остаётся на своём месте и обрезается, а не создаётся заново. Проверьте конфиг без применения: logrotate -d /etc/logrotate.d/myscript. Между копированием и обрезкой проходит очень маленький промежуток времени, но часть записанных строк может потеряться; при жёстких требованиях к полноте логов держите отдельный файл на запуск с датой в имени и чистите старые через find -mtime. Тонкости journald, syslog и ротации логов скриптов разобраны в статье про логирование и обработку ошибок в скриптах администрирования.
Чек-лист и проверка на практике
Прогоните настройку на тестовом скрипте до выкатки. Минимальный набор проверок:
- Перенаправления стоят в начале скрипта, до первого рискованного вызова.
- Порядок 2>&1 проверен: ошибки реально попадают в файл.
- set -Eeuo pipefail включён, конвейеры с tee не маскируют код ошибки.
- ERR и EXIT trap настроены, в логе видно код возврата и строку.
- Лог открывается от имени пользователя скрипта, каталог доступен на запись.
- Права на файл не шире 0640, секретов в логе нет.
- Ротация настроена, свободное место под /var/log под контролем мониторинга.
- Поведение при аварийном завершении проверено: kill -9 во время работы не оставляет лог без последних записей.
Полный тест из четырёх блоков:
# 1. Порядок перенаправлений bash -c 'echo out; echo err >&2' > /tmp/t1.log 2>&1 grep -c . /tmp/t1.log # ожидаем 2 # 2. pipefail и код возврата set -o pipefail false | tee -a /tmp/t2.log; echo "rc=$?" # ожидаем rc=1 # 3. Дублирование через exec /tmp/exec-test.sh > /dev/null # в терминале пусто, в логе строки grep -c "to stderr" /tmp/exec-test.log # 4. Права на лог ls -l /var/log/myscript.log # -rw-r----- root adm
Если пункт расходится с ожиданием, начинайте с проверки оболочки: bash --version и ls -l /bin/sh. На Debian и Ubuntu /bin/sh обычно указывает на dash, и скрипт с process substitution через sh не запустится.
Дальше настройте ротацию и мониторинг размера лога, а обработку кодов возврата и уведомления о сбоях вынесите в отдельный слой: systemd OnFailure, webhook или внешний чекер. Скрипт, который пишет разборчивый лог и возвращает корректный код, сходится с любой из этих схем без доработок.
Источники
- stdbuf(1) — Linux manual page: режимы буферизации L, 0 и числовой; переопределение stdbuf самой командой и фильтры вроде dd и cat.
- Force line-buffering of stdout in a pipeline: построчная буферизация stdout и приём stdbuf --output=L.
- What is the meaning of set -o pipefail in Bash: код возврата конвейера и поведение pipefail по умолчанию.
- The Exit Status of Piped Processes — Baeldung on Linux: код последней команды конвейера и pipefail.
- logrotate(8) — Linux manual page: директива olddir и хранение ротированных копий на другом устройстве.
- logrotate(8) — проект OpenNet: copytruncate, потеря части данных между копированием и обрезкой, отсутствие силы директивы create.
- Справочник по командному процессору Bash: закрытие дескриптора BASH_XTRACEFD при сбросе или установке нового значения.
- Bash Coding Standard: Process substitution: недоступность кода выхода подставленного процесса через $?.
- Redirect copy of stdout to log file from within bash script itself: синтаксис exec > >(tee log.txt) не понимается в Busybox без bash.