basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалLinuxSSH

    Ключи SSH: от ssh-keygen до входа без пароля

    Создаём ключ ed25519 с паролем на своём компьютере, кладём открытую половину в authorized_keys на сервере и проверяем, что сервер пускает по ключу. Пароль на сервере пока не закрываем — это следующий шаг, «sshd_config».

    Что получится

    компьютер                                 сервер
    ~/.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 такой ключ не примут

    Настройка

    1. Смотрим, нет ли ключа

      ls -l ~/.ssh/
      # id_ed25519  id_ed25519.pub  known_hosts

      В PowerShell — ls $env:USERPROFILE\.ssh. Ключ уже есть — пропускаем следующий шаг. Создав новый поверх старого, потеряем вход везде, куда открыт старый: ssh-keygen спросит Overwrite (y/n)?.

    2. Создаём ключ

      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»).
    3. Кладём открытый ключ на сервер

      Пока вход по паролю открыт, 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, зависит от провайдера. Свой пользователь и ключ для него — «Первый вход на сервер».

    4. Проверяем права на сервере

      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.

    5. Входим по ключу

      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: — ключ не подошёл, разбираем по «Если не работает».

    6. Кладём второй ключ

      Перед тем как закрыть вход по паролю, на сервере должно быть два ключа с разных устройств: например, ноутбук и домашний компьютер, или ключ, записанный на флешку и убранный в стол. Потеря одного устройства тогда не запирает сервер.

      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)