ssh-agent и ssh-add: вводить фразу от ключа один раз
ssh-agent держит ваши ключи в памяти. Фразу от ключа вы вводите один раз, при добавлении, а дальше ssh и scp берут ключ у агента.
Содержание 9
Что сделать прямо сейчас
- Проверьте, запущен ли агент:
ssh-add -l. ОтветThe agent has no identities.или список ключей — агент работает, переходите к шагу 3. - Ответ
Could not open a connection to your authentication agent.— агента нет. Запустите его в этом окне:eval "$(ssh-agent -s)". Появится строкаAgent pidс номером. - Добавьте ключ:
ssh-add ~/.ssh/id_ed25519. Введите фразу от ключа — появитсяIdentity added: /home/ivan/.ssh/id_ed25519 (ivan@laptop). - Подключитесь к серверу: фразу больше не спросят.
На 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 перебирает их все | разбор ошибки |
Источники
- man ssh-agent — на английском: запуск с -s и остановка с -k.
- man ssh-add — на английском: ключи -l, -L, -d, -D, -t и файлы, которые берутся без аргументов.
- man ssh_config — на английском: AddKeysToAgent и ForwardAgent.
- Исходный код OpenSSH 9.6: ssh-add.c — тексты Identity added, The agent has no identities и Could not open a connection to your authentication agent.
- Microsoft: управление ключами OpenSSH в Windows — на английском: как включить службу ssh-agent.
Сверено 23 октября 2026 года.
Что почитать дальше
- ssh-copy-idположить ключ на сервер.
- Файл config для SSHIdentityFile и IdentitiesOnly.
- Ошибка Too many authentication failuresесли ключей много.
- ssh-keygenкак задать или сменить фразу от ключа.