К содержимому

Как настроить ssh-agent на Ubuntu 24.04

ssh-agent хранит расшифрованные приватные ключи в памяти и подставляет их при подключении, поэтому пароль от ключа вы вводите один раз за сессию. Настройка занимает несколько минут: создать ключ, запустить агент, добавить ключ через ssh-add и прописать автозапуск в ~/.bashrc.

Руководство SSH 3 мин чтения

01Создайте ключ ed25519

Если ключа ещё нет, создайте его на своей машине. Парольную фразу задайте обязательно: ssh-agent избавит вас от повторного ввода, а сам ключ останется защищённым. Публичная часть появится рядом с приватной в ~/.ssh/id_ed25519.pub.

bash
ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub

02Скопируйте ключ на сервер

Публичный ключ нужно положить в ~/.ssh/authorized_keys пользователя на сервере. ssh-copy-id делает это сам и выставляет права на файлы. Если утилиты нет, добавьте содержимое id_ed25519.pub в файл вручную и проверьте права.

bash
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.

bash
eval $(ssh-agent -s)
ssh-add ~/.ssh/id_ed25519
ssh-add -l

04Пропишите автозапуск в ~/.bashrc

Без автозапуска агент придётся поднимать в каждой новой сессии. Добавьте в конец ~/.bashrc блок, который запускает агент, только если он ещё не работает, и подхватывает существующий сокет. После правки выполните source ~/.bashrc.

bash
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 не должна выводить ошибок.

bash
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 ключ: генерация, установка и безопасный вход на сервер: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.