Почему окна серверов не различить
Открыты три окна SSH, в каждом свой сервер. Приглашение во всех одинаково зелёное, и отличаются окна только именем посередине строки:
example-user@web1:~$
example-user@web2:~$
example-user@db1:~$
docker compose down, набранный не в том окне, останавливает сайты не на том сервере. Настройки Ubuntu
тут не помогают:
- Цвет у всех серверов один: имя зелёное, каталог синий.
- У root цвета нет совсем.
/root/.bashrcкрасит приглашение, только если терминал называет себяxterm-color, а ssh из Windows передаётxterm-256color.root@web1:~#отличается от обычного приглашения именем и знаком в конце. - В PuTTY нет цвета и у обычного пользователя: по умолчанию она называет себя
xterm. - Команда, которая упала молча, —
grepбез совпадений,test -f,systemctl is-active— выглядит так же, как успешная.
С блоком из этого мануала приглашение такое:
[1] example-user@web2:.../traefik/data/dynamic (main *)$
[1] красным — прошлая команда кончилась с кодом 1; после успешной его нет. web2 — цветом этого сервера,
у каждого сервера свой. .../ — начало длинного пути скрыто. (main *) — ветка git и изменения, ещё
не добавленные в индекс. У root имя root красное, в конце — #.
Из чего Ubuntu собирает приглашение
Приглашение — значение переменной PS1. Перед каждой командой Bash заменяет в нём \u, \h, \w и
подставляет переменные. У обычного пользователя Ubuntu PS1 такое (declare -p PS1):
\[\e]0;\u@\h: \w\a\]${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$
| Кусок | Что выводит |
|---|---|
\[\e]0;\u@\h: \w\a\] |
в строке не виден: это заголовок окна или вкладки терминала, example-user@web1: ~ |
${debian_chroot:+($debian_chroot)} |
имя chroot в скобках; на обычном сервере пусто |
\[\033[01;32m\] |
дальше — жирный зелёный |
\u@\h |
example-user@web1 |
\[\033[00m\] |
сброс цвета |
:\[\033[01;34m\]\w\[\033[00m\] |
двоеточие, затем каталог синим |
\$ и пробел |
$, у root — # |
Что ещё Bash подставляет в PS1:
| Знак | Что подставляет |
|---|---|
\u |
имя пользователя |
\h |
имя сервера до первой точки: web1 из web1.example.org |
\H |
имя сервера целиком |
\w |
текущий каталог, домашний — ~ |
\W |
только последний каталог: dynamic |
\A |
время, 14:05 |
\$ |
# у root, $ у остальных |
\e |
символ ESC, с него начинается код цвета; \033 — тот же символ |
\[ и \] |
границы невидимого: что между ними, не занимает места на экране |
Код цвета — \e[, числа через ; и m: \e[1;31m — жирный красный, \e[0m — сброс. Точный оттенок
задаёт схема цветов терминала.
| Код | Цвет |
|---|---|
31 |
красный |
32 |
зелёный |
33 |
жёлтый |
34 |
синий |
35 |
пурпурный |
36 |
голубой |
1;37;41 |
белый на красном фоне |
38;5;208 |
оранжевый, из 256 цветов |
1; перед цветом — жирный. Многие терминалы рисуют жирный цвет его яркой версией — так по умолчанию делают Tabby
и другие терминалы на xterm.js. В тёмной схеме Tabby Default яркий жёлтый 1;33 светлый, почти как обычный
текст, и имя сервера им не выделить. Поэтому цвет выбираем, глядя на свой терминал: строка ниже печатает имя
всеми шестью цветами.
for c in 31 32 33 34 35 36; do printf '\e[1;%sm%s\e[0m %s ' "$c" "web1" "$c"; done; echo
В PS1 каждый код обёрнут в \[ … \]. Bash считает
длину приглашения, чтобы знать, где начинается команда: без скобок коды для него — видимые символы,
и правка длинной команды путает строку на экране.
PS1 задают строки 59–73 в ~/.bashrc Ubuntu, а ~/.bash_aliases подключается ниже, на строке 104.
Поэтому PS1 из ~/.bash_aliases заменяет приглашение Ubuntu целиком — вместе с заголовком окна, если его
не повторить.
В Ubuntu 26.04 к приглашению добавляется /etc/profile.d/80-systemd-osc-context.sh из systemd: функция
в PROMPT_COMMAND и PS0 сообщают терминалу пользователя, имя сервера, каталог и код выхода команды
(стандарт OSC 3008). На вид приглашения это не влияет: терминал, который стандарта не знает, такое сообщение
пропускает. Для нас важно одно: PROMPT_COMMAND там — массив
([0]="" [1]="__systemd_osc_context_precmdline"), и свою функцию в него добавляем через +=.
Своё приглашение: блок в ~/.bash_aliases
Блок кладём в конец ~/.bash_aliases — того же файла, что и алиасы («Алиасы в Bash»). Список серверов
в case один на все: файл копируем на серверы как есть, и каждый сервер берёт свой цвет по имени.
Работает на Ubuntu 24.04 и 26.04, ставить ничего не нужно.
# Приглашение: свой цвет у каждого сервера
case "${HOSTNAME%%.*}" in
web1) host_color='1;31' ;;
web2) host_color='1;35' ;;
*) host_color='1;32' ;;
esacЦвет имени сервера. ${HOSTNAME%%.*} — имя до первой точки, как его показывает \h: и web1, и web1.example.org попадают в строку web1). Боевым — заметные цвета: красный, пурпурный, голубой; как каждый выглядит в своём терминале — строкой из раздела выше. Сервер не из списка — зелёный, как в Ubuntu.
if [ "$EUID" -eq 0 ]; then
user_color='1;31'
else
user_color='0'
fiИмя root — красным. $EUID у root равен 0, и под sudo -i и sudo -s блок срабатывает, если файл скопирован root'у (шаг ниже). Обычное имя пользователя — цветом текста по умолчанию, чтобы рядом с ним был виден цвет сервера.
prompt_code() {
local code=$?
prompt_code_text=
if [ "$code" -ne 0 ]; then prompt_code_text="[$code] "; fi
}
PROMPT_COMMAND+=(prompt_code)Код упавшей команды — [1] красным перед именем; после успешной не показываем ничего. Функция запоминает $? первой строкой: Bash даёт каждому элементу PROMPT_COMMAND код команды, набранной в терминале, — и после функции systemd в 26.04 тоже. +=( ) ставит функцию в конец списка и не трогает ни history -a, ни systemd.
PROMPT_DIRTRIM=3От длинного пути — три последних каталога: /opt/traefik/data/dynamic в приглашении — .../traefik/data/dynamic. Короткий путь и ~ остаются как есть.
PS1=
case "$TERM" in xterm*|rxvt*) PS1='\[\e]0;\u@\h: \w\a\]' ;; esac
PS1+='\[\e[1;31m\]$prompt_code_text\[\e[0m\]'
PS1+="\[\e[${user_color}m\]\u\[\e[0m\]@"
PS1+="\[\e[${host_color}m\]\h\[\e[0m\]"
PS1+=':\[\e[1;34m\]\w\[\e[0m\]'Сначала заголовок окна — тот же кусок, что у Ubuntu, и для тех же терминалов: вкладка показывает example-user@web1: ~. Дальше код, пользователь@сервер и каталог синим. $prompt_code_text — в одинарных кавычках: Bash подставляет его перед каждым приглашением. Цвета — в двойных: они подставляются один раз, когда Bash читает файл.
if [ -r /usr/lib/git-core/git-sh-prompt ]; then
. /usr/lib/git-core/git-sh-prompt
GIT_PS1_SHOWDIRTYSTATE=1
PS1+='$(__git_ps1 " (%s)")'
fiВетка git, когда каталог внутри репозитория: (main *). Функцию __git_ps1 даёт пакет git. Ubuntu подключает её сама при входе по SSH, но не под sudo -s — поэтому подключаем файл явно. GIT_PS1_SHOWDIRTYSTATE=1 добавляет к ветке значки изменений — раздел «Ветка git в приглашении».
PS1+='\$ '$ у обычного пользователя, # у root, и пробел перед командой.
Дописываем блок в ~/.bash_aliases
nano ~/.bash_aliasesВставляем в конец файла блок выше — кнопка «Копировать» над ним берёт все куски разом — и вписываем в
caseсвои серверы. Если файла ещё нет,nanoего создаст.Проверяем синтаксис
bash -n ~/.bash_aliasesПустой вывод — ошибок нет. При ошибке Bash называет файл и строку:
/home/example-user/.bash_aliases: line 6: syntax error near unexpected token.Перезапускаем оболочку
exec bashBash заменяет себя новым и читает файлы заново.
source ~/.bash_aliasesтоже применит блок, но при каждом повторе добавляетprompt_codeвPROMPT_COMMANDещё раз. На приглашение это не влияет — функция выполняется дважды, лишняя уходит с новым входом.То же для root
sudo cp ~/.bash_aliases /root/sudo -iиsudo -sчитают/root/.bashrc, а он подключает/root/.bash_aliases. В свежей Ubuntu этого файла у root нет; если он уже есть — дописываем блок в него, а не копируем поверх.Переносим на другие серверы
scp ~/.bash_aliases web2:Список в
caseтот же, и web2 берёт из него свой цвет. На самом сервере — шаг «То же для root».
Ветка git в приглашении
__git_ps1 показывает ветку, когда текущий каталог внутри репозитория, — например в /opt, если конфиги
сервера лежат в git. С GIT_PS1_SHOWDIRTYSTATE=1 после имени ветки появляются значки:
| Значок | Что значит |
|---|---|
* |
есть изменённые файлы, ещё не добавленные в индекс |
+ |
есть изменения в индексе, ещё не закоммиченные |
# |
в репозитории ещё нет ни одного коммита: так выглядит свежий git init |
Чтобы поставить значки, __git_ps1 перед каждым приглашением запускает git diff --quiet и
git diff --cached --quiet. Чем больше файлов в репозитории, тем дольше ждёт приглашение. Если в каком-то
репозитории это заметно, значки выключаем только в нём:
git config bash.showDirtyState false
Ветка остаётся, пропадают только * и +. Если ветки нет совсем, а репозиторий принадлежит root, —
случай с /opt в «Если не работает».
Starship вместо своего PS1
Starship — отдельная программа, которая рисует приглашение из модулей: ветка git, длительность долгой
команды, версии Python и Node в каталоге проекта. Пакет starship есть в Ubuntu 26.04 (1.22.1), в 24.04
его нет. Подключается строкой в ~/.bash_aliases:
eval "$(starship init bash)"
Приглашение у него по умолчанию в две строки: example-user in 🌐 web2 in ~ и ❯ на следующей. ❯ зелёный
после успешной команды и красный после ошибки, без номера кода. В маленьком репозитории starship prompt
отрабатывает примерно за 6 мс.
Пользователя и имя сервера Starship показывает, только когда видит вход по SSH, — переменную
SSH_CONNECTION; в консоли провайдера остаются ~ и ❯. Значок ветки — символ U+E0A0 из шрифтов Powerline
и Nerd Fonts: такой шрифт нужен в терминале на своей машине. Настройки лежат в ~/.config/starship.toml.
Условий по имени сервера в них нет, так что свой цвет каждому серверу задаём отдельным файлом на этом сервере.
| Если | Берём |
|---|---|
| свой цвет у каждого сервера одним файлом, на 24.04 и 26.04, без установки | блок PS1 из этого мануала |
| серверы на 26.04, нужны версии языков и длительность команд, шрифт с символами есть | Starship |
Если не работает
В длинной команде Ctrl+A ставит курсор в конец первой строки, а набранное ложится поверх команды
- Причина
- Коды цвета в
PS1не обёрнуты в\[ … \]. Bash считает их видимыми символами: приглашение для него длиннее, чем на экране, и он ошибается, где начинается команда. - Делаем
- Оборачиваем каждый код цвета:
\[\e[1;31m\],\[\e[0m\].
Весь текст после приглашения — и команда, и её вывод — того же цвета, что каталог
- Причина
- В конце
PS1нет сброса\[\e[0m\]. Цвет действует, пока его не сбросят, — и на набранное, и на вывод. - Делаем
- Закрываем каждый цветной кусок сбросом
\[\e[0m\].
В PuTTY приглашение без цвета, а в Windows Terminal цветное
- Причина
- PuTTY по умолчанию называет себя
TERM=xterm, а~/.bashrcUbuntu красит приглашение, только еслиTERM—xterm-colorили кончается на-256color. - Делаем
- Блок из этого мануала красит при любом
TERM. Без него — в PuTTY Connection › Data › Terminal-type string ставимxterm-256color.
Под sudo -i приглашение без цвета: root@web1:~#
- Причина
- У root свой
/root/.bashrc, и он красит приглашение только приTERM=xterm-color. ssh из Windows передаётxterm-256color. - Делаем
- Копируем блок root'у:
sudo cp ~/.bash_aliases /root/.
Поставили своё PS1, и вкладка терминала перестала показывать имя сервера
- Причина
- Заголовок окна в Ubuntu — часть
PS1: невидимый кусок\[\e]0;\u@\h: \w\a\]в начале. НовоеPS1его затёрло. - Делаем
- Начинаем своё
PS1с этого куска, как в блоке мануала.
После Ctrl+C в приглашении [130], и Enter его не убирает
- Причина
- Ctrl+C прерывает команду или набранную строку, и Bash ставит код 130: 128 + номер сигнала SIGINT, 2. Пустой Enter команду не запускает, поэтому код остаётся прежним.
- Делаем
- Ничего не делаем: код сменится после следующей команды.
Самодельное приглашение с веткой показывает [0] после любой команды, а вне репозитория — [128]
- Причина
$( … )стоит вPS1раньше$?, и$?показывает код этой подстановки:git branch --show-currentв репозитории кончается с 0, вне его — с 128.- Делаем
- Код запоминаем первым — функцией в
PROMPT_COMMAND, какprompt_codeв блоке мануала, — или ставим$?вPS1раньше всех$( … ).
Под sudo -s перед каждым приглашением __git_ps1: command not found
- Причина
__git_ps1в Ubuntu подключает автодополнение — при входе по SSH и подsudo -i. Подsudo -sroot читает/root/.bashrc, а там автодополнение закомментировано.- Делаем
- Подключаем файл сами, до строки с
__git_ps1:. /usr/lib/git-core/git-sh-prompt.
В /opt ветки в приглашении нет, хотя /opt — репозиторий
- Причина
- Репозиторий принадлежит root, а git с версии 2.35.2 в чужих репозиториях не работает:
git statusотвечаетfatal: detected dubious ownership in repository at '/opt'.__git_ps1ошибку не показывает, ветку тоже. - Делаем
- Разрешаем этот каталог своему пользователю:
git config --global --add safe.directory /opt.
После правки приглашения история на Ubuntu 24.04 перестала сразу записываться в файл
- Причина
- В
~/.bash_aliasesстрокаPROMPT_COMMAND=prompt_code, без+=. Присваивание заменяет первый элемент списка, а там стоялhistory -aиз «История команд». В 26.04 первый элемент systemd оставляет пустым, и та же строка ничего не ломает. - Делаем
- Пишем
PROMPT_COMMAND+=(prompt_code): функция встаёт в конец списка. Проверяемdeclare -p PROMPT_COMMAND.
Сменили имя сервера, а в приглашении старое
- Причина
- Имя для
\hи$HOSTNAMEBash узнаёт один раз, при запуске. - Делаем
exec bashили новый вход. Как задать имя — «Первый вход на сервер», шаг «Даём имя».
Как проверить
false
# [1] example-user@web1:~$
true
# example-user@web1:~$
cd /var/lib/apt/lists
# example-user@web1:.../lib/apt/lists$
[1] красным — работает prompt_code; после true код пропадает. .../ — работает PROMPT_DIRTRIM.
Вкладка терминала подписана example-user@web1: .../lib/apt/lists.
sudo -i
# root@web1:~#
root красным, в конце # — root прочитал свою копию блока. Что получит следующий вход по SSH:
bash -lic 'declare -p PROMPT_COMMAND'
# declare -a PROMPT_COMMAND=([0]="" [1]="__systemd_osc_context_precmdline" [2]="prompt_code")
Так выглядит список в Ubuntu 26.04; в 24.04 в нём только prompt_code, а с настройкой из «История команд» —
ещё и history -a.