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

Here-document в bash: как передать команде текст в несколько строк

Here-document — это текст в несколько строк, который вы пишете прямо в скрипте и отдаёте команде вместо ввода с клавиатуры. Так удобно создать файл настроек, вывести справку или подготовить письмо.

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

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

  1. Подключитесь к серверу — инструкция.
  2. Откройте новый файл в редакторе nano: nano test.sh.
  3. Вставьте текст скрипта из примера ниже.
  4. Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
  5. Запустите скрипт: 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
EOF

tee записывает текст в файл, а > /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 файл
<<- не убрал отступв отступе пробелы, а не табуляцияуберите отступ перед закрывающим словом

Источники

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

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

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