Here-document в bash: как передать команде текст в несколько строк
Here-document — это текст в несколько строк, который вы пишете прямо в скрипте и отдаёте команде вместо ввода с клавиатуры. Так удобно создать файл настроек, вывести справку или подготовить письмо.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Откройте новый файл в редакторе nano:
nano test.sh. - Вставьте текст скрипта из примера ниже.
- Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
- Запустите скрипт:
bash test.sh.
#!/bin/bash
name="Анна"
cat <<EOF
Привет, $name
2 + 2 = $((2 + 2))
EOFОтвет:
Привет, Анна
2 + 2 = 4Всё между строкой cat <<EOF и строкой EOF попало в команду cat, а она вывела текст на экран. Переменная и вычисление подставились.
Как это устроено
<<и слово после него — начало текста. Слово выбираете вы, EOF — просто привычная запись: можно END, TEXT, CONFIG.- Дальше идут строки текста.
- Текст заканчивается строкой, в которой стоит только это слово — без пробелов до и после.
Команда получает текст на вход так же, как получила бы его из файла через <. Подойдёт любая команда, которая читает ввод: cat, tee, mysql, ssh.
Текст без подстановок: <<'EOF'
Если слово после << взять в кавычки, bash не тронет ни $, ни обратные кавычки, ни $(...) — текст уйдёт как есть:
cat <<'EOF'
Привет, $name
2 + 2 = $((2 + 2))
EOFОтвет:
Привет, $name
2 + 2 = $((2 + 2))Такая запись нужна, когда вы пишете из скрипта другой скрипт или настройку, где знаки $ должны остаться. Если подстановки нужны, а один знак $ нет, поставьте перед ним обратную косую черту: \$5 выведет $5.
Записать текст в файл
Добавьте > и имя файла после <<'EOF' или перед ним. Пример создаёт маленький скрипт копии сайта:
cat > backup.sh <<'EOF'
#!/bin/bash
tar -czf "$HOME/site.tar.gz" -C /var/www site
EOF
cat backup.shОтвет:
#!/bin/bash
tar -czf "$HOME/site.tar.gz" -C /var/www siteЗнак $HOME остался в файле, потому что слово EOF в кавычках. > перезаписывает файл, >> дописывает текст в конец. Подробнее — в статье Перенаправление вывода.
Системный файл: sudo tee
Запись sudo cat > /etc/myapp.conf <<EOF не сработает: sudo получит только cat, а файл в /etc открывает ваша оболочка — без прав root, и в ответ будет Permission denied. Передайте текст команде tee, запущенной через sudo:
sudo tee /etc/myapp.conf > /dev/null <<'EOF'
port=8080
log=/var/log/myapp.log
EOFtee записывает текст в файл, а > /dev/null убирает его копию с экрана. Чтобы дописать в конец файла, а не заменить его, добавьте ключ -a: sudo tee -a. Подробнее — Команда tee и запись в системный файл через sudo.
Отступы: <<-
Внутри if или функции текст хочется сдвинуть вправо. С записью <<- bash уберёт в начале каждой строки знаки табуляции — и в тексте, и перед закрывающим словом:
if true; then
cat <<-END
строка с табуляцией
END
fiОтвет:
строка с табуляциейУбираются только табуляции. Пробелы остаются, и строка, где перед END стоят пробелы, не закроет текст. Если редактор заменяет табуляцию пробелами, не делайте отступ перед закрывающим словом.
Одна строка: <<<
Запись <<< передаёт команде одну строку — короче, чем echo и конвейер:
read first rest <<< "один два три"
echo "$first"
echo "$rest"
tr a-z A-Z <<< "hello"Ответ:
один
два три
HELLOПеременные, которые задал read, остаются в скрипте. Подробнее о read — Команда read.
Ошибки и как их исправить
| Что видно | Что значит | Что сделать |
|---|---|---|
| скрипт дочитан до конца, команды после текста не выполнились | bash не нашёл закрывающее слово | уберите пробелы до и после слова в последней строке текста |
| в файле пусто там, где была переменная | переменную подставили при записи | возьмите слово в кавычки: <<'EOF' |
| переменная не подставилась | слово стоит в кавычках | уберите кавычки: <<EOF |
| Permission denied при записи в /etc | файл открывает оболочка без прав root | пишите через sudo tee файл |
<<- не убрал отступ | в отступе пробелы, а не табуляция | уберите отступ перед закрывающим словом |
Источники
- Справка bash для Ubuntu 24.04 — разделы Here Documents и Here Strings: слово в кавычках отключает подстановки,
\$,<<-убирает табуляции. - Справка tee для Ubuntu 24.04 — ключ -a дописывает в конец файла.
- Справка sudo для Ubuntu 24.04 — sudo запускает с правами root только указанную команду.
Сверено 20 октября 2026 года.
Что почитать дальше
- Команда teeзапись в файл с правами root.
- Перенаправление выводазнаки
>,>>и<. - Кавычки в bashкогда bash подставляет переменные.
- Команда readread и строка <<<.