zsh/README.md

4.6 KiB
Raw Blame History

Установка

Установка оболочки Zsh:

sudo apt-get install git zsh

Установка желательных пакетов:

sudo apt-get install autojump grc grepcidr keychain kitty-terminfo peco wmctrl xdotool

Если в системе установлен пакет fzf, лучше его удалить, так как устанавливаемый плагин может с ним конфликтовать:

sudo apt-get remove fzf

Клонирование репозитория в каталог ~/.config/zsh:

git clone https://git.246060.ru/f1x1t/zshrc ~/.config/zsh

Базовая настройка

Создать файл $HOME/.zshenv со следующим содержимым:

# Загрузка конфигурации из каталога $ZDOTDIR
export ZDOTDIR=$HOME/.config/zsh
source $ZDOTDIR/.zshenv

Установить интерпретатор Zsh по умолчанию для пользователя username.

sudo usermod -s /usr/bin/zsh username

Настройка агентов

Существует несколько вариантов настройки агентов для SSH и/или GPG. Для любого из вариантов следует скопировать шаблонный файл для настроек:

cp ~/.config/zsh/55-agents.zsh ~/.config/zsh/55-agents.user.zsh

Настройка GPG агента

Раскомментировать в файле ~/.config/zsh/55-agents.user.zsh строки:

# zinit snippet OMZP::gpg-agent

Пример файла настройки GPG агента ~/.config/gnupg/gpg-agent.conf:

default-cache-ttl 36000
max-cache-ttl 999999
enable-putty-support
default-cache-ttl-ssh 36000
allow-loopback-pinentry
pinentry-program /usr/bin/pinentry-qt
# enable-ssh-support

Чтобы включить в GPG агенте поддержку SSH, нужно раскомментировать последнюю строку.

Настройка SSH агента

Раскомментировать в файле ~/.config/zsh/55-agents.user.zsh строки:

# zstyle :omz:plugins:ssh-agent agent-forwarding on
# zstyle :omz:plugins:ssh-agent identities id_rsa
# zstyle :omz:plugins:ssh-agent lifetime 10h
# zinit snippet OMZP::ssh-agent

Добавить в конец файла ~/.ssh/config правило для разрешения агенту сохранять ключи:

Host *
    AddKeysToAgent yes
    IdentityFile ~/.ssh/id_rsa

Настройка Keychain

Программа Keychain позволит использовать агенты GPG и SSH между входами в систему. Для её работы необходимо отключить в системе все автоматические запуски агентов, например в файле /etc/X11/Xsession.options удалить строку:

use-ssh-agent

Раскомментировать в файле ~/.config/zsh/55-agents.user.zsh строки:

# zstyle :omz:plugins:keychain identities id_rsa 01234567
# zstyle :omz:plugins:keychain options --quiet --inherit local-once --noask --nocolor --quick
# zstyle :omz:plugins:keychain agents gpg,ssh
# zinit snippet OMZP::keychain

Отредактировать файлы настроек для агента GPG и SSH, как это описано в разделах выше.

Инициализация

После редактирования файлов настройки запустить zsh. Автоматически будет загружен менеджер zinit и необходимые плагины.

Обновление

Обновление zinit и плагинов:

zu

Устранение проблем

Для решения некоторых проблем необходимо загрузить файл с дополнительными командами в терминале:

source $HOME/.config/zsh/fixes.zsh

Для обеспечения поддержки терминала kitty на системах, где недоступно его описание, можно выполнить команду:

fix-kitty-terminal-support

Для исправления работы файлового менеджера Midnight Commander в терминале kitty, можно выполнить команду:

fix-mc-kitty-support -f