SSH Linux

SSH: ключ не используется — ssh-agent и ssh-add

  • Обновлено
  • Чтение ≈ 2 минуты

Краткий ответ

Агент не запущен или ключ не добавлен. Запустите ssh-agent, добавьте ключ ssh-add и проверьте ssh -v.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
Ключ не используется

Агент не запущен или ключ не добавлен. Запустите ssh-agent, добавьте ключ ssh-add и проверьте ssh -v.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Агент не запущенВ случае «SSH: ключ не используется — ssh-agent и ssh-add» проверьте наличие причины «Агент не запущен» по исходному действию и связанному сообщению; переходить к исправлению стоит после её подтверждения.Запустите
Ключ не добавленВ случае «SSH: ключ не используется — ssh-agent и ssh-add» проверьте наличие причины «Ключ не добавлен» по исходному действию и связанному сообщению; переходить к исправлению стоит после её подтверждения.Добавьте. Конкретное действие зависит от проверки причины «Ключ не добавлен», описанной в пошаговой инструкции.
Неверный путьВ случае «SSH: ключ не используется — ssh-agent и ssh-add» проверьте наличие причины «Неверный путь» по исходному действию и связанному сообщению; переходить к исправлению стоит после её подтверждения.Укажите. Конкретное действие зависит от проверки причины «Неверный путь», описанной в пошаговой инструкции.
Права на ключСообщение о запрете доступа возникает у конкретной учётной записи; сравните её права и права нужного файла, функции либо сетевого ресурса.Проверьте доступ нужной учётной записи и задайте только необходимые разрешения; не отключайте защиту всей системы.

#Пошаговое решение

  1. Определите причинуНа своём компьютере откройте терминал и выполните ssh-add -l; если агент недоступен, появится сообщение об отсутствии соединения с authentication agent. Затем выполните ssh -vvv пользователь@хост и найдите, какой ключ предлагается. Не запускайте случайно ssh-add -D: это удалит все загруженные идентификаторы.
  2. Выполните подходящее исправлениеЕсли агент работает, но нужный ключ отсутствует, выполните ssh-add ~/.ssh/id_ed25519 с реальным путём приватного ключа. В macOS и Windows управление агентом может отличаться; убедитесь, что ключ не лежит в общедоступном каталоге и парольная фраза запрашивается локально.
  3. Проверьте другие возможные причиныДля проверки без агента запустите ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 пользователь@хост. Если так вход работает, настройте для этого хоста IdentityFile/IdentitiesOnly yes в ~/.ssh/config, а не меняйте серверные ключи. Если нет — проверьте matching публичного ключа на сервере через консоль.
  4. Убедитесь в результатеПовторно выполните ssh-add -l и ssh -v для того же сервера, убедитесь, что предлагается нужный ключ и вход проходит. Если агент после перезагрузки пуст, проверьте его штатный запуск в своей ОС, не записывая приватный ключ или парольную фразу в сценарии автозапуска.

#Если проблема осталась

Если «SSH: ключ не используется — ssh-agent и ssh-add» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

SSH: Connection refused на порту 22 — причины и решение Проверьте, запущен ли sshd, и правила файрвола. Linux SSH Linux SSH: Permission denied (publickey) — права authorized_keys — причины и решение Проверьте владельца и права ~/.ssh и authorized_keys. Linux SSH Linux Permission denied (pu… SSH: Permission denied (publickey) — причины и решение `Permission denied (publickey)` означает, что сервер SSH отверг все предложенные клиентом ключи, а другие способы входа (например, пароль) недоступны. Причины: ключ не д… Linux SSH LinuxmacOSWindows SSH: Connection timed out — нет ответа на порту 22 — причины и решение «ssh: connect to host … port 22: Connection timed out» значит, что пакеты до сервера не доходят: закрыт порт файрволом, неверный адрес, не запущен sshd или SSH работает … Linux SSH Linux SSH: Connection refused — соединение отклонено — причины и решение Ошибка ssh: connect to host port 22: Connection refused означает, что на сервере не слушает sshd или порт закрыт файрволом. Проверьте службу sshd, порт, ufw/firewalld, п… Linux SSH Linux

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.