Создание SSH-ключа в Linux для PHP-разработчика
SSH-ключи — стандартный способ доступа к git-репозиториям и серверам без ввода пароля при каждом обращении. Разберу генерацию актуальных ключей в Linux, настройку прав и подключение ключа к GitHub, GitLab и удалённому хосту. В конце — чек-лист, который поможет не наступать на типовые грабли.
Какие ключи создавать в 2026 году
Для новых ключей выбирайте ed25519: он быстрее и короче RSA при том же или более высоком уровне безопасности. RSA всё ещё нужен для совместимости со старыми системами, но на современных серверах и хостингах обычно достаточно ed25519.
ed25519— основной выбор для GitHub, GitLab, Bitbucket, деплоя по SSH.rsa 4096— запасной вариант, если принимающая сторона не поддерживает ed25519.- DSA и ECDSA на практике создавать не стоит: DSA ограничен 1024 битами и небезопасен, ECDSA капризен к качеству генератора случайных чисел.
Генерация ed25519-ключа
Дальнейшие команды работают в любом современном дистрибутиве: Ubuntu, Debian, Fedora, Arch. Откройте терминал и выполните:
ssh-keygen -t ed25519 -a 100 -C "work-laptop-2026"Что здесь происходит:
-t ed25519— тип ключа;-a 100— число раундов KDF для защиты passphrase, актуально для новых версий OpenSSH;-C— комментарий, который попадёт в конец открытого ключа. По нему проще понять, с какой машины пришёл доступ.
Система предложит указать путь к файлу. Для большинства задач оставьте путь по умолчанию. Отдельный ключ под конкретный проект создаётся так:
ssh-keygen -t ed25519 -a 100 -f ~/.ssh/id_ed25519_github -C "github-main"Далее OpenSSH спросит passphrase:
Enter passphrase (empty for no passphrase):
Enter same passphrase again:Парольную фразу оставлять нужно. Если закрытый ключ утечёт, без passphrase злоумышленник сразу получит доступ ко всем системам, куда добавлен открытый ключ. С passphrase файл ключа останется для него бесполезным до подбора фразы.
После создания на экране появятся fingerprint и randomart — графическое представление отпечатка. Полный отпечаток можно получить позже:
ssh-keygen -lf ~/.ssh/id_ed25519.pubРезультат покажет алгоритм, длину ключа и SHA256-отпечаток, по которому ключ можно опознать на сервере или в логах.
Права на файлы и каталог
OpenSSH откажется использовать ключи, если права на них слишком открытые. Проверьте и при необходимости исправьте:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pubКаталог ~/.ssh должен быть доступен только владельцу. Закрытый ключ читается только владельцем. Открытый может быть читаемым для всех — это публичная часть.
SSH-агент и passphrase
Чтобы не вводить passphrase при каждом git push или подключении к серверу, добавьте ключ в ssh-agent. На десктопных дистрибутивах агент часто уже запущен. Проверить можно так:
ssh-add -lЕсли агент не запущен, стартуйте его и добавьте ключ:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519После разблокировки ключ останется в памяти агента до выхода из сеанса или перезагрузки.
Куда добавлять открытый ключ
Открытая часть — содержимое файла с расширением .pub. Посмотреть его можно командой:
cat ~/.ssh/id_ed25519.pubGitHub и GitLab
В настройках профиля найдите раздел SSH and GPG keys, выберите New SSH key и вставьте весь вывод cat, включая сам тип ключа ssh-ed25519 и комментарий. Проверка подключения для GitHub:
ssh -T git@github.comУспешный ответ содержит ваше имя пользователя. После этого репозитории можно клонировать по SSH-адресу, а не по HTTPS.
Удалённый Linux-сервер
Если доступ по паролю ещё работает, скопируйте открытый ключ одной командой:
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@serverЭта команда допишет ключ в ~/.ssh/authorized_keys на сервере и выставит корректные права. После этого вход через ssh user@server пойдёт по ключу.
Файл ~/.ssh/config
Когда ключей несколько, удобно описать соединения в конфигурационном файле. Для GitHub и рабочего сервера настройка выглядит так:
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_github
IdentitiesOnly yes
Host prod-server
HostName 203.0.113.10
User deploy
Port 22
IdentityFile ~/.ssh/id_ed25519_prod
IdentitiesOnly yesДиректива IdentitiesOnly yes запрещает ssh-клиенту предлагать все доступные ключи подряд. Без неё при большом количестве ключей сервер может отклонить подключение из-за лимита попыток, прежде чем дойдёт до нужного.
После настройки вместо полного адреса достаточно:
ssh prod-serverЗамена скомпрометированного ключа
Если закрытый ключ попал в чужие руки или есть подозрение на утечку, не пытайтесь «обновить» ключ — старый нужно именно удалить.
- Удалите публичный ключ из GitHub, GitLab и
authorized_keysна всех серверах. - Удалите локальные файлы закрытого и открытого ключа.
- Сгенерируйте новую пару.
- Заново добавьте открытую часть всюду, где это необходимо.
Такой же порядок действует при плановой ротации, например раз в год или при увольнении сотрудника из команды.
RSA как запасной вариант
Если принимающая сторона не поддерживает ed25519, создайте RSA-ключ на 4096 бит:
ssh-keygen -t rsa -b 4096 -a 100 -f ~/.ssh/id_rsa_fallback -C "legacy-server"Не используйте RSA-ключи меньше 3072 бит. Старые статьи до сих пор предлагают ssh-keygen -t rsa без параметра длины, но в современных версиях OpenSSH для новых ключей и так подставляется безопасное значение. Главное — не создавайте 2048-битные RSA-ключи там, где можно выбрать большее или перейти на ed25519.
Типичные проблемы
| Симптом | Причина и решение |
|---|---|
Permission denied (publickey) | Права на ~/.ssh или закрытый ключ выставлены неверно. Исправьте через chmod 700 ~/.ssh и chmod 600 ~/.ssh/id_*. |
Too many authentication failures | ssh-client перебирает все доступные ключи. В ~/.ssh/config для нужного хоста укажите IdentitiesOnly yes, а для остальных — отдельные Host-блоки. |
| Агент работает, но ключ не подхватывается | Ключ не добавлен: выполните ssh-add ~/.ssh/id_ed25519 и проверьте ssh-add -l. |
| Сервер принимал ключ и перестал | Строка в authorized_keys повреждена или добавлена с переносом. Проверьте файл: одна строка для одного ключа, без посторонних символов. |
Чек-лист настройки SSH-ключа
- Сгенерируйте ed25519-ключ:
ssh-keygen -t ed25519 -a 100 -C "осмысленный-комментарий". - Надёжную passphrase задали, записали её в менеджер паролей.
- Права на
~/.ssh— 700, на закрытый ключ — 600. - Ключ добавлен в ssh-agent:
ssh-add ~/.ssh/id_ed25519. - Открытый ключ добавлен в GitHub/GitLab и на нужные серверы через
ssh-copy-id. - Проверили подключение:
ssh -T git@github.comиssh user@server. - Для нескольких ключей настроили
~/.ssh/configсIdentityFileиIdentitiesOnly yes. - Закрытый ключ никогда не передаётся на сервер, не отправляется в чаты и не коммитится в репозиторий.
Частые вопросы
Какой тип SSH-ключа выбрать в 2026 году?
Для новых подключений выбирайте ed25519: он быстрее, короче и безопаснее RSA. RSA на 4096 бит оставьте только как запасной вариант для систем, которые не поддерживают ed25519.
Обязательно ли задавать passphrase для SSH-ключа?
Да. Без passphrase любой, кто получит файл закрытого ключа, сможет представиться вами. С passphrase злоумышленнику потребуется ещё и парольная фраза. Чтобы не вводить её постоянно, используйте ssh-agent.
Чем различаются закрытый и открытый SSH-ключи?
Закрытый ключ, например id_ed25519, хранится только у вас в ~/.ssh и никогда не передаётся наружу. Открытый ключ с расширением .pub добавляется в GitHub, GitLab или authorized_keys на сервере. По нему сервер проверяет вашу подпись.