Как работает агент
ssh web1 ──── «подпиши вызов сервера» ────→ ssh-agent ── ключ расшифрован, в памяти
↑ │
└──────────────── подпись ←─────────────────────┘
сервер проверяет подпись открытым ключом из authorized_keys
Закрытый ключ из агента не выдаётся — ни ssh, ни кому-то ещё. Агент только подписывает то, что ему
дали. Поэтому ssh, scp, git и редактор с удалённой разработкой пользуются одним ключом, а пароль ключа
вводится один раз: при ssh-add или при первом входе с AddKeysToAgent yes («~/.ssh/config»).
Где держать ключ
| Где | Как живёт пароль | Когда берём |
|---|---|---|
| агент ОС: служба Windows, Keychain в macOS, агент сеанса в Linux | Windows хранит добавленный ключ и после перезагрузки — пароль вводится один раз вообще. macOS и Linux — раз за вход в систему | один компьютер, один-два ключа |
| агент менеджера паролей: KeePassXC, 1Password, Bitwarden | ключ лежит в хранилище, агент открывается вместе с ним | ключи на нескольких компьютерах, хранилище и так синхронизируется |
аппаратный ключ, ed25519-sk |
закрытая часть не выходит из устройства; вход — касанием | ноутбук, который могут украсть; доступ к важным серверам |
Дальше — агент ОС: он есть везде и ничего не стоит.
Настройка
Запускаем агент
Windows. Служба
ssh-agentесть в системе, но выключена. PowerShell от администратора:Get-Service ssh-agent | Set-Service -StartupType Automatic Start-Service ssh-agent Get-Service ssh-agent # Status Name DisplayName # Running ssh-agent OpenSSH Authentication AgentmacOS. Агент запускается системой сам.
Linux с рабочим столом. Агент запускает сеанс: GNOME Keyring или юнит
ssh-agentу systemd. Проверка —echo $SSH_AUTH_SOCKне пустой.Сервер или консоль без рабочего стола. В текущей оболочке:
eval "$(ssh-agent -s)" # Agent pid 41873Добавляем ключ
ssh-add ~/.ssh/id_ed25519 # Enter passphrase for /home/me/.ssh/id_ed25519: # Identity added: /home/me/.ssh/id_ed25519 (laptop-2026)В скобках — комментарий ключа из
ssh-keygen -C(«Ключи SSH»).На macOS ключ сохраняем ещё и в Keychain, чтобы пароль не спрашивался после перезагрузки:
ssh-add --apple-use-keychain ~/.ssh/id_ed25519и в
~/.ssh/configдляHost *добавляемUseKeychain yes.Git на Windows — на тот же ssh
Git for Windows везёт свой
ssh.exe, и службу Windows он не видит:git pushбудет снова спрашивать пароль ключа. Указываем системный:git config --global core.sshCommand C:/Windows/System32/OpenSSH/ssh.exeПути — с прямыми слешами: так их понимают и git, и оболочки внутри него.
Ограничиваем, если компьютер общий
ssh-add -t 8h ~/.ssh/id_ed25519 # ключ уходит из агента через 8 часов ssh-add -c ~/.ssh/id_ed25519 # каждое использование — с подтверждением в окне ssh-add -D # убрать из агента все ключи-cтребует программу подтверждения (ssh-askpass); без неё подпись молча отклоняется.
Почему не ForwardAgent
ssh -A или ForwardAgent yes пробрасывает агент на сервер: там появляется сокет, через который
можно подписывать входы своим ключом — например, git pull с GitHub прямо с сервера.
Подписывать через этот сокет может не только наша сессия. Root на сервере может открыть сокет нашей сессии (его путь — в $SSH_AUTH_SOCK)
и, пока мы подключены, может войти нашим ключом на любой сервер и в любой репозиторий, куда этот ключ
пускает. Ключ при этом не утекает — утекает возможность им пользоваться. Взломанный сервер — это и есть
посторонний root.
| Задача | Вместо пересылки агента |
|---|---|
| до внутреннего сервера через внешний | ProxyJump («~/.ssh/config»): соединение идёт насквозь, агент остаётся на компьютере |
git pull на сервере |
deploy key на сервере, только на чтение и на один репозиторий («Конфиги серверов в git») |
| скопировать файлы между двумя серверами | scp -3 web1:/a web2:/b — через компьютер, или ключ бэкапа с restrict («Ключи SSH») |
Если пересылка всё-таки нужна — только на одну команду и с подтверждением: ssh-add -c и ssh -A web1.
На своих серверах её заодно закрываем: AllowAgentForwarding no («sshd_config»).
Если не работает
Could not open a connection to your authentication agent.
- Причина
- Агент не запущен в этой сессии, или переменная
SSH_AUTH_SOCKуказывает на сокет, которого уже нет. - Делаем
- Linux:
eval "$(ssh-agent -s)"иssh-add. Windows: службаssh-agent— шаг 1.
На Windows: Error connecting to agent: No such file or directory
- Причина
- Служба
ssh-agentостановлена; в Windows она по умолчанию выключена (Disabled). - Делаем
- Включаем автозапуск и запускаем — шаг 1, в PowerShell от администратора.
Ключ в агенте, а git push всё равно спрашивает пароль ключа
- Причина
- Git for Windows запускает свой
ssh.exe, который не видит службу Windows. - Делаем
git config --global core.sshCommand C:/Windows/System32/OpenSSH/ssh.exe.
sign_and_send_pubkey: signing failed for ED25519 … agent refused operation
- Причина
- Ключ в агенте заблокирован или истёк его срок (
ssh-add -t), либо ключ добавлен с подтверждением (-c), а окна для подтверждения нет. - Делаем
ssh-add -l— что в агенте; добавляем ключ зановоssh-add ~/.ssh/id_ed25519.
Ключей в агенте много, сервер рвёт соединение: Too many authentication failures
- Причина
- Агент предлагает все ключи по очереди.
- Делаем
IdentitiesOnly yesиIdentityFileдля хоста («~/.ssh/config»).
Как проверить
Что лежит в агенте:
ssh-add -l
# 256 SHA256:u7WTRQvHCGalFd0cVdGQ7Wm7cULmdHtHUpyj6Q0uXcA laptop-2026 (ED25519)
Пусто — The agent has no identities.
Вход идёт через агент, а не через файл: в отладке у ключа пометка agent.
ssh -v web1 true 2>&1 | grep 'Offering'
# debug1: Offering public key: /home/me/.ssh/id_ed25519 ED25519 SHA256:u7WT… explicit agent
Пересылки агента на сервер нет:
ssh web1 'echo ${SSH_AUTH_SOCK:-нет агента}'
# нет агента