basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Приглашение Bash: свой цвет у каждого сервера, код ошибки и ветка git

    Приглашение — строка example-user@web1:~$ перед курсором, её задаёт переменная PS1. В Ubuntu она на всех серверах одинаково зелёная, а у root без цвета вовсе. Блоком в ~/.bash_aliases даём каждому серверу свой цвет, root — красный, и добавляем код упавшей команды и ветку git.

    Почему окна серверов не различить

    Открыты три окна 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, ставить ничего не нужно.

    ~/.bash_aliases — приглашение
    # Приглашение: свой цвет у каждого сервера
    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, и пробел перед командой.

    1. Дописываем блок в ~/.bash_aliases

      nano ~/.bash_aliases

      Вставляем в конец файла блок выше — кнопка «Копировать» над ним берёт все куски разом — и вписываем в case свои серверы. Если файла ещё нет, nano его создаст.

    2. Проверяем синтаксис

      bash -n ~/.bash_aliases

      Пустой вывод — ошибок нет. При ошибке Bash называет файл и строку: /home/example-user/.bash_aliases: line 6: syntax error near unexpected token.

    3. Перезапускаем оболочку

      exec bash

      Bash заменяет себя новым и читает файлы заново. source ~/.bash_aliases тоже применит блок, но при каждом повторе добавляет prompt_code в PROMPT_COMMAND ещё раз. На приглашение это не влияет — функция выполняется дважды, лишняя уходит с новым входом.

    4. То же для root

      sudo cp ~/.bash_aliases /root/

      sudo -i и sudo -s читают /root/.bashrc, а он подключает /root/.bash_aliases. В свежей Ubuntu этого файла у root нет; если он уже есть — дописываем блок в него, а не копируем поверх.

    5. Переносим на другие серверы

      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, а ~/.bashrc Ubuntu красит приглашение, только если 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 -s root читает /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 и $HOSTNAME Bash узнаёт один раз, при запуске.
    Делаем
    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.