Что получится
компьютер сервер
~/.ssh/id_ed25519 закрытый ключ ~example-user/.ssh/authorized_keys
600, с паролем ssh-ed25519 AAAA…ключ… laptop-2026
~/.ssh/id_ed25519.pub открытый ключ ──── та же строка, одна на устройство
~/.ssh/known_hosts ключи серверов
Закрытая половина не уходит с компьютера никогда. На сервер, в GitHub, в панель провайдера идёт только
.pub.
Какой ключ создавать
| Тип | Когда берём |
|---|---|
ed25519 |
почти всегда. Короткий (строка .pub — около 100 символов), быстрый; по умолчанию в ssh-keygen с OpenSSH 9.5 |
ed25519-sk |
есть аппаратный ключ FIDO2 (YubiKey и аналоги): закрытая часть живёт в нём, вход — касанием. Нужен OpenSSH 8.2+ на обеих сторонах |
rsa -b 4096 |
сервер или устройство не знает ed25519: старый роутер, сетевое железо, OpenSSH старше 6.5 |
ecdsa |
требование политики, где ed25519 не разрешён; сам по себе не нужен |
dsa |
никогда: OpenSSH 10.0 убрал его совсем, в Ubuntu 26.04 такой ключ не примут |
Настройка
Смотрим, нет ли ключа
ls -l ~/.ssh/ # id_ed25519 id_ed25519.pub known_hostsВ PowerShell —
ls $env:USERPROFILE\.ssh. Ключ уже есть — пропускаем следующий шаг. Создав новый поверх старого, потеряем вход везде, куда открыт старый:ssh-keygenспроситOverwrite (y/n)?.Создаём ключ
ssh-keygen -t ed25519 -C "laptop-2026" # Generating public/private ed25519 key pair. # … путь — Enter, пароль ключа — дважды … # Your identification has been saved in /home/me/.ssh/id_ed25519 # Your public key has been saved in /home/me/.ssh/id_ed25519.pub # The key fingerprint is: # SHA256:u7WTRQvHCGalFd0cVdGQ7Wm7cULmdHtHUpyj6Q0uXcA laptop-2026-C— комментарий в конце строки.pub. Пишем устройство и год: через два года вauthorized_keysпо нему видно, какую строку удалять. По умолчанию тамuser@hostname.- Пароль ключа (passphrase) — да. Он шифрует файл на диске: украденный
id_ed25519без пароля бесполезен. Вводить его каждый раз не придётся — агент спросит один раз за сеанс («ssh-agent»). - Имя файла по умолчанию —
id_ed25519: такой ключsshнаходит и предлагает серверу без настройки. Ключ для отдельной задачи кладём под своим именем (-f ~/.ssh/github_infra), и тогда его указываем явно —-iилиIdentityFileв~/.ssh/config(«~/.ssh/config»).
Кладём открытый ключ на сервер
Пока вход по паролю открыт,
ssh-copy-idделает всё сам: создаёт~/.ssh, дописывает строку и ставит права.ssh-copy-id -i ~/.ssh/id_ed25519.pub [email protected] # Number of key(s) added: 1В Windows
ssh-copy-idнет, но его заменяет одна команда в PowerShell:type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh example-[email protected] "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys">>дописывает, а не перезаписывает: ключи, которые уже есть в файле, остаются.Если сервер создан с ключом из панели провайдера, cloud-init уже положил его — обычно пользователю
rootилиubuntu, зависит от провайдера. Свой пользователь и ключ для него — «Первый вход на сервер».Проверяем права на сервере
sshdпроверяет права до того, как прочитать ключ (StrictModes yesпо умолчанию). Если каталог или файл может изменить кто-то ещё, ключ молча не принимается.ls -ld ~ ~/.ssh ~/.ssh/authorized_keys # drwxr-x--- 4 example-user example-user 4096 … /home/example-user # drwx------ 2 example-user example-user 4096 … /home/example-user/.ssh # -rw------- 1 example-user example-user 93 … /home/example-user/.ssh/authorized_keysДомашний каталог,
~/.sshиauthorized_keysне должны быть доступны на запись остальным. Запись группе Ubuntu пропускает, если группа личная — в ней только сам пользователь, как уexample-userпослеadduser; в группе есть кто-то ещё — ключ не примут. В журнале тогдаAuthentication refused: bad ownership or modes for directory /home/example-user. Если файлы создавали черезsudo, владельцем сталroot— возвращаем:sudo chown -R example-user:example-user /home/example-user/.ssh.Входим по ключу
ssh -v [email protected] 2>&1 | grep -E 'Offering|Server accepts|Authenticated' # debug1: Offering public key: /home/me/.ssh/id_ed25519 ED25519 SHA256:u7WT… agent # debug1: Server accepts key: /home/me/.ssh/id_ed25519 ED25519 SHA256:u7WT… agent # Authenticated to 203.0.113.10 ([203.0.113.10]:22) using "publickey".Спросили пароль ключа — это нормально: так клиент расшифровывает файл. Спросили
[email protected]'s password:— ключ не подошёл, разбираем по «Если не работает».Кладём второй ключ
Перед тем как закрыть вход по паролю, на сервере должно быть два ключа с разных устройств: например, ноутбук и домашний компьютер, или ключ, записанный на флешку и убранный в стол. Потеря одного устройства тогда не запирает сервер.
cat ~/.ssh/authorized_keys # ssh-ed25519 AAAAC3Nza… laptop-2026 # ssh-ed25519 AAAAC3Nza… desktop-2026Дальше — закрываем пароль и root: «sshd_config».
Строка в authorized_keys
Перед ключом можно поставить ограничения через запятую. Так ключу автоматики оставляют одну задачу:
from="198.51.100.7",command="rrsync -ro /srv/backup",restrict ssh-ed25519 AAAAC3Nza… backup1-pull
| Опция | Что делает |
|---|---|
from="198.51.100.7" |
ключ принимается только с этого адреса; можно список и маски: from="10.0.0.0/8,!10.0.0.13" |
command="…" |
что бы клиент ни просил, выполняется эта команда; исходная — в $SSH_ORIGINAL_COMMAND |
restrict |
запрещает всё сразу: консоль, проброс портов и агента, X11. Нужное возвращают явно: restrict,pty |
expiry-time="20261231" |
ключ перестаёт действовать после даты (OpenSSH 7.7+) |
Ключ, который rsync использует для бэкапа, с такой строкой не откроет консоль, даже если утечёт
вместе с сервером, где лежит.
Если не работает
Permission denied (publickey), хотя ключ добавлен
- Причина
- Ключ лежит не у того пользователя (добавили в
/root/.ssh, а входим какexample-user), строка вauthorized_keysпорвана переносом или на~,~/.sshслишком открытые права: приStrictModes yes(так по умолчанию)sshdтакой файл не читает. - Делаем
- На сервере:
ls -ld ~ ~/.ssh ~/.ssh/authorized_keys— нужныdrwx------у.sshи-rw-------у файла;journalctl -u ssh -n 20назовёт причину, напримерAuthentication refused: bad ownership or modes.
WARNING: UNPROTECTED PRIVATE KEY FILE! и ключ не используется
- Причина
- Закрытый ключ читают другие пользователи компьютера. На Linux и macOS — права шире 600, на Windows — в ACL файла есть кто-то, кроме владельца.
- Делаем
- Linux, macOS:
chmod 600 ~/.ssh/id_ed25519. Windows:icacls $env:USERPROFILE\.ssh\id_ed25519 /inheritance:r /grant:r "$($env:USERNAME):F".
Load key "…": invalid format
- Причина
- Файл ключа испорчен при копировании (переводы строк CRLF, обрезан последний перевод строки) или это ключ PuTTY в формате
.ppk. - Делаем
.ppkпереводим в формат OpenSSH: PuTTYgen, Conversions — Export OpenSSH key. Испорченную копию берём заново с исходного компьютера.
ssh-copy-id нет: ssh-copy-id: command not found
- Причина
- В OpenSSH для Windows его нет.
- Делаем
- Команда из шага 3 для PowerShell делает то же самое.
Сервер всё равно спрашивает пароль пользователя
- Причина
- Ключ не подошёл, и сервер перешёл к паролю. Чаще всего клиент предложил не тот ключ.
- Делаем
ssh -v [email protected] 2>&1 | grep -E 'Offering|Server accepts|Authenticated'— видно, какие ключи ушли и какой принят. Нужный ключ указываем-iили в~/.ssh/config(«~/.ssh/config»).
Пароль ключа забыт
- Причина
- Восстановить его нельзя: ключ зашифрован этим паролем.
- Делаем
- Создаём новый ключ, входим запасным ключом или через консоль провайдера («Консоль провайдера»), меняем строку в
authorized_keys.
Как проверить
Вход идёт по ключу, а не по паролю пользователя — заставляем клиент не пробовать пароль вовсе:
ssh -o PasswordAuthentication=no -o KbdInteractiveAuthentication=no [email protected] 'echo ok'
# ok
Отпечаток своего ключа и строки на сервере совпадают:
ssh-keygen -lf ~/.ssh/id_ed25519.pub
# 256 SHA256:u7WTRQvHCGalFd0cVdGQ7Wm7cULmdHtHUpyj6Q0uXcA laptop-2026 (ED25519)
ssh [email protected] 'ssh-keygen -lf ~/.ssh/authorized_keys'
# 256 SHA256:u7WTRQvHCGalFd0cVdGQ7Wm7cULmdHtHUpyj6Q0uXcA laptop-2026 (ED25519)
# 256 SHA256:Qm4x… desktop-2026 (ED25519)