Как создать и добавить 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.
01Создайте ключ ed25519
Ключ создаётся от имени пользователя, который будет работать с репозиториями. Команда ssh-keygen спросит путь к файлу и парольную фразу. Путь по умолчанию ~/.ssh/id_ed25519 подходит, парольную фразу можно оставить пустой, если сервер личный и доступ к нему ограничен.
ssh-keygen -t ed25519 -C "you@example.com"
02Скопируйте публичный ключ
В GitHub добавляется файл с расширением .pub, приватный ключ id_ed25519 не покидает сервер. Команда cat выводит одну строку, которая начинается с ssh-ed25519 и заканчивается комментарием с вашей почтой. Эту строку нужно скопировать целиком, без переносов.
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 тоже должен быть доступен только владельцу.
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chmod 600 ~/.ssh/id_ed25519
05Загрузите ключ в ssh-agent
Если ключ защищён парольной фразой, её можно не вводить при каждом обращении, а один раз загрузить ключ в агент. Команда ssh-add запомнит ключ на время сессии. Для постоянной работы добавьте вызов агента в ~/.bashrc.
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
06Проверьте подключение к GitHub
Команда ssh -T git@github.com устанавливает соединение и выводит приветствие с вашим логином. Сообщение Hi user! You've successfully authenticated означает, что ключ принят. Код возврата при этом равен 1, это нормально для GitHub, потому что шелл-доступ не предоставляется.
ssh -T git@github.com
07Клонируйте репозиторий по SSH
Адрес репозитория для SSH начинается с git@github.com:. Скопируйте его на странице репозитория кнопкой Code, вкладка SSH. Если репозиторий уже склонирован по HTTPS, адрес удалённого репозитория меняется командой git remote set-url.
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 SSH протокол: ключи и безопасный вход на Ubuntu 24.04 Пошаговая настройка SSH на Ubuntu 24.04: генерация ключа ed25519, ssh-copy-id, отключение пароля, порт 22, проверка входа и разбор ошибок Permission denied…
- Руководство · SSH Как настроить SSH туннель на Ubuntu 24.04 Как настроить SSH туннель на Ubuntu 24.04: ключи, вход без пароля, проброс портов, обратный туннель и проверка командой ssh -v.
- Руководство · SSH Как создать SSH ключ и настроить вход на сервер Пошагово: генерация ключа ed25519 через ssh-keygen, копирование публичного ключа на сервер, права на файлы, проверка входа и типичные ошибки.
- Руководство · SSH SSH подключение по ключу на Ubuntu 24.04: команды и проверка Как настроить SSH подключение по ключу на Ubuntu 24.04: создание ключа ed25519, копирование на сервер, права на ~/.ssh, отключение пароля и проверка входа.
- Руководство · SSH Установка и настройка SSH на Ubuntu 24.04 Как установить и включить SSH на Ubuntu 24.04: ключи ed25519, ssh-copy-id, настройка sshd_config.d, отключение пароля и проверка входа во втором терминале.
- Руководство · SSH Как зайти на сервер по SSH: ключи и безопасный вход Как зайти на сервер по SSH с Ubuntu 24.04 и Windows: создание ключа ed25519, ssh-copy-id, права на.ssh, отключение пароля и проверка входа во втором терминале.
SSH ключ: генерация, установка и безопасный вход на сервер: все материалы темы