Поиск
Справочник

ssh-agent и ssh-add: вводить фразу от ключа один раз

ssh-agent держит ваши ключи в памяти. Фразу от ключа вы вводите один раз, при добавлении, а дальше ssh и scp берут ключ у агента.

≈ 4 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Проверьте, запущен ли агент: ssh-add -l. Ответ The agent has no identities. или список ключей — агент работает, переходите к шагу 3.
  2. Ответ Could not open a connection to your authentication agent. — агента нет. Запустите его в этом окне: eval "$(ssh-agent -s)". Появится строка Agent pid с номером.
  3. Добавьте ключ: ssh-add ~/.ssh/id_ed25519. Введите фразу от ключа — появится Identity added: /home/ivan/.ssh/id_ed25519 (ivan@laptop).
  4. Подключитесь к серверу: фразу больше не спросят.

На Mac агент запускает сама система, шаг 2 не нужен. Если ключ создан без фразы, агент тоже не нужен — ssh возьмёт ключ из файла сам.

Команды ssh-add

КомандаЧто делает
ssh-addдобавить ключи с именами по умолчанию: ~/.ssh/id_ed25519, id_rsa, id_ecdsa и соседние
ssh-add ~/.ssh/work_ed25519добавить ключ из другого файла
ssh-add -lсписок ключей: отпечаток и комментарий
ssh-add -Lоткрытые ключи целиком
ssh-add -d ~/.ssh/id_ed25519убрать один ключ
ssh-add -Dубрать все ключи
ssh-add -t 1h ~/.ssh/id_ed25519добавить ключ на час, потом агент его забудет

-d и -D убирают ключ только из памяти агента, файлы ключей остаются на месте.

Агент живёт в одном окне

Команда eval "$(ssh-agent -s)" сообщает адрес агента только этому окну терминала. В новом окне ssh-add -l снова ответит Could not open a connection… — запустите агента там ещё раз. Остановить агента этого окна: eval "$(ssh-agent -k)".

Добавлять ключ автоматически

Чтобы не набирать ssh-add, впишите в файл config строку:

Host *
    AddKeysToAgent yes

Тогда при первом подключении ssh спросит фразу и сам положит ключ в работающий агент. Вместо yes можно указать время, например AddKeysToAgent 4h: через четыре часа ключ из агента уберётся. Агента эта строка не запускает — он должен уже работать.

В Windows

В Windows агент — служба, по умолчанию выключенная. По инструкции Microsoft её включают в PowerShell, открытом от имени администратора:

Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent

Ключ добавляют в своём окне PowerShell: ssh-add $env:USERPROFILE\.ssh\id_ed25519. Проверка — ssh-add -l.

Агент на сервере: ssh -A

Ключ -A (или строка ForwardAgent yes) пересылает агента на сервер, чтобы оттуда ходить дальше вашим ключом. Включайте его только для своих серверов: пока вы подключены, тот, кто на сервере может читать чужие файлы, сможет входить вашими ключами. Сами ключи он не получит, но пользоваться ими сможет.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Could not open a connection to your authentication agent.агент в этом окне не запущенeval "$(ssh-agent -s)"
Error connecting to agent: …адрес агента есть, но агент не отвечаетзапустите агента заново; в Windows — включите службу
Bad passphrase, try again for …фраза от ключа невернаявведите снова; Enter на пустой строке — отказ
Too many authentication failuresв агенте много ключей, ssh перебирает их всеразбор ошибки

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше