PHPTime

Создание 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. Откройте терминал и выполните:

Shell
ssh-keygen -t ed25519 -a 100 -C "work-laptop-2026"

Что здесь происходит:

  • -t ed25519 — тип ключа;
  • -a 100 — число раундов KDF для защиты passphrase, актуально для новых версий OpenSSH;
  • -C — комментарий, который попадёт в конец открытого ключа. По нему проще понять, с какой машины пришёл доступ.

Система предложит указать путь к файлу. Для большинства задач оставьте путь по умолчанию. Отдельный ключ под конкретный проект создаётся так:

Shell
ssh-keygen -t ed25519 -a 100 -f ~/.ssh/id_ed25519_github -C "github-main"

Далее OpenSSH спросит passphrase:

Shell
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

Парольную фразу оставлять нужно. Если закрытый ключ утечёт, без passphrase злоумышленник сразу получит доступ ко всем системам, куда добавлен открытый ключ. С passphrase файл ключа останется для него бесполезным до подбора фразы.

После создания на экране появятся fingerprint и randomart — графическое представление отпечатка. Полный отпечаток можно получить позже:

Shell
ssh-keygen -lf ~/.ssh/id_ed25519.pub

Результат покажет алгоритм, длину ключа и SHA256-отпечаток, по которому ключ можно опознать на сервере или в логах.

Права на файлы и каталог

OpenSSH откажется использовать ключи, если права на них слишком открытые. Проверьте и при необходимости исправьте:

Shell
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub

Каталог ~/.ssh должен быть доступен только владельцу. Закрытый ключ читается только владельцем. Открытый может быть читаемым для всех — это публичная часть.

SSH-агент и passphrase

Чтобы не вводить passphrase при каждом git push или подключении к серверу, добавьте ключ в ssh-agent. На десктопных дистрибутивах агент часто уже запущен. Проверить можно так:

Shell
ssh-add -l

Если агент не запущен, стартуйте его и добавьте ключ:

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

После разблокировки ключ останется в памяти агента до выхода из сеанса или перезагрузки.

Куда добавлять открытый ключ

Открытая часть — содержимое файла с расширением .pub. Посмотреть его можно командой:

Shell
cat ~/.ssh/id_ed25519.pub

GitHub и GitLab

В настройках профиля найдите раздел SSH and GPG keys, выберите New SSH key и вставьте весь вывод cat, включая сам тип ключа ssh-ed25519 и комментарий. Проверка подключения для GitHub:

Shell
ssh -T git@github.com

Успешный ответ содержит ваше имя пользователя. После этого репозитории можно клонировать по SSH-адресу, а не по HTTPS.

Удалённый Linux-сервер

Если доступ по паролю ещё работает, скопируйте открытый ключ одной командой:

Shell
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@server

Эта команда допишет ключ в ~/.ssh/authorized_keys на сервере и выставит корректные права. После этого вход через ssh user@server пойдёт по ключу.

Файл ~/.ssh/config

Когда ключей несколько, удобно описать соединения в конфигурационном файле. Для GitHub и рабочего сервера настройка выглядит так:

Shell
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-клиенту предлагать все доступные ключи подряд. Без неё при большом количестве ключей сервер может отклонить подключение из-за лимита попыток, прежде чем дойдёт до нужного.

После настройки вместо полного адреса достаточно:

Shell
ssh prod-server

Замена скомпрометированного ключа

Если закрытый ключ попал в чужие руки или есть подозрение на утечку, не пытайтесь «обновить» ключ — старый нужно именно удалить.

  1. Удалите публичный ключ из GitHub, GitLab и authorized_keys на всех серверах.
  2. Удалите локальные файлы закрытого и открытого ключа.
  3. Сгенерируйте новую пару.
  4. Заново добавьте открытую часть всюду, где это необходимо.

Такой же порядок действует при плановой ротации, например раз в год или при увольнении сотрудника из команды.

RSA как запасной вариант

Если принимающая сторона не поддерживает ed25519, создайте RSA-ключ на 4096 бит:

Shell
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 failuresssh-client перебирает все доступные ключи. В ~/.ssh/config для нужного хоста укажите IdentitiesOnly yes, а для остальных — отдельные Host-блоки.
Агент работает, но ключ не подхватываетсяКлюч не добавлен: выполните ssh-add ~/.ssh/id_ed25519 и проверьте ssh-add -l.
Сервер принимал ключ и пересталСтрока в authorized_keys повреждена или добавлена с переносом. Проверьте файл: одна строка для одного ключа, без посторонних символов.

Чек-лист настройки SSH-ключа

  1. Сгенерируйте ed25519-ключ: ssh-keygen -t ed25519 -a 100 -C "осмысленный-комментарий".
  2. Надёжную passphrase задали, записали её в менеджер паролей.
  3. Права на ~/.ssh — 700, на закрытый ключ — 600.
  4. Ключ добавлен в ssh-agent: ssh-add ~/.ssh/id_ed25519.
  5. Открытый ключ добавлен в GitHub/GitLab и на нужные серверы через ssh-copy-id.
  6. Проверили подключение: ssh -T git@github.com и ssh user@server.
  7. Для нескольких ключей настроили ~/.ssh/config с IdentityFile и IdentitiesOnly yes.
  8. Закрытый ключ никогда не передаётся на сервер, не отправляется в чаты и не коммитится в репозиторий.

Частые вопросы

Какой тип SSH-ключа выбрать в 2026 году?

Для новых подключений выбирайте ed25519: он быстрее, короче и безопаснее RSA. RSA на 4096 бит оставьте только как запасной вариант для систем, которые не поддерживают ed25519.

Обязательно ли задавать passphrase для SSH-ключа?

Да. Без passphrase любой, кто получит файл закрытого ключа, сможет представиться вами. С passphrase злоумышленнику потребуется ещё и парольная фраза. Чтобы не вводить её постоянно, используйте ssh-agent.

Чем различаются закрытый и открытый SSH-ключи?

Закрытый ключ, например id_ed25519, хранится только у вас в ~/.ssh и никогда не передаётся наружу. Открытый ключ с расширением .pub добавляется в GitHub, GitLab или authorized_keys на сервере. По нему сервер проверяет вашу подпись.

Справка по теме

Ещё в разделе «Linux и серверы»

Ajenti в 2026: панель управления сервером для PHP-разработчика

Обновлённый взгляд на Ajenti: как поставить панель на современный Linux-сервер, настроить HTTPS, защитить PHP-проекты на 8.3–8.5 и не наступить на грабли.

8 мин

HTTP/2 и HTTP/3 для PHP-сайта на nginx: настройка и диагностика

Как включить HTTP/2 и HTTP/3 для PHP-сайта на nginx, настроить TLS и QUIC, проверить протокол через curl и найти причину сбоя после перехода.

6 мин

Горячие клавиши в PhpStorm на Linux: чиним работу в русской раскладке

Почему в PhpStorm на Linux не работают горячие клавиши в русской раскладке и как это исправить: javaagent, vmoptions, XIM, Wayland и настройки IDE.

6 мин

Поиск текста в файлах в Linux: grep, find, ripgrep и примеры для PHP-проекта

Как искать текст в файлах Linux: grep -rn, find с фильтрами по дате, ripgrep для больших проектов. Разбор на примере современного PHP-кода.

5 мин