Как настроить ssh-agent на Ubuntu 24.04
ssh-agent хранит расшифрованные приватные ключи в памяти и подставляет их при подключении, поэтому пароль от ключа вы вводите один раз за сессию. Настройка занимает несколько минут: создать ключ, запустить агент, добавить ключ через ssh-add и прописать автозапуск в ~/.bashrc.
01Создайте ключ ed25519
Если ключа ещё нет, создайте его на своей машине. Парольную фразу задайте обязательно: ssh-agent избавит вас от повторного ввода, а сам ключ останется защищённым. Публичная часть появится рядом с приватной в ~/.ssh/id_ed25519.pub.
ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub
02Скопируйте ключ на сервер
Публичный ключ нужно положить в ~/.ssh/authorized_keys пользователя на сервере. ssh-copy-id делает это сам и выставляет права на файлы. Если утилиты нет, добавьте содержимое id_ed25519.pub в файл вручную и проверьте права.
ssh-copy-id user@203.0.113.10
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
03Запустите ssh-agent и добавьте ключ
Агент запускается командой eval $(ssh-agent -s), она выставляет переменные SSH_AUTH_SOCK и SSH_AGENT_PID в текущей оболочке. После этого ssh-add загружает приватный ключ в память агента и спрашивает парольную фразу один раз. Список загруженных ключей показывает ssh-add -l.
eval $(ssh-agent -s)
ssh-add ~/.ssh/id_ed25519
ssh-add -l
04Пропишите автозапуск в ~/.bashrc
Без автозапуска агент придётся поднимать в каждой новой сессии. Добавьте в конец ~/.bashrc блок, который запускает агент, только если он ещё не работает, и подхватывает существующий сокет. После правки выполните source ~/.bashrc.
if [ -z "$SSH_AUTH_SOCK" ]; then
eval $(ssh-agent -s)
fi
ssh-add -l > /dev/null 2>&1 || ssh-add ~/.ssh/id_ed25519
05Проверьте вход без пароля
Подключитесь к серверу по SSH: пароль от ключа агент подставит сам, а пароль учётной записи не понадобится. На сервере проверьте, что вход по ключу разрешён и конфиг sshd корректен. Команда sudo sshd -t не должна выводить ошибок.
ssh user@203.0.113.10
sudo sshd -t
sudo systemctl reload ssh
Частые ошибки
-
После перезагрузки или новой вкладки терминала
ssh-add -lпишет «Could not open a connection to your authentication agent».Агент не запущен в этой оболочке. Выполните
eval $(ssh-agent -s)или добавьте блок автозапуска в~/.bashrcи примените его черезsource ~/.bashrc. -
ssh-addотвечает «Permissions 0644 for '/home/user/.ssh/id_ed25519' are too open» и отказывается загружать ключ.Ограничьте права:
chmod 600 ~/.ssh/id_ed25519иchmod 700 ~/.ssh. Приватный ключ не должен быть доступен другим пользователям. -
Сервер всё равно просит пароль учётной записи, хотя ключ добавлен в агент.
Проверьте, что публичный ключ лежит в
~/.ssh/authorized_keysнужного пользователя и что в/etc/ssh/sshd_configстоитPubkeyAuthentication yes. После правки выполнитеsudo sshd -tиsudo systemctl reload ssh. -
В
~/.bashrcагент запускается заново при каждом входе, и старые ключи теряются.Запускайте агент только при пустой переменной
SSH_AUTH_SOCK, как в блоке автозапуска. Иначе каждый новый shell создаёт отдельный процесс и отдельный набор ключей.
Deploykin
Как это делается в Deploykin
В Deploykin вход по SSH-ключам настраивается сам при подключении сервера: вход под root отключается, SSH переезжает на другой порт. Ключи пользователей сервера добавляются из панели, а команды можно выполнять в терминале панели, без локального SSH-клиента.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем ssh-agent отличается от ключа с парольной фразой?
Ключ на диске зашифрован парольной фразой. ssh-agent держит расшифрованную копию в памяти и подставляет её при подключении, поэтому фразу вы вводите один раз за сессию, а не при каждом входе.
Нужен ли ssh-agent на самом сервере?
Обычно нет. Агент нужен на машине, с которой вы подключаетесь, чтобы не вводить пароль от ключа каждый раз. На сервере достаточно authorized_keys и настроенного sshd.
Как проверить, какие ключи загружены в агент?
Команда ssh-add -l выводит отпечатки и комментарии загруженных ключей. Если агент не запущен, она вернёт ошибку подключения к агенту.
Что делает eval $(ssh-agent -s)?
Команда запускает ssh-agent и выполняет выводленные им строки SSH_AUTH_SOCK=... и SSH_AGENT_PID=... в текущей оболочке. Без eval переменные не попадут в окружение и клиент не найдёт агент.
Как убрать ключ из агента?
Удалите конкретный ключ командой ssh-add -d ~/.ssh/id_ed25519, а все ключи сразу через ssh-add -D. После выхода из системы агент завершится и ключи исчезнут из памяти.
Ещё по теме
- Руководство · SSH SSH протокол: ключи и безопасный вход на Ubuntu 24.04 Пошаговая настройка SSH на Ubuntu 24.04: генерация ключа ed25519, ssh-copy-id, отключение пароля, порт 22, проверка входа и разбор ошибок Permission denied…
- Руководство · SSH Как настроить SSH туннель на Ubuntu 24.04 Как настроить SSH туннель на Ubuntu 24.04: ключи, вход без пароля, проброс портов, обратный туннель и проверка командой ssh -v.
- Руководство · SSH Как создать SSH ключ и настроить вход на сервер Пошагово: генерация ключа ed25519 через ssh-keygen, копирование публичного ключа на сервер, права на файлы, проверка входа и типичные ошибки.
- Руководство · SSH SSH подключение по ключу на Ubuntu 24.04: команды и проверка Как настроить SSH подключение по ключу на Ubuntu 24.04: создание ключа ed25519, копирование на сервер, права на ~/.ssh, отключение пароля и проверка входа.
- Руководство · SSH Как создать и добавить SSH ключ для GitHub Пошагово: создайте ключ ed25519, добавьте его в GitHub, настройте ssh-agent и проверьте подключение командой ssh -T git@github.com. Разбор частых ошибок.
- Руководство · SSH Установка и настройка SSH на Ubuntu 24.04 Как установить и включить SSH на Ubuntu 24.04: ключи ed25519, ssh-copy-id, настройка sshd_config.d, отключение пароля и проверка входа во втором терминале.
SSH ключ: генерация, установка и безопасный вход на сервер: все материалы темы