Автоматическая настройка SSH-ключей macOS для Git

Предварительная подготовка: генерация пары SSH-ключей

1. Откройте терминал
   Используйте Spotlight (⌘+Space) для поиска «Terminal» и откройте его.

2. Сгенерируйте пару ключей
   Выполните следующую команду (замените [email protected] на ваш email):

   ssh-keygen -t ed25519 -C "[email protected]" -f ~/.ssh/git_example

   • При появлении запроса нажмите Enter, чтобы использовать настройки по умолчанию
   • Для повышения безопасности можно установить парольную фразу (passphrase)

3. Просмотрите созданные файлы
   В каталоге ~/.ssh будет создано два файла:

   git_example    # закрытый ключ (храните в безопасности)
   git_example.pub # открытый ключ (нужно добавить на Git-сервер)

Настройка автоматического использования указанного ключа

1. Отредактируйте файл конфигурации SSH

   mkdir -p ~/.ssh && chmod 700 ~/.ssh
   vim ~/.ssh/config

2. Добавьте содержимое конфигурации
   Используйте следующий шаблон (измените параметры по необходимости):

   # Основная конфигурация Git-сервера
   Host git.example.com
       HostName git.example.com
       User git
       Port 22
       IdentityFile ~/.ssh/git_example
       IdentitiesOnly yes
   
   # Дополнительная конфигурация (для других Git-серверов)
   Host github.com
       HostName github.com
       User git
       IdentityFile ~/.ssh/github_key

3. Установите права доступа к файлу

   chmod 600 ~/.ssh/config

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

1. Добавьте открытый ключ на Git-сервер
   Скопируйте содержимое открытого ключа:

   pbcopy < ~/.ssh/git_example.pub

   Добавьте открытый ключ в:
   • GitHub: Settings → SSH and GPG keys
   • GitLab: Preferences → SSH Keys
   • Собственный Git-сервер: файл ~/.ssh/authorized_keys на сервере

Проверка конфигурации

1. Проверьте SSH-соединение

   ssh -T [email protected]

   При успешном подключении появится приветственное сообщение от сервера (например, на GitHub — «Hi username!»)

2. Проверьте клонирование репозитория

   git clone [email protected]:username/repo.git

   Система автоматически использует указанный ключ, вмешательство не требуется.

Устранение неполадок

1. Режим отладки
   Добавьте параметр -v для просмотра подробного процесса подключения:

   ssh -Tv [email protected]

2. Часто встречающиеся проблемы

   • Ошибка Permissions 0644 are too open: выполните chmod 600 ~/.ssh/*
   • Тайм-аут соединения: проверьте настройки брандмауэра или сетевого прокси
   • Ошибка аутентификации: убедитесь, что открытый ключ правильно добавлен на сервер

Расширенное применение

С помощью нескольких блоков Host можно реализовать:

• Использование разных ключей для разных платформ (GitHub/GitLab/Gitee)
• Разделение рабочей и личной учётной записи
• Управление ключами в многопользовательских серверных средах

Примечание: В примерах этой статьи git.example.com — демонстрационный домен. В реальной работе замените его на адрес вашего Git-сервера.