basforge

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

    EN

    Алиасы в Bash: свои короткие команды

    Алиас — короткое слово, которое Bash подставляет вместо команды: набираем ports, выполняется ss -tulpn. Свои алиасы держим в ~/.bash_aliases, Ubuntu подключает этот файл сама. Работают они только там, где команды набирают руками: в скриптах и в ssh web1 'команда' алиасов нет.

    Зачем свои короткие команды

    Часть команд на сервере набирается по нескольку раз за день, и у каждой свои флаги. ss -tulpn — какие порты слушает сервер и какая программа: без -n порт 53 выглядит как :domain, без -p пропадает колонка с программой. docker compose logs -f --tail 100 — хвост лога: без --tail compose сначала выводит весь накопленный лог. Флаги приходится держать в голове, а пропущенный показывает не то, и это не всегда заметно.

    Алиас записывает команду один раз, со всеми флагами, под коротким именем. Набираем ports — Bash меняет его на ss -tulpn и запускает. Ubuntu так делает из коробки: ls в терминале цветной, потому что это алиас ls --color=auto.

    Как Bash подставляет алиас

    Bash читает строку и смотрит на первое слово команды. Если это алиас, слово заменяется его текстом, остальное остаётся как было:

    набрали:     ll /etc
    выполнится:  ls -alF /etc
    • Раскрывается только первое слово команды: в начале строки, после ;, &&, |. cd /etc && ll работает, а echo ll печатает ll.
    • Аргументы встают в конец текста алиаса. Для ls -alF это то, что нужно; для алиаса с конвейером уже нет — об этом ниже.
    • Алиас главнее функции, встроенной команды и программы с тем же именем. Обойти его — \ls или command ls: запустится сама программа, без флагов из алиаса.
    • Только в интерактивной оболочке, где мы набираем команды. Скрипты, cron и ssh web1 'команда' алиасов не видят.

    Что стоит за именем:

    type ll
    # ll is aliased to `ls -alF'
    alias
    # список всех алиасов этой оболочки

    Строку можно развернуть, не запуская: набираем её и жмём Ctrl+Alt+E (если терминал перехватывает сочетание — Esc, потом Ctrl+E). ll /etc на месте превращается в ls -alF /etc. Заодно разворачиваются переменные и !!.

    Что уже есть в Ubuntu

    Новому пользователю Ubuntu кладёт ~/.bashrc — копию /etc/skel/.bashrc. В нём уже есть алиасы:

    Алиас Что выполняет
    ls, grep, fgrep, egrep то же с --color=auto: цвет в терминале, без цвета в файле и в конвейере
    ll ls -alF — все файлы, подробно, / у каталогов, * у исполняемых
    la ls -A — со скрытыми, без . и ..
    l ls -CF — колонками, с / и *
    alert уведомление на рабочем столе после долгой команды: sleep 10; alert. На сервере не работает — там нет notify-send

    И строки, которые подключают свой файл:

    if [ -f ~/.bash_aliases ]; then
        . ~/.bash_aliases
    fi

    Свои алиасы в .bashrc не дописываем, а кладём в ~/.bash_aliases. .bashrc остаётся стандартным, а свой файл переносится на другой сервер одной командой и там сразу работает.

    У root свой /root/.bashrc — из пакета base-files, с теми же ll, la, l и той же строкой про ~/.bash_aliases, только ~ у root — это /root.

    В других дистрибутивах проверяем: grep bash_aliases ~/.bashrc. Пусто — дописываем эти три строки в конец ~/.bashrc.

    Свои алиасы: от истории до сервера

    1. Ищем, что набираем чаще всего

      history -a
      sort ~/.bash_history | uniq -c | sort -rn | head -20

      history -a дописывает в файл команды текущего сеанса: сам Bash сохраняет их только при выходе. Ubuntu хранит последние 2000 строк (HISTFILESIZE=2000 в .bashrc). Кандидаты — длинные строки, которые повторяются, и команды, у которых каждый раз вспоминаем флаги.

    2. Проверяем, свободно ли имя

      type dc
      # bash: type: dc: not found

      not found — имя свободно. Если программа с таким именем есть, алиас её закроет. Своё имя стандартной команде даём, только если алиас добавляет флаги вида, как ls --color=auto. Флаг, который меняет результат, ломает привычные конвейеры: с alias grep='grep -rn' команда ps aux | grep sshd ищет по файлам текущего каталога, а вывод ps пропускает.

    3. Записываем алиасы в ~/.bash_aliases

      nano ~/.bash_aliases
      # порты, которые слушает сервер, и чьи они
      alias ports='ss -tulpn'
      alias dc='docker compose'
      alias ..='cd ..'

      Вокруг = пробелов нет. Значение — в одинарных кавычках: в двойных $… и $(…) подставляются один раз, когда Bash читает файл. alias today="echo $(date +%F)" будет показывать дату входа, даже если терминал открыт с прошлой недели.

    4. Перечитываем файл в этом терминале

      source ~/.bash_aliases

      Новые и изменённые алиасы работают сразу. В других открытых терминалах — после такой же команды или нового входа. Удалённый из файла алиас в этом терминале остаётся до unalias имя.

    5. Переносим на сервер

      scp ~/.bash_aliases web1:

      На Ubuntu больше ничего не нужно: при следующем входе по SSH алиасы на месте. Для root — отдельная копия на сервере: sudo cp ~/.bash_aliases /root/.

    Алиас, функция или скрипт

    Алиас подставляет текст, и аргументы встают в его конец. Пока алиас — одна команда с флагами, так и надо. С конвейером уже нет:

    alias duh='du -h -d1 2>/dev/null | sort -h'
    duh /etc
    # sort: read failed: /etc: Is a directory

    Путь /etc достался sort, а не du. Где аргумент нужен в середине, пишем функцию — в тот же ~/.bash_aliases:

    # что занимает место: каталоги по размеру, самый большой внизу
    duh() { du -h -d1 "${1:-.}" 2>/dev/null | sort -h; }

    $1 — первый аргумент, ${1:-.} — текущий каталог, если аргумента нет.

    Вторая причина для функции — cd. Скрипт работает в отдельном процессе, и его cd меняет каталог только внутри себя. Функция выполняется в нашей оболочке, поэтому после неё мы уже в новом каталоге:

    # создать каталог и перейти в него
    mkcd() { mkdir -p "$1" && cd "$1"; }

    Функции и алиасы живут в одном файле. ~/.bash_aliases — обычный файл Bash: .bashrc выполняет его целиком, поэтому функция из него доступна в терминале так же, как алиас, и вызывается по имени. Алиас может вызвать функцию — alias dlog='duh /var/log'. Функция может использовать алиас, если он стоит в файле выше, поэтому в файле сначала алиасы, потом функции. Как писать функции, что в них значат $1 и "$@" и где функция не работает — «Функции в Bash».

    Если Берём
    одна команда с постоянными флагами, аргументы — в конце алиас
    аргумент в середине, конвейер, cd, несколько команд функцию в ~/.bash_aliases
    команда нужна из cron, из других скриптов, другим пользователям скрипт в ~/.local/bin: Ubuntu добавляет его в PATH при входе, если каталог уже есть
    короткое имя сервера вместо ssh [email protected] Host web1 в ~/.ssh/config: это имя понимают и scp, rsync, git («~/.ssh/config»)
    сокращение для git [alias] в ~/.gitconfig: git lg работает в любой оболочке, где есть git («~/.gitconfig по блокам»)

    Где алиасы мешают

    Алиас живёт в файле на одной машине. На машине без этого файла его нет: ll есть на любой Ubuntu, а ports и dc — только там, куда принесли ~/.bash_aliases. Тяжелее всего с алиасами-страховками: кто привык к alias rm='rm -i', на чужом сервере удалит файлы без вопроса («rm -I вместо rm -i»).

    Готовый файл на каждый день, с пояснением к каждой строке, — «Алиасы на каждый день»; алиасы, о которых знают немногие, — «Малоизвестные алиасы».

    Tab после алиаса подставляет имена файлов, а не подкоманды: systemctl sta и Tab дописывает start или status, sc sta — ничего. Дополнение Bash привязано к имени команды, а не к алиасу. Как это починить — «Tab после алиаса».

    Команда с алиасом не работает у других. В инструкции, в скрипте, в сообщении коллеге пишем полную: docker compose up -d, а не dc up -d. Материалы на этом сайте тоже написаны полными командами.

    Если не работает

    ssh web1 ll отвечает bash: line 1: ll: command not found

    Причина
    Команда после адреса идёт в неинтерактивный Bash. Он не раскрывает алиасы, а .bashrc в Ubuntu в таком режиме выходит на первых строках.
    Делаем
    Заходим ssh web1 и набираем в сеансе. Для одной команды через SSH пишем её полностью: ssh web1 'ls -alF'.

    sudo ll отвечает sudo: ll: command not found, с sudo-rs в Ubuntu 26.04 — sudo: 'll': command not found

    Причина
    Bash раскрывает только первое слово, здесь это sudo. Слово ll уходит к sudo как имя программы, а такой программы нет.
    Делаем
    Добавляем в ~/.bash_aliases строку alias sudo='sudo ': пробел в конце велит раскрыть и следующее слово. Только следующее: sudo -u root ll всё равно не найдётся, там после sudo идёт -u.

    Под sudo -i своих алиасов нет, есть только ll, la, l

    Причина
    Root читает свой /root/.bashrc, а из него — /root/.bash_aliases. Наш файл лежит в другом домашнем каталоге.
    Делаем
    Кладём копию root'у: sudo cp ~/.bash_aliases /root/.

    В окне терминала алиасы есть, а при входе по SSH — нет

    Причина
    Вход по SSH запускает login-оболочку. Она читает первый найденный из ~/.bash_profile, ~/.bash_login, ~/.profile, и в Ubuntu .bashrc подключает именно .profile. Если появился ~/.bash_profile, до .profile очередь не доходит.
    Делаем
    Первой строкой в ~/.bash_profile пишем . ~/.profile: подтянутся и .bashrc, и PATH с ~/.local/bin.

    Скрипт падает: ll: command not found, хотя в терминале ll работает

    Причина
    Скрипт выполняет неинтерактивный Bash, он алиасы не раскрывает.
    Делаем
    В скрипте пишем полную команду. shopt -s expand_aliases включает алиасы, но тогда скрипт работает только там, где лежит наш ~/.bash_aliases.

    Поправили ~/.bash_aliases, а в открытом терминале всё по-старому

    Причина
    Bash читает файл один раз, при запуске.
    Делаем
    source ~/.bash_aliases. Удалённый из файла алиас так не уходит — unalias имя или новый вход.

    alias ll = 'ls -alF' отвечает bash: alias: ll: not found и bash: alias: =: not found

    Причина
    Пробелы вокруг =: Bash видит три отдельных слова и для каждого пытается показать существующий алиас.
    Делаем
    Пишем без пробелов: alias ll='ls -alF'.

    Алиас с конвейером и путём: sort: read failed: /etc: Is a directory

    Причина
    Аргумент встаёт в конец всего текста алиаса и достаётся последней команде конвейера.
    Делаем
    Делаем функцию — раздел «Алиас, функция или скрипт».

    Как проверить

    Алиас на месте:

    type ports
    # ports is aliased to `ss -tulpn'

    Будет ли он при входе по SSH — не выходя из сеанса. bash -lic запускает login-оболочку, она читает те же файлы, что и вход по SSH:

    bash -lic 'type ports'
    # ports is aliased to `ss -tulpn'