207 lines
6.3 KiB
Markdown
207 lines
6.3 KiB
Markdown
# Быстрая установка
|
||
|
||
```sh
|
||
sudo apt-get install curl
|
||
sh -c "$(curl -fsSL https://git.246060.ru/config/zsh/raw/branch/master/install.sh)"
|
||
```
|
||
|
||
# Установка
|
||
|
||
Установить оболочку [Zsh](https://www.zsh.org) и git:
|
||
|
||
```sh
|
||
sudo apt-get install git zsh curl
|
||
```
|
||
|
||
На системах, где нет пакета Zsh или есть только старая версия, можно установить статически
|
||
скомпилированную версию программы командой:
|
||
|
||
```sh
|
||
sh -c "$(curl -fsSL https://raw.githubusercontent.com/romkatv/zsh-bin/master/install)"
|
||
```
|
||
|
||
Установить рекомендуемые пакеты:
|
||
|
||
```sh
|
||
sudo apt-get install command-not-found grc grepcidr kitty-terminfo wmctrl xdotool
|
||
```
|
||
|
||
Установить дополнительные программы по [инструкции](https://git.246060.ru/config/eget/).
|
||
|
||
|
||
Клонировать репозиторий с настройками Zsh в каталог `~/.config/zsh`:
|
||
|
||
```sh
|
||
git clone https://git.246060.ru/config/zsh ~/.config/zsh
|
||
```
|
||
|
||
# Базовая настройка
|
||
|
||
Создать файл `$HOME/.zshenv` со следующим содержимым:
|
||
|
||
```sh
|
||
# Загрузка конфигурации из каталога $ZDOTDIR
|
||
export ZDOTDIR=$HOME/.config/zsh
|
||
source $ZDOTDIR/.zshenv
|
||
```
|
||
|
||
Установить интерпретатор Zsh по умолчанию для пользователя `username`.
|
||
|
||
```sh
|
||
sudo usermod -s /usr/bin/zsh username
|
||
```
|
||
|
||
# Установка шрифтов
|
||
|
||
```sh
|
||
wget -A ".deb" -c -q -np -nd -r -l 1 https://deb.246060.ru/bin/fonts/pool/main/f/fonts-iosevka-prog/
|
||
wget -A ".deb" -c -q -np -nd -r -l 1 https://deb.246060.ru/bin/fonts/pool/main/f/fonts-iosevka-prog-nerd/
|
||
sudo dpkg -i fonts*deb
|
||
```
|
||
|
||
# Настройка агентов
|
||
|
||
Существует несколько вариантов настройки агентов для SSH и/или GPG.
|
||
Для любого из вариантов следует скопировать шаблонный файл для настроек:
|
||
|
||
```sh
|
||
cp ~/.config/zsh/55-agents.zsh ~/.config/zsh/55-agents.user.zsh
|
||
```
|
||
|
||
## Настройка SSH агента
|
||
|
||
Установить необходимые пакеты:
|
||
|
||
```sh
|
||
sudo apt install openssh-client
|
||
```
|
||
|
||
Раскомментировать в файле ` ~/.config/zsh/55-agents.user.zsh` строки:
|
||
|
||
```sh
|
||
# if command -v ssh-agent >/dev/null 2>&1; then
|
||
# 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
|
||
# fi
|
||
```
|
||
|
||
Добавить в конец файла `~/.ssh/config` правило для разрешения агенту сохранять ключи:
|
||
|
||
```text
|
||
Host *
|
||
AddKeysToAgent yes
|
||
```
|
||
|
||
|
||
## Настройка GPG агента
|
||
|
||
Установить необходимые пакеты:
|
||
|
||
```sh
|
||
sudo apt install openssh-client gpg-agent gpgconf
|
||
```
|
||
|
||
Раскомментировать в файле ` ~/.config/zsh/55-agents.user.zsh` строки:
|
||
|
||
```sh
|
||
# if command -v gpg-agent >/dev/null 2>&1; then
|
||
# zinit snippet OMZP::gpg-agent
|
||
# if command -v gpg-conf >/dev/null 2>&1; then
|
||
# gpgconf --create-socketdir
|
||
# fi
|
||
# fi
|
||
```
|
||
|
||
Пример файла настройки GPG агента `~/.config/gnupg/gpg-agent.conf`:
|
||
|
||
```text
|
||
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`, как это описано
|
||
в разделе настройки SSH.
|
||
|
||
|
||
## Настройка Keychain
|
||
|
||
Программа Keychain позволит использовать агенты GPG и SSH между входами в систему.
|
||
Для её работы необходимо отключить в системе все автоматические запуски агентов,
|
||
например в файле `/etc/X11/Xsession.options` удалить строку:
|
||
|
||
```sh
|
||
use-ssh-agent
|
||
```
|
||
|
||
Установить необходимые пакеты:
|
||
|
||
```sh
|
||
sudo apt install keychain openssh-client gpg-agent gpgconf
|
||
```
|
||
|
||
Раскомментировать в файле ` ~/.config/zsh/55-agents.user.zsh` строки:
|
||
|
||
```sh
|
||
# if command -v keychain >/dev/null 2>&1; then
|
||
# zstyle :omz:plugins:keychain identities id_rsa 01234567
|
||
# zstyle :omz:plugins:keychain options --quiet --inherit any-once --noask --nocolor --absolute --dir ~/.cache/keychain
|
||
# zstyle :omz:plugins:keychain agents gpg,ssh
|
||
# zinit snippet OMZP::keychain
|
||
# fi
|
||
```
|
||
|
||
Отредактировать файлы настроек для агента GPG и SSH, как это описано в разделах выше.
|
||
|
||
|
||
## Инициализация
|
||
|
||
После редактирования файлов настройки запустить `zsh`. Автоматически будет загружен
|
||
менеджер [zinit](https://github.com/zdharma-continuum/zinit) и необходимые плагины.
|
||
|
||
|
||
## Обновление
|
||
|
||
Обновление `zinit` и плагинов:
|
||
|
||
```sh
|
||
zu
|
||
````
|
||
|
||
## Устранение проблем
|
||
|
||
Для решения некоторых проблем необходимо загрузить файл с дополнительными
|
||
командами в терминале:
|
||
|
||
```sh
|
||
source $HOME/.config/zsh/fixes.zsh
|
||
```
|
||
|
||
Если в системе установлена программа `fzf` версии ниже `0.53.0`, то может
|
||
не работать поиск по истории, файлам и автодополнение. Исправление:
|
||
|
||
```
|
||
fix-update-fzf
|
||
```
|
||
|
||
Для обеспечения поддержки терминала `kitty` на системах, где недоступно
|
||
его описание, можно выполнить команду:
|
||
|
||
```sh
|
||
fix-kitty-terminal-support
|
||
```
|
||
|
||
Для исправления работы файлового менеджера Midnight Commander в терминале
|
||
`kitty`, можно выполнить команду:
|
||
|
||
```sh
|
||
fix-mc-kitty-support -f
|
||
```
|