Как написать bash-скрипт с нуля: структура, shebang и первый запуск в Linux | AdminWiki

Как написать bash-скрипт с нуля: структура, shebang и первый запуск в Linux

16 ноября 2026 11 мин. чтения

Что мы делаем: минимальный 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.

Пять шагов по порядку:

  1. Создать файл: touch hello.sh.
  2. Добавить shebang #!/usr/bin/env bash первой строкой, без BOM и пробелов впереди.
  3. Написать тело: команды, переменные и exit 0 в конце.
  4. Выдать право на исполнение: chmod +x hello.sh.
  5. Запустить ./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

Исправление, по возрастанию радикальности:

  1. dos2unix script.sh, самый предсказуемый способ.
  2. sed -i 's/\r$//' script.sh, если dos2unix не установлен.
  3. Пересохранить файл в редакторе как 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 заменяет десяток ручных команд, которые забываются между деплоями.

Поделиться: