Что мы делаем: минимальный bash-скрипт за пять шагов
Рабочий bash-скрипт состоит из четырёх элементов: shebang в первой строке, строгий режим set -euo pipefail, тело с командами и явный exit с кодом возврата. Пятый шаг, который пропускают чаще всего, это проверка результата через echo $?.
Минимальный файл hello.sh:
#!/usr/bin/env bash set -euo pipefail echo "Hello from bash" exit 0
Полный цикл от пустого каталога до проверки кода возврата:
touch hello.sh nano hello.sh chmod +x hello.sh ./hello.sh echo $?
Вывод: строка Hello from bash, затем 0. Пример отрабатывает в Debian/Ubuntu, RHEL и AlmaLinux, а также в Alpine с установленным пакетом bash. Версию смотрите через bash --version. Конкретные версии, в которых появились массивы, [[ ]] и set -o pipefail, здесь не фиксируем: сверяйтесь с документацией вашего дистрибутива и выводом bash --version.
Пять шагов по порядку:
- Создать файл: touch hello.sh.
- Добавить shebang #!/usr/bin/env bash первой строкой, без BOM и пробелов впереди.
- Написать тело: команды, переменные и exit 0 в конце.
- Выдать право на исполнение: chmod +x hello.sh.
- Запустить ./hello.sh и сразу проверить код возврата через echo $?.
Shebang в bash-скрипте: зачем нужна первая строка
Shebang это первые два байта #!, по которым ядро понимает, что файл нужно передать интерпретатору, а не исполнять как бинарник. При запуске ./hello.sh ядро читает строку #!/usr/bin/env bash, находит программу по указанному пути и передаёт ей файл аргументом.
Без shebang ядро возвращает ENOEXEC (Exec format error), после чего вызывающая оболочка может сама интерпретировать скрипт. Поведение зависит от оболочки: bash и zsh выполняют файл сами, а некоторые POSIX-совместимые оболочки могут вести себя иначе. POSIX предписывает при ENOEXEC вызывать командный интерпретатор, но это соглашение библиотеки C, а не поведение ядра. Скрытая ловушка: синтаксис, который работает в bash, молча сломается, если файл подхватит sh. Для скрипта с массивами, [[ ]] и local shebang обязателен. Подробный разбор поведения ядра и оболочки при отсутствии shebang есть в материале Bash Script Execution With and Without Shebang, а обсуждение того, какая оболочка подхватывает файл без shebang, на Unix Stack Exchange.
Два варианта первой строки:
- #!/bin/bash жёстко привязан к пути. Подходит для серверных систем, где bash стоит в /bin/bash, и для контейнеров с фиксированным базовым образом.
- #!/usr/bin/env bash ищет bash в PATH. Выигрывает при переносимости: macOS с bash 3.2 в /bin, nix-окружения, контейнеры, где bash лежит в /usr/local/bin. Логика выбора через env разобрана на Stack Overflow.
Требования к строке: shebang стоит первым, до него нет ни пробелов, ни BOM. Пробел между #! и путём лучше не ставить: поведение разбора shebang в таком случае зависит от ядра и оболочки, поэтому надёжнее держать строку строго в виде #!/usr/bin/env bash.
Правило: при прямом запуске (./script.sh, cron, systemd) shebang нужен; при запуске bash script.sh первая строка игнорируется, интерпретатор задан явно.
Структура bash-скрипта: каркас, который не стыдно запускать на проде
Каркас, который масштабируется до сотен строк:
#!/usr/bin/env bash
# Назначение: чистит каталог логов старше 7 дней
set -euo pipefail
readonly LOG_DIR="${1:?usage: cleanup.sh LOG_DIR}"
readonly RETENTION_DAYS=7
log() {
printf '%s %s\n' "$(date -u +%FT%TZ)" "$*" >&2
}
main() {
[[ -d "$LOG_DIR" ]] || { log "нет каталога: $LOG_DIR"; exit 1; }
log "чистим $LOG_DIR, порог ${RETENTION_DAYS} дней"
find "$LOG_DIR" -type f -name '*.log' -mtime +"$RETENTION_DAYS" -delete
log "готово"
}
main "$@"
Разбор set -euo pipefail:
- -e завершает скрипт при ненулевом коде возврата любой команды. Внутри условий if и в левой части && или || он не срабатывает, это даёт управляемые исключения.
- -u превращает обращение к незаданной переменной в ошибку. Ловит опечатки в именах и пустые аргументы до того, как они попадут в rm.
- -o pipefail возвращает код последней упавшей команды в пайпе. Без него cmd1 | cmd2 отдаст код cmd2, и падение первого шага пройдёт незамеченным.
Правила, которые экономят часы отладки:
- Оборачивайте подстановки в кавычки: "$VAR", "$@", "$(команда)". Без кавычек пробелы в путях разбивают аргумент на части.
- Используйте $(...) вместо обратных кавычек: вложенность читается, экранирование проще.
- Не разбирайте вывод ls. Для поиска файлов есть find, для шаблонов сам bash: for f in "$DIR"/*.log.
- Объявляйте константы через readonly и в верхнем регистре, локальные переменные в функциях через local.
- Прогоняйте shellcheck перед коммитом: он ловит незакавыченные переменные, неверные сравнения и мёртвые условия.
Детальный разбор строгого режима, IFS, getopts и trap с готовыми фрагментами есть в материале Bash-скрипты для администрирования Linux: структура, set -euo pipefail и чек-лист.
Переменные, кавычки и аргументы
Аргументы приходят в $1, $2 и далее, полный список хранится в "$@" (каждый аргумент отдельным словом) и "$*" (одна строка через первый символ IFS). Для передачи в функцию или внешнюю команду почти всегда нужен "$@".
#!/usr/bin/env bash
set -euo pipefail
SRC="${1:?usage: sync.sh SRC DST}"
DST="${2:?usage: sync.sh SRC DST}"
rsync -a --delete "$SRC"/ "$DST"/
Конструкция ${1:?...} печатает сообщение и выходит с кодом 1, если аргумент пуст или не задан. Эффект: скрипт с незаданным путём не начнёт работу с пустой строкой, которая в rsync или rm означает не то, что ожидал автор.
Сравнение ловушек:
- cp $SRC $DST ломается на пути с пробелом: /var/www/my site превращается в два аргумента.
- cp "$SRC" "$DST" работает с пробелами и спецсимволами, а пустую строку уже отсекает ${VAR:?}.
- for f in $LIST разбивает список по пробелам; для построчного чтения из файла используйте while IFS= read -r line.
Функции и точка входа main
#!/usr/bin/env bash
set -euo pipefail
backup() {
local target="${1:?target required}"
tar -czf "$target.tar.gz" -C /var/www .
}
main() {
backup "$@"
}
main "$@"
Вызов main "$@" стоит последней строкой. Приём даёт три выгоды: все действия собраны в одном месте, тело скрипта можно подключить через source и переиспользовать функции в тестах, порядок объявления функций перестаёт влиять на логику. Внутри функций держите local, иначе переменные протекут в глобальную область и перезапишут константы.
Как создать bash-скрипт: файл, права и chmod +x
touch script.sh nano script.sh # или vim, micro, mcedit chmod +x script.sh ls -l script.sh file script.sh
ls -l покажет права вида -rwxr-xr-x, file вернёт ASCII text executable или UTF-8 Unicode text executable. Если file сообщает "with CRLF line terminators", переходите к разделу про переводы строк: в таком виде скрипт не запустится.
Альтернатива редактору, heredoc прямо в терминале:
cat > script.sh <<'EOF' #!/usr/bin/env bash set -euo pipefail echo "ok" EOF
Кавычки вокруг EOF отключают подстановку переменных: в файл попадёт текст как есть. Без кавычек bash раскроет $VAR уже на этапе записи, и в скрипте окажется вычисленное значение.
Что делает chmod +x: это символьная запись режима, где who может быть u, g, o или a, а операция применяется к текущим битам режима файла. Грамматика символьного режима и компоненты who описаны в man-странице chmod(1). Конкретный набор битов, которые добавит +x, зависит от umask и текущих прав файла, поэтому проверяйте результат через ls -l. Символьная запись umask трактуется так же, как операнд mode в chmod, это описано в man-странице umask(1p). Для скрипта в общем каталоге широких прав не нужно. Минимально достаточные варианты: chmod 750 script.sh для владельца и группы, chmod 700 script.sh для личного каталога. Права 777 не нужны никогда: они дают право записи любому пользователю в системе, а запись в исполняемый файл равна выполнению произвольного кода.
Для запуска через bash script.sh бит x не требуется, хватает права на чтение. Это удобно для скриптов из репозитория, которые вы не хотите помечать исполняемыми до ревью.
Базовые команды работы с файлами и разбор ключей ls есть в шпаргалке Базовые команды Linux: шпаргалка с примерами для начинающих администраторов.
./script.sh или bash script.sh: чем отличаются способы запуска
Способы отличаются процессом и окружением, а не набором выполняемых команд.
| Способ | Нужен shebang | Нужен бит x | Где выполняется | Когда использовать |
|---|---|---|---|---|
| ./script.sh | Да | Да | Дочерний процесс, интерпретатор из shebang | Прод, cron, systemd |
| bash script.sh | Нет | Нет | Дочерний процесс, интерпретатор задан вручную | Отладка, файл без бита x |
| bash -x script.sh | Нет | Нет | То же плюс трассировка каждой команды | Поиск места падения |
| source script.sh или . script.sh | Нет | Нет | Текущая оболочка, без нового процесса | Загрузка функций и переменных |
Практическая разница: после source изменения остаются в вашей сессии (переменные, cd, alias), после ./script.sh исчезают вместе с дочерним процессом. Для деплой-скрипта source опасен: cd внутри файла уведёт текущую оболочку, а exit завершит сессию целиком. Готовый пример такого сценария с dry-run и откатом разобран в гайде Как написать скрипт развёртывания для Linux: 6 шагов с готовыми примерами.
bash -x script.sh печатает каждую команду с раскрытыми переменными в stderr. Строка с плюсом в начале показывает фактическое значение, это быстрее, чем расставлять echo по телу.
PATH: скрипт с битом x в каталоге из PATH (/usr/local/bin, ~/bin) вызывается по имени, без ./ и без пути. Текущий каталог в PATH по умолчанию отсутствует, поэтому ./ обязателен: система не запустит случайный файл из скачанного архива.
Первый запуск: проверка результата через echo $?
$? хранит код возврата последней выполненной команды. 0 означает успех, любое другое значение сигнализирует об ошибке. Практический диапазон, на который стоит ориентироваться в скриптах, это 0-255; конкретное поведение при выходе за границы зависит от оболочки, поэтому не полагайтесь на коды больше 255.
./hello.sh echo $? # 0
#!/usr/bin/env bash set -euo pipefail exit 1
./fail.sh; echo $? # 1 ./fail.sh && echo OK || echo FAIL # FAIL
Частые коды в оболочке: 126 команда вызвана, но не может быть выполнена (например, нет права на исполнение), 127 команда не найдена, 130 завершение скрипта по Ctrl+C, 128+n фатальная ошибка по сигналу n. Сводка стандартных кодов возврата с пояснениями приведена на Stack Overflow. Если cron-задача молча не работает, первым делом проверяйте код возврата и stderr.
set -e останавливает скрипт на первой ошибке изнутри, но снаружи код возврата всё равно нужно проверять. Шаблон для CI:
if ! ./script.sh; then
echo "deploy failed" >&2
exit 1
fi
Обратная сторона set -e: команда с ожидаемым ненулевым кодом (grep без совпадений, diff между разными файлами) оборвёт скрипт. Оборачивайте такие вызовы в if или добавляйте || true с комментарием, зачем это сделано.
UTF-8/BOM и CRLF: почему скрипт не запускается и как это исправить
Симптомы:
- /usr/bin/env: bad interpreter: No such file or directory, иногда с \r внутри текста ошибки.
- ./script.sh: line 1: $'\r': command not found.
- В выводе cat -A видны символы ^M в конце строк.
Причина одна: файл сохранён в Windows с переводами строк CRLF, где каждая строка заканчивается на \r\n, либо в начале файла стоит BOM (байты EF BB BF). Ядро ищет интерпретатор по строке с невидимым \r на конце и не находит файл с таким именем. BOM сдвигает первые байты, и вместо #! там оказывается 0xEF.
Диагностика:
file script.sh cat -A script.sh | head -3 head -c 16 script.sh | hexdump -C
Исправление, по возрастанию радикальности:
- dos2unix script.sh, самый предсказуемый способ.
- sed -i 's/\r$//' script.sh, если dos2unix не установлен.
- Пересохранить файл в редакторе как UTF-8 без BOM и с LF. В VS Code это переключатель CRLF/LF в правом нижнем углу и пункт Save with Encoding.
Чтобы проблема не вернулась после коммита из Windows, добавьте в .gitattributes строку *.sh text eol=lf. Git нормализует переводы строк при checkout, и в репозиторий попадёт LF. Проверка после правки: bash -n script.sh, синтаксический разбор без выполнения.
Чек-лист перед тем, как отдать скрипт в прод
- Shebang на первой строке, без BOM и пробелов перед #!.
- set -euo pipefail сразу после комментария с назначением.
- Все подстановки в кавычках, списки аргументов через "$@".
- shellcheck без замечаний уровня error и warning.
- bash -n script.sh проходит, bash -x показывает ожидаемые значения переменных.
- echo $? после запуска возвращает 0 на штатном сценарии.
- Права 750 или 700, не 777; владелец тот, кому скрипт нужен.
- Файл в LF, UTF-8 без BOM, .gitattributes фиксирует *.sh text eol=lf.
- Логи и ошибки идут в stderr через >&2, код возврата явный.
- Скрипт идемпотентен: повторный запуск не ломает систему и не дублирует данные.
- Деструктивные операции защищены: rm -rf "${DIR:?DIR is empty}" отсекает пустую переменную.
- Секретов в теле нет, пароли читаются из файла с правами 600 или из переменных окружения.
Три типовые грабли новичка: sudo внутри скрипта (запускайте файл от нужного пользователя, а не просите пароль посреди работы), зависимость от PATH в cron (там PATH короче, используйте абсолютные пути или задайте PATH в начале), относительные пути (cd "$(dirname "$0")" или полностью абсолютные).
Как убрать пароли из скриптов и ограничить привилегии через sudo -l, разбираем в материале Безопасность скриптов администрирования в 2026 году: права, секреты и аудит. Когда логика перерастает bash и появляются REST API, JSON и YAML, смотрите Python для админских скриптов: когда bash уже не справляется.
Следующий шаг: возьмите свою повторяющуюся задачу, оберните её в каркас из этой статьи, прогоните shellcheck и bash -n, затем запустите на тестовом окружении. Один скрипт с кодом возврата и логами в stderr заменяет десяток ручных команд, которые забываются между деплоями.