Настройка bash в 2026: .bashrc, .bash_profile, .profile и переменные окружения без сюрпризов | AdminWiki

Настройка bash в 2026: .bashrc, .bash_profile, .profile и переменные окружения без сюрпризов

15 ноября 2026 12 мин. чтения

Коротко: какой файл за что отвечает

Три файла делят одну работу, и путаница между ними даёт классический симптом: по SSH алиасы работают, а в новой вкладке терминала их нет. Короткий ответ: ~/.bash_profile читает login-оболочка (вход по SSH, su -, bash -l, вход в TTY), ~/.bashrc читает интерактивная оболочка без логина (новая вкладка терминала, панель tmux, bash -i), а ~/.profile подхватывается только тогда, когда bash не нашёл ни ~/.bash_profile, ни ~/.bash_login.

Рабочее правило простое. Алиасы, приглашение, HISTCONTROL и прочие интерактивные настройки живут в ~/.bashrc. PATH и экспорты, которые должны видеть дочерние процессы, задавайте один раз и подключайте этот файл из login-оболочки. Тогда конфиг не расходится между SSH-сессией и локальным терминалом.

Порядок чтения файлов и синтаксис в bash 5.x те же, что в bash 4.x: «2026» в заголовке про дисциплину проверки и инструменты вроде shellcheck, а не про новый формат конфигов. Порядок стартовых файлов описан в Bash Reference Manual, раздел Bash Startup Files.

Матрица: .bashrc vs .bash_profile vs .profile

ФайлКогда читаетсяЧто кластьПодводный камень
~/.bashrcИнтерактивная оболочка без логина: новая вкладка терминала, tmux, bash -iАлиасы, функции, HISTCONTROL, HISTSIZE, приглашение, при необходимости PATHLogin-сессия по SSH его не прочитает, если не подключить из ~/.bash_profile
~/.bash_profileLogin-оболочка: ssh user@host, su -, bash -l, вход в TTYЭкспорты для дочерних процессов, подключение ~/.bashrcНе читается новой вкладкой терминала, поэтому алиасы здесь «не работают»
~/.bash_loginLogin-оболочка, если нет ~/.bash_profileТо же, что в .bash_profileВторой в очереди: при наличии .bash_profile игнорируется целиком
~/.profileLogin-оболочка, если нет ни .bash_profile, ни .bash_loginPOSIX-совместимые экспорты и PATHИгнорируется при наличии .bash_profile: частая причина «переменная не подхватилась»
/etc/profile, /etc/profile.d/*.shLogin-оболочка, до пользовательских файловСистемные переменные для всех пользователейПравка влияет на всех: проверяйте отдельно от своего пользователя
/etc/bash.bashrc, /etc/bashrcИнтерактивная оболочка, до ~/.bashrcСистемные алиасы и подсказкиИмя зависит от дистрибутива: bash.bashrc в Debian и Ubuntu, bashrc в RHEL-семействе

Системные файлы трогайте только при необходимости: /etc/profile и /etc/bash.bashrc действуют на всех пользователей хоста. Если переменные нужны всем, аккуратнее добавлять отдельный файл в /etc/profile.d/, который подключает /etc/profile. Пример такой схемы для прокси и http_proxy, https_proxy, no_proxy разобран в материале о настройке прокси на системном уровне.

Почему алиасы «пропадают» после SSH

На одном хосте вы попадаете в разные режимы оболочки. ssh user@host запускает login shell: bash читает /etc/profile и первый найденный файл из ~/.bash_profile, ~/.bash_login, ~/.profile. Новая вкладка в графическом терминале запускает интерактивную оболочку без логина, и там читается ~/.bashrc. Если алиасы лежат только в ~/.bash_profile, в новой вкладке их не будет.

Проверка режима занимает секунду. echo $0 покажет -bash с дефисом в начале для login-оболочки и bash без дефиса для остальных. Точнее отвечает shopt login_shell: значение login_shell on или login_shell off.

Дублировать конфиг не нужно: подключите .bashrc из .bash_profile. Тогда login-сессия получает и алиасы, и PATH из одного источника.

# ~/.bash_profile
if [ -f "$HOME/.bashrc" ]; then
    . "$HOME/.bashrc"
fi

Порядок загрузки конфигов bash: пошагово

Последовательность фиксирована и не зависит от дистрибутива, различаются только системные файлы. Ниже она приведена по официальному описанию Bash Startup Files.

Login, interactive, non-interactive: три режима и их файлы

Login-интерактивная оболочка (ssh user@host, su -, bash -l, вход в TTY) читает по порядку:

  1. /etc/profile, который обычно подключает /etc/profile.d/*.sh;
  2. первый существующий и доступный для чтения файл из ~/.bash_profile, ~/.bash_login, ~/.profile;
  3. ~/.bashrc, но только если его подключили вручную.

При выходе читаются ~/.bash_logout и /etc/bash.bash_logout.

Интерактивная без логина (новая вкладка, bash -i, панель tmux) читает /etc/bash.bashrc (в Debian и Ubuntu) или /etc/bashrc (в RHEL-семействе), затем ~/.bashrc, если этот файл существует.

Неинтерактивная (bash script.sh, bash -c, cron, ssh host команда) не читает ничего из перечисленного. Единственное исключение: файл, указанный в переменной BASH_ENV. Bash ведёт себя так, как если бы выполнил if [ -n "$BASH_ENV" ]; then . "$BASH_ENV"; fi, причём значение PATH для поиска этого файла не используется. Отсюда классика: ssh host 'echo $PATH' возвращает не то, что вы видите в терминале, потому что удалённая команда идёт через неинтерактивную оболочку.

Отдельный случай: неинтерактивная оболочка, запущенная с опцией --login, всё-таки пытается читать и выполнять команды из login-файлов запуска.

su без дефиса даёт интерактивную оболочку без логина и сохраняет окружение вызывающего пользователя, поэтому экспорты из ~/.bash_profile в ней не появятся. su - запускает login-оболочку и читает профиль заново.

Флаги для отладки: --noprofile пропускает /etc/profile и пользовательские login-файлы, --norc пропускает ~/.bashrc, --rcfile файл заменяет ~/.bashrc указанным файлом. Комбинация bash --noprofile --norc даёт чистую оболочку для аварийного входа.

Если логин-оболочка в /etc/passwd сменилась на zsh, bash-файлы не читаются вообще: zsh берёт ~/.zshrc и ~/.zprofile. Проверяйте через getent passwd $USER.

Что реально читается в вашем случае: трассировка

Не верьте описанию, проверьте свой хост. Запустите оболочку с трассировкой и оставьте в выводе только строки с именами файлов:

bash -x -l -i -c exit 2>&1 | grep -E 'profile|bashrc'

Ключ -x печатает каждую команду при старте, -l включает режим логина, -i делает оболочку интерактивной, -c exit сразу завершает её. Трассировка идёт в stderr, поэтому нужен 2>&1. Если файла нет в выводе, он не читался.

Второй способ нагляднее для порядка: добавьте в начало каждого файла строку вида echo "LOADED ~/.bashrc", откройте новую сессию и посмотрите последовательность меток. После проверки метки уберите, иначе они попадут в вывод scp и rsync.

Переменные окружения в интерактивных и неинтерактивных сессиях

Переменная оболочки живёт внутри текущего процесса bash. Переменная окружения передаётся дочерним процессам. Разницу задаёт export: без него значение остаётся локальным, и запущенный из оболочки бинарник его не увидит.

Проверка занимает две команды. env | grep MYVAR покажет только экспортированные переменные, а bash -c 'echo $MYVAR' запустит дочернюю оболочку и напечатает пустую строку, если export не было.

MYVAR=test
bash -c 'echo "без export: [$MYVAR]"'
export MYVAR
bash -c 'echo "с export: [$MYVAR]"'

Почему cron не видит ваш PATH

cron не запускает login-оболочку и не читает ~/.bashrc, ~/.bash_profile и ~/.profile. Окружение собирает сам демон: по документации crontab(5) в Debian он задаёт PATH=/usr/bin:/bin, а SHELL выставляет в /bin/sh; LOGNAME и HOME берутся из строки /etc/passwd владельца crontab. Каталог ~/.local/bin, добавленный в .bashrc, в задаче отсутствует, отсюда command not found при рабочем терминале.

  • Объявите PATH первой строкой crontab: PATH=/home/user/.local/bin:/usr/local/bin:/usr/bin:/bin. Документация прямо указывает: если нужен PATH, отличный от «/usr/bin:/bin», его нужно задать в самом файле crontab.
  • Указывайте абсолютные пути к бинарникам в самой команде.
  • Оберните задачу в скрипт с явным export PATH в начале файла.

Не подключайте . ~/.bashrc в crontab. Интерактивные настройки там не нужны, а ранний выход для неинтерактивных сессий в типовом .bashrc (Ubuntu) вообще не даст ему выполниться. Если задача молча перестала запускаться, смотрите разбор про права, секреты и контроль cron-задач.

systemd dotfiles тоже не читает. Для системных юнитов переменные задают директивами Environment= и EnvironmentFile=. Для пользовательского окружения есть каталоги environment.d: файлы ~/.config/environment.d/*.conf содержат список «глобальных» назначений переменных, их разбирает systemd-environment-d-generator(8) и обновляет окружение, которое пользовательский экземпляр systemd экспортирует запускаемым службам. Значения из .bashrc в службу не попадут никогда.

Единственный штатный способ подсунуть файл неинтерактивному bash: переменная BASH_ENV. bash раскрывает её значение и подключает указанный файл перед запуском скрипта. Приём цепляет все скрипты сразу: синтаксическая ошибка в таком файле ломает любой bash-запуск, включая установщики и деплой. Через sudo переменная не пройдёт: по умолчанию в sudo включён флаг env_reset, и команда выполняется в минимальном окружении из TERM, PATH, HOME, MAIL, SHELL, LOGNAME, USER и SUDO_* — это описано в sudoers(5). При запуске как sh, то есть в режиме POSIX, BASH_ENV не читается, вместо него для интерактивных оболочек действует ENV.

export: когда он обязателен, а когда лишний

export нужен, если переменную должны видеть дочерние процессы: PATH, EDITOR, PAGER, http_proxy, https_proxy, no_proxy, KUBECONFIG. Локальные счётчики и временные значения внутри скрипта экспортировать не нужно: лишняя переменная утекает в дочерние процессы и мешает отладке.

Повторный export при каждом подключении файла безобиден, а повторное добавление каталога в PATH нет: строка PATH=$PATH:/opt/bin при каждом source удлиняет переменную. Об идемпотентном варианте ниже.

Типичные ошибки с export и PATH

  • PATH=/opt/bin:$PATH без export. Оболочка каталог видит, дочерние процессы нет. Симптом: бинарник находится в терминале, но не в скрипте и не в cron. Лечится словом export в той же строке.
  • PATH=$PATH:/opt/bin при каждом source. Переменная растёт, type -a показывает повторы, диагностика усложняется. Замените на проверку наличия элемента.
  • PATH=/opt/bin вместо дополнения. Системные каталоги исчезают: ls, grep и ssh находятся только по абсолютному пути, а часть утилит перестаёт работать. Всегда сохраняйте $PATH в новой строке.
  • Секреты в ~/.bashrc. Значение уходит во все дочерние процессы и в env. Разбор рисков ниже.
  • Алиасы в расчёте на скрипты. В неинтерактивном режиме алиасы не раскрываются без shopt -s expand_aliases, поведение расходится с терминалом. Не перекрывайте cp, mv и rm алиасами, если на хосте работают скрипты.
  • Подключение .bashrc в деплой-скрипте. Ранний выход для неинтерактивных сессий или правка PATH дадут неожиданный результат. Держите отдельный файл окружения для автоматизации.
  • set -u в .bashrc. Жёсткий режим ломает часть completion-скриптов и сторонних утилит, которые рассчитывают на пустые переменные. В интерактивном конфиге включайте его осознанно.

Идемпотентный PATH без дубликатов

Добавляйте каталог, только если его ещё нет в переменной. Двоеточия по краям превращают PATH в список вида :/usr/bin:/bin:, поэтому шаблон совпадает с целым элементом, а не с частью другого пути.

add_to_path() {
    case ":$PATH:" in
        *":$1:"*) ;;
        *) PATH="$1:$PATH" ;;
    esac
}
add_to_path "$HOME/.local/bin"
export PATH

Новые каталоги ставьте в начало, чтобы они выигрывали при поиске, системные не затирайте. Вызов функции при каждом подключении файла безопасен: второй раз PATH не изменится.

Секреты в .bashrc: почему это плохо

~/.bashrc читается каждой интерактивной сессией, а экспортированное значение уходит во все дочерние процессы. Подставили токен - он попал в env каждого запущенного от вашего имени процесса, в вывод диагностики, в лог CI, который печатает окружение при падении сборки, и в репозиторий dotfiles на GitHub.

Держите секреты в отдельном файле с правами 600, подключаемом условно и только на нужных хостах, либо в менеджере секретов (Vault, sops, systemd credentials). Перенос в ~/.profile проблему не решает: login-сессия экспортирует то же самое. Перед коммитом dotfiles проверьте git check-ignore -v .env и убедитесь, что файл с секретами вне индекса.

Модульная организация конфига и готовые шаблоны

Один длинный ~/.bashrc через год превращается в свалку. Делим на модули: ~/.bashrc остаётся точкой входа, файлы из ~/.bashrc.d/ отвечают за свои темы. Глоб сортирует имена по алфавиту, поэтому нумеруйте: 00-path.sh, 10-aliases.sh, 20-history.sh, 30-prompt.sh.

Шаблон .bashrc: алиасы, PATH, HISTCONTROL

# ~/.bashrc
# Неинтерактивным сессиям интерактивные настройки не нужны
case $- in
    *i*) ;;
    *) return ;;
esac

HISTCONTROL=ignoreboth:erasedups
HISTSIZE=10000
HISTFILESIZE=20000
shopt -s histappend

for f in "$HOME"/.bashrc.d/*.sh; do
    [ -r "$f" ] && . "$f"
done
unset f

Что делает каждая строка:

  • case $- in *i* отсекает неинтерактивные запуски: scp, rsync и служебные скрипты не тянут алиасы и историю.
  • HISTCONTROL — разделённый двоеточиями список значений, управляющих сохранением команд в истории. ignoreboth объединяет ignorespace и ignoredups: команды с ведущим пробелом не попадают в историю, повторы подряд не записываются.
  • erasedups при записи команды удаляет все совпадающие с ней строки и добавляет её в список истории. Важное ограничение: история не дедуплицируется задним числом до того, как встретится дубликат, но будущие дубликаты не появляются ни в памяти, ни в файле. На общих хостах меньше шума, но теряется контекст, включайте осознанно.
  • HISTSIZE=10000 и HISTFILESIZE=20000 заменяют дефолтные 500 строк в памяти и в файле.
  • shopt -s histappend дописывает историю при выходе. Без этого параллельные сессии перезаписывают ~/.bash_history друг друга.
  • unset f убирает переменную цикла из окружения после подключения модулей.

Модуль алиасов и модуль PATH держите раздельно:

# ~/.bashrc.d/10-aliases.sh
alias ll='ls -alF'
alias la='ls -A'
alias grep='grep --color=auto'
alias ports='ss -tulpn'
# ~/.bashrc.d/00-path.sh
add_to_path() {
    case ":$PATH:" in
        *":$1:"*) ;;
        *) PATH="$1:$PATH" ;;
    esac
}
add_to_path "$HOME/.local/bin"
add_to_path "/usr/local/bin"
export PATH

Шаблон .bash_profile и подключение .bashrc

# ~/.bash_profile
# Единственное место, где подключается общий конфиг
if [ -f "$HOME/.bashrc" ]; then
    . "$HOME/.bashrc"
fi

# переменные, нужные только login-сессиям
export EDITOR=vim
export PAGER=less

Такой файл держит только login-специфику, алиасы и HISTCONTROL остаются в .bashrc, дублирования нет. Если файл может прочитать dash, например из скрипта с #!/bin/sh, забудьте про shopt и двойные квадратные скобки: используйте test и одинарные. Переносимость проверяйте на bash 5.x и не полагайтесь на фичи, которых нет в POSIX sh.

Чек-лист: проверяем, что конфигурация применилась и ничего не сломано

Перед правкой сделайте копию: cp ~/.bashrc ~/.bashrc.bak. Дальше по шагам, на тестовом хосте или хотя бы с открытой запасной сессией.

  1. Синтаксис: bash -n ~/.bashrc. Команда только парсит файл и не выполняет его.
  2. Линтер: shellcheck ~/.bashrc. Ловит незакавыченные переменные, мёртвые ветки и ошибки в test. Каркас скрипта с set -euo pipefail и разбор типичных замечаний есть в статье про bash-скрипты и чек-лист перед выкаткой.
  3. Login-оболочка: bash -l -i -c 'echo $PATH; type -a ll'. Ожидаем PATH из модуля и алиас в выводе.
  4. Интерактивная без логина: bash -i -c 'type -a ll'.
  5. Неинтерактивная: bash -c 'echo $PATH'. Проверяем, что служебные запуски не подхватывают лишнее.
  6. Переменные: env | grep MYVAR и bash -c 'echo $MYVAR'. Так видно, что export сработал, а не остался переменной оболочки.
  7. Порядок файлов: bash -x -l -i -c exit 2>&1 | grep -E 'profile|bashrc'.
  8. Минимальное окружение под cron: env -i HOME="$HOME" PATH=/usr/bin:/bin /bin/bash -c 'ваша команда'. Воспроизводит запуск без вашего .bashrc.
  9. Режим оболочки: shopt login_shell в ssh-сессии и в новой вкладке терминала должен отличаться.
  10. Откат: mv ~/.bashrc.bak ~/.bashrc, если что-то пошло не так.

Изменения в /etc/profile, /etc/bash.bashrc и /etc/profile.d/ затрагивают всех пользователей хоста: их проверяют на отдельной машине и не в час пик.

Аварийный вход и откат

Сломанный PATH или цикл подключения может оставить вас без рабочей оболочки. Держите открытой текущую SSH-сессию, пока проверяете новую: старая продолжает работать со старым окружением и служит страховкой.

Аварийный запуск без чтения файлов: bash --noprofile --norc. Дальше восстановление из копии или вход другим пользователем, у которого есть права на ваш домашний каталог. su - даёт login-оболочку с чистым окружением и помогает, когда root-доступ сохранён.

Итог: минимальный набор правил на 2026

  • Алиасы, приглашение и HISTCONTROL живут в ~/.bashrc.
  • PATH и экспорты для дочерних процессов задаются в одном источнике, подключённом из .bash_profile.
  • PATH меняйте идемпотентно: функция с проверкой case ":$PATH:" вместо простого дописывания.
  • Секреты держите вне dotfiles: файл с правами 600 или менеджер секретов.
  • cron, systemd и ssh host команда не читают .bashrc: окружение задавайте явно.
  • Перед правкой копия файла, после правки проверка в login, интерактивной и неинтерактивной сессии.
  • bash 5.x не требует новых конструкций: работают прежние приёмы, а ценность в проверке через shellcheck и тестовые запуски.

Начните с малого: вынесите PATH в отдельный модуль ~/.bashrc.d/00-path.sh, добавьте в .bash_profile подключение .bashrc и прогоните bash -l -i -c 'echo $PATH' в новой сессии. Этого достаточно, чтобы снять большую часть сюрпризов с переменными окружения в терминале, скриптах и cron.

Поделиться: