Коротко: какой файл за что отвечает
Три файла делят одну работу, и путаница между ними даёт классический симптом: по 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, приглашение, при необходимости PATH | Login-сессия по SSH его не прочитает, если не подключить из ~/.bash_profile |
| ~/.bash_profile | Login-оболочка: ssh user@host, su -, bash -l, вход в TTY | Экспорты для дочерних процессов, подключение ~/.bashrc | Не читается новой вкладкой терминала, поэтому алиасы здесь «не работают» |
| ~/.bash_login | Login-оболочка, если нет ~/.bash_profile | То же, что в .bash_profile | Второй в очереди: при наличии .bash_profile игнорируется целиком |
| ~/.profile | Login-оболочка, если нет ни .bash_profile, ни .bash_login | POSIX-совместимые экспорты и PATH | Игнорируется при наличии .bash_profile: частая причина «переменная не подхватилась» |
| /etc/profile, /etc/profile.d/*.sh | Login-оболочка, до пользовательских файлов | Системные переменные для всех пользователей | Правка влияет на всех: проверяйте отдельно от своего пользователя |
| /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) читает по порядку:
- /etc/profile, который обычно подключает /etc/profile.d/*.sh;
- первый существующий и доступный для чтения файл из ~/.bash_profile, ~/.bash_login, ~/.profile;
- ~/.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. Дальше по шагам, на тестовом хосте или хотя бы с открытой запасной сессией.
- Синтаксис: bash -n ~/.bashrc. Команда только парсит файл и не выполняет его.
- Линтер: shellcheck ~/.bashrc. Ловит незакавыченные переменные, мёртвые ветки и ошибки в test. Каркас скрипта с set -euo pipefail и разбор типичных замечаний есть в статье про bash-скрипты и чек-лист перед выкаткой.
- Login-оболочка: bash -l -i -c 'echo $PATH; type -a ll'. Ожидаем PATH из модуля и алиас в выводе.
- Интерактивная без логина: bash -i -c 'type -a ll'.
- Неинтерактивная: bash -c 'echo $PATH'. Проверяем, что служебные запуски не подхватывают лишнее.
- Переменные: env | grep MYVAR и bash -c 'echo $MYVAR'. Так видно, что export сработал, а не остался переменной оболочки.
- Порядок файлов: bash -x -l -i -c exit 2>&1 | grep -E 'profile|bashrc'.
- Минимальное окружение под cron: env -i HOME="$HOME" PATH=/usr/bin:/bin /bin/bash -c 'ваша команда'. Воспроизводит запуск без вашего .bashrc.
- Режим оболочки: shopt login_shell в ssh-сессии и в новой вкладке терминала должен отличаться.
- Откат: 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.