К содержимому

Как создать и добавить SSH ключ для GitHub

SSH ключ для GitHub создаётся командой ssh-keygen -t ed25519 -C "you@example.com", публичная часть добавляется в настройки аккаунта, приватная остаётся на сервере. После этого git clone и git push работают по адресу git@github.com:user/repo.git без пароля. Проверка подключения выполняется командой ssh -T git@github.com.

Руководство SSH 3 мин чтения

01Создайте ключ ed25519

Ключ создаётся от имени пользователя, который будет работать с репозиториями. Команда ssh-keygen спросит путь к файлу и парольную фразу. Путь по умолчанию ~/.ssh/id_ed25519 подходит, парольную фразу можно оставить пустой, если сервер личный и доступ к нему ограничен.

bash
ssh-keygen -t ed25519 -C "you@example.com"

02Скопируйте публичный ключ

В GitHub добавляется файл с расширением .pub, приватный ключ id_ed25519 не покидает сервер. Команда cat выводит одну строку, которая начинается с ssh-ed25519 и заканчивается комментарием с вашей почтой. Эту строку нужно скопировать целиком, без переносов.

bash
cat ~/.ssh/id_ed25519.pub

03Добавьте ключ в GitHub

Откройте в GitHub страницу Settings, раздел SSH and GPG keys, нажмите New SSH key. В поле Title впишите понятное имя сервера, например vps-example, в поле Key вставьте строку из id_ed25519.pub. Сохраните кнопкой Add SSH key, GitHub попросит пароль аккаунта.

04Проверьте права на файлы ключей

SSH отказывается использовать ключ, если права на файлы слишком широкие. Каталог ~/.ssh должен принадлежать вам с правами 700, файл authorized_keys с правами 600. Приватный ключ id_ed25519 тоже должен быть доступен только владельцу.

bash
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chmod 600 ~/.ssh/id_ed25519

05Загрузите ключ в ssh-agent

Если ключ защищён парольной фразой, её можно не вводить при каждом обращении, а один раз загрузить ключ в агент. Команда ssh-add запомнит ключ на время сессии. Для постоянной работы добавьте вызов агента в ~/.bashrc.

bash
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

06Проверьте подключение к GitHub

Команда ssh -T git@github.com устанавливает соединение и выводит приветствие с вашим логином. Сообщение Hi user! You've successfully authenticated означает, что ключ принят. Код возврата при этом равен 1, это нормально для GitHub, потому что шелл-доступ не предоставляется.

bash
ssh -T git@github.com

07Клонируйте репозиторий по SSH

Адрес репозитория для SSH начинается с git@github.com:. Скопируйте его на странице репозитория кнопкой Code, вкладка SSH. Если репозиторий уже склонирован по HTTPS, адрес удалённого репозитория меняется командой git remote set-url.

bash
git clone git@github.com:user/repo.git
git remote set-url origin git@github.com:user/repo.git

Частые ошибки

  • В GitHub вставлен приватный ключ id_ed25519 вместо публичного id_ed25519.pub. GitHub отклоняет такой ключ с ошибкой Key is invalid.

    Скопируйте содержимое файла ~/.ssh/id_ed25519.pub командой cat и вставьте строку, начинающуюся с ssh-ed25519.

  • Права на ~/.ssh или id_ed25519 слишком широкие, SSH пишет Permissions 0644 for ... are too open и не использует ключ.

    Выполните chmod 700 ~/.ssh и chmod 600 ~/.ssh/id_ed25519, затем повторите подключение.

  • Клонирование идёт по HTTPS, и git запрашивает пароль аккаунта, хотя ключ уже добавлен.

    Переключите удалённый адрес на SSH командой git remote set-url origin git@github.com:user/repo.git.

  • Ключ создан под root, а git запускается под обычным пользователем, поэтому GitHub не видит ключ.

    Создайте ключ от нужного пользователя или скопируйте пару id_ed25519 и id_ed25519.pub в его каталог ~/.ssh и выставьте права 600.

Deploykin

Как это делается в Deploykin

В Deploykin репозиторий GitHub подключается к сайту из панели, и после каждого пуша панель сама запускает деплой с миграциями и кэшами. Заходить на сервер за git pull не нужно.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем ed25519 лучше RSA для GitHub?

Ключ ed25519 короче и быстрее при той же стойкости, GitHub принимает его с 2021 года. RSA оставляют для старых клиентов, тогда используют длину не меньше 4096 бит.

Можно ли использовать один ключ на нескольких серверах?

Да, публичную часть можно добавить в GitHub с любого числа машин. Приватный ключ копируют на каждый сервер отдельно и хранят с правами 600.

Что делать, если ssh -T git@github.com отвечает Permission denied (publickey)?

Проверьте, что ключ добавлен в GitHub и загружен в агент командой ssh-add -l. Запустите подключение с отладкой ssh -vT git@github.com, чтобы увидеть, какой ключ предлагается.

Как сменить парольную фразу у существующего ключа?

Выполните ssh-keygen -p -f ~/.ssh/id_ed25519 и введите старую и новую фразу. Публичный ключ при этом не меняется, добавлять его в GitHub заново не нужно.

Ещё по теме

SSH ключ: генерация, установка и безопасный вход на сервер: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.