[Документация Yandex Cloud](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Пошаговые инструкции](../index.md) > Работа на виртуальной машине > Подключиться к ВМ по SSH # Подключиться к виртуальной машине Linux по SSH Для подключения к [ВМ](../../concepts/vm.md) по [SSH](../../../glossary/ssh-keygen.md) используется пара ключей: открытый ключ размещается на ВМ, а закрытый ключ хранится у пользователя. Этот способ безопаснее, чем подключение по логину и паролю. Чтобы другой пользователь мог подключиться к ВМ, добавьте для него SSH-ключ по [инструкции](#vm-authorized-keys). {% note info %} При создании ВМ с доступом по [OS Login](os-login.md) указывайте SSH-ключи в [метаданных](../../concepts/metadata/sending-metadata.md). Так вы сможете [подключиться к ВМ по SSH](#vm-connect), даже если отключите для нее доступ по OS Login. {% endnote %} Чтобы подключиться к ВМ Linux по SSH: 1. [Создайте пару SSH-ключей](#creating-ssh-keys). 1. [Скопируйте открытый ключ](#copy-key) в поле **SSH-ключ** на странице создания ВМ. 1. [Подключитесь к ВМ](#vm-connect). Обучающее видео поможет вам подключиться к ВМ Linux по SSH: {% list tabs group=operating_system %} - Linux/macOS {#linux-macos} @[youtube](https://www.youtube.com/watch?v=0Q4kivQo0g4&list=PL1x4ET76A10bW1KU3twrdm7hH376z8G5R&index=10&pp=iAQB) [Смотреть видео в Yandex Cloud Video](https://runtime.strm.yandex.ru/player/video/vplvujof7tlqigs4ufgs?autoplay=0&mute=0). - Windows 10/11 {#windows} @[youtube](https://www.youtube.com/watch?v=M7m75y80VFM&list=PL1x4ET76A10bW1KU3twrdm7hH376z8G5R&index=11&pp=iAQB) [Смотреть видео в Yandex Cloud Video](https://runtime.strm.yandex.ru/player/video/vplvfxj66n2cs7nlgbzd?autoplay=0&mute=0). - Windows 7/8 {#windows7-8} @[youtube](https://www.youtube.com/watch?v=rNA-bEbSHZ8&list=PL1x4ET76A10bW1KU3twrdm7hH376z8G5R&index=12&pp=iAQB) [Смотреть видео в Yandex Cloud Video](https://runtime.strm.yandex.ru/player/video/vplvmhu4vhxduzmdtmdk?autoplay=0&mute=0). {% endlist %} ## Создание пары ключей SSH {#creating-ssh-keys} {% list tabs group=operating_system %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет [создана](../vm-create/create-linux-vm.md) ВМ. 1. Перейдите в сервис **Compute Cloud**. 1. На панели слева выберите ![image](../../../_assets/console-icons/server.svg) **Виртуальные машины**. 1. Нажмите **Создать виртуальную машину**. 1. В блоке **Доступ** нажмите **Добавить ключ**. 1. В открывшемся окне выберите `Сгенерировать ключ` и нажмите **Добавить**. При добавлении сгенерированного SSH-ключа будет создан и загружен архив с парой ключей. В ОС на базе Linux или macOS распакуйте архив в папку `/home/<имя_пользователя>/.ssh`. В ОС Windows распакуйте архив в папку `C:\Users\<имя_пользователя>/.ssh`. Дополнительно вводить открытый ключ в консоли управления не требуется. SSH-ключ будет добавлен в ваш профиль пользователя организации. Если в организации [отключена](../../../organization/operations/os-login-access.md) возможность добавления пользователями SSH-ключей в свои профили, добавленный открытый SSH-ключ будет сохранен только в профиле пользователя внутри создаваемого ресурса. {% cut "Предупреждение UNPROTECTED PRIVATE KEY FILE" %} В Unix-подобных системах после распаковки закрытого ключа в папку `.ssh` ему назначаются слишком высокие права. Из-за этого при подключении к ВМ возникает предупреждение `UNPROTECTED PRIVATE KEY FILE`. Чтобы сократить права, выполните команду: ```bash chmod 600 <путь_к_файлу_закрытого_ключа> ``` {% endcut %} - Linux/macOS {#linux-macos} 1. Откройте терминал. 1. Создайте новый ключ с помощью команды `ssh-keygen`: ```bash ssh-keygen -t ed25519 -C "<опциональный_комментарий>" ``` Вы можете передать в параметре `-C` пустую строку, чтобы не добавлять комментарий, или не указывать параметр `-C` вообще — в таком случае будет добавлен комментарий по умолчанию. После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением `.pub`, закрытый ключ — в файле без расширения. По умолчанию команда предлагает сохранить ключ под именем `id_ed25519` в директории `/home/<имя_пользователя>/.ssh`. Если в этой директории уже есть SSH-ключ с именем `id_ed25519`, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей. - Windows 10/11 {#windows} Если у вас еще не установлен [OpenSSH](https://ru.wikipedia.org/wiki/OpenSSH), установите его по [инструкции](https://learn.microsoft.com/ru-ru/windows-server/administration/openssh/openssh_install_firstuse). 1. Запустите `cmd.exe` или `powershell.exe` (предварительно обновите PowerShell). 1. Создайте новый ключ с помощью команды `ssh-keygen`: ```shell ssh-keygen -t ed25519 -C "<опциональный_комментарий>" ``` Вы можете передать в параметре `-C` пустую строку, чтобы не добавлять комментарий, или не указывать параметр `-C` вообще — в таком случае будет добавлен комментарий по умолчанию. После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением `.pub`, закрытый ключ — в файле без расширения. По умолчанию команда предлагает сохранить ключ под именем `id_ed25519` в папку `C:\Users\<имя_пользователя>/.ssh`. Если в этой директории уже есть SSH-ключ с именем `id_ed25519`, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей. - Windows 7/8 {#windows7-8} Создайте ключи с помощью приложения PuTTY: 1. [Скачайте](https://www.putty.org) и установите PuTTY. 1. Добавьте папку с PuTTY в переменную `PATH`: 1. Нажмите кнопку **Пуск** и в строке поиска Windows введите **Изменение системных переменных среды**. 1. Справа снизу нажмите кнопку **Переменные среды...**. 1. В открывшемся окне найдите параметр `PATH` и нажмите **Изменить**. 1. Добавьте путь к папке в список. 1. Нажмите кнопку **ОК**. 1. Запустите приложение PuTTYgen. 1. В качестве типа генерируемой пары выберите **EdDSA**. Нажмите **Generate** и поводите курсором в поле выше до тех пор, пока не закончится создание ключа. ![ssh_generate_key](../../../_assets/compute/ssh-putty/ssh_generate_key.png) 1. В поле **Key passphrase** введите надежный пароль. Повторно введите его в поле ниже. 1. Нажмите кнопку **Save private key** и сохраните закрытый ключ. Никому не сообщайте ключевую фразу от него. 1. Нажмите кнопку **Save public key** и сохраните открытый ключ в файле `<имя_ключа>.pub`. {% endlist %} {% note warning %} Надежно сохраните закрытый ключ: без него подключиться к ВМ будет невозможно. {% endnote %} ## Копирование открытого ключа в буфер обмена {#copy-key} [Созданный ранее](#creating-ssh-keys) открытый ключ имеет следующий формат: ```text <тип_ключа> <тело_открытого_ключа> <опциональный_комментарий> ``` Пример: > ```text > ssh-ed25519 AAAAC3NzaC1lZDI1NTE5ABFLIFyapYheN7OZNhTaNqEHefjmU5mtzK********+gRPCz user@Desktop > ``` {% note tip %} Блок `<опциональный_комментарий>` не используется при SSH-подключении, вы можете не копировать его. {% endnote %} Откройте файл `<имя_ключа>.pub` с помощью любого текстового редактора, например Notepad, и скопируйте из него ключ. Ключ должен быть записан одной строкой (не должно быть переносов и разрывов строки). Ключ можно скопировать и с помощью командной строки: {% list tabs group=operating_system %} - Linux/macOS {#linux-macos} В терминале скопируйте ключ одним из следующих способов: * Вручную. Для этого выведите на экран содержимое файла: ```bash cat <путь_к_файлу_ключа>/<имя_ключа>.pub ``` Открытый ключ будет выведен на экран. Скопируйте его в буфер обмена. * При помощи соответствующей команды: * Для Linux: `cat <путь_к_файлу_ключа>/<имя_ключа>.pub | xclip -selection clipboard`. * Для macOS: `cat <путь_к_файлу_ключа>/<имя_ключа>.pub | pbcopy`. Указанные выше команды копируют все содержимое файла, в том числе опциональный комментарий. - Windows {#windows} 1. Запустите `cmd.exe` или `powershell.exe`. 1. Скопируйте ключ одним из следующих способов: * Вручную. Для этого выведите на экран содержимое файла: ```shell type <путь_к_файлу_ключа>\<имя_ключа>.pub ``` Открытый ключ будет выведен на экран. Скопируйте его в буфер обмена. * При помощи соответствующей команды: ```shell type <путь_к_файлу_ключа>\<имя_ключа>.pub | clip ``` Указанная выше команда копирует все содержимое файла, в том числе опциональный комментарий. {% endlist %} После этого вставьте открытый ключ в поле **SSH-ключ** при создании ВМ через [консоль управления](https://kz.console.yandex.cloud). ## Подключение к ВМ {#vm-connect} Вы можете подключиться к ВМ в статусе `RUNNING` по протоколу SSH. Для инициализации всех служб после [запуска](../vm-control/vm-stop-and-start.md#start) ВМ может потребоваться время. Если возникла ошибка соединения, попробуйте снова через несколько минут. [Группы безопасности](../../../vpc/concepts/security-groups.md) ВМ должны разрешать входящий трафик по протоколу TCP на порт 22. Для подключения необходимо указать [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses) ВМ. Публичный IP-адрес можно узнать в консоли управления, в поле **Публичный IPv4-адрес** блока **Сеть** на странице ВМ. Если вы создали ВМ только с внутренним IP-адресом, [привяжите к ней публичный IP-адрес](../vm-control/vm-attach-public-ip.md). Также можно использовать [внутренние IP-адреса](../../../vpc/concepts/address.md#internal-addresses) и [FQDN](../../../vpc/concepts/address.md#fqdn) для установки SSH-соединения между ВМ внутри одной [облачной сети](../../../vpc/concepts/network.md#network) Yandex Cloud. {% list tabs group=operating_system %} - Linux/macOS {#linux-macos} В терминале выполните команду: ```bash ssh <имя_пользователя>@<публичный_IP-адрес_ВМ> ``` Где: * `<имя_пользователя>` — имя учетной записи пользователя ВМ. Если ВМ создавалась через CLI, то пользователь по умолчанию — `yc-user`. * `<публичный_IP-адрес_ВМ>` — [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses) виртуальной машины для доступа к ней через интернет. Публичный IP-адрес ВМ можно узнать в поле **Публичный IPv4-адрес** сетевого интерфейса в блоке **Сеть** на странице ВМ в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [YC CLI](../../../cli/quickstart.md) `yc compute instance get <имя_ВМ>`. Если у вас несколько закрытых ключей, укажите нужный: ```bash ssh -i <путь_к_ключу/имя_файла_ключа> <имя_пользователя>@<публичный_IP-адрес_ВМ> ``` При первом подключении к ВМ появится предупреждение о неизвестном хосте: ```text The authenticity of host '51.250.83.243 (51.250.83.243)' can't be established. ED25519 key fingerprint is SHA256:6Mjv93NJDCaf/vu3NYwiLQK4tKI+4cfLtkd********. This key is not known by any other names. Are you sure you want to continue connecting (yes/no/[fingerprint])? ``` {% note tip %} Прежде чем ввести `yes`, убедитесь, что отпечаток (`fingerprint`) ключа, отображаемый в терминале, совпадает с отпечатком SSH-ключа на ВМ. Это защитит соединение от подмены сервера. {% cut "Посмотреть отпечаток SSH-ключа на ВМ" %} 1. [Получите](../vm-info/get-serial-port-output.md) вывод последовательного порта ВМ. 1. В выводе найдите блок, который начинается со строки `BEGIN SSH HOST KEY FINGERPRINTS` и заканчивается строкой `END SSH HOST KEY FINGERPRINTS`. В этом блоке для каждого алгоритма шифрования (`ED25519`, `ECDSA`, `RSA`) приведен отпечаток вида `SHA256:...`. 1. Сравните отпечаток для нужного алгоритма с отпечатком, который SSH-клиент показал в терминале. Алгоритм указан в сообщении SSH-клиента. {% endcut %} Если отпечатки совпадают, продолжайте подключение. Если отпечатки различаются, отмените подключение и проверьте параметры ВМ и сети. {% endnote %} Введите в терминале слово `yes` и нажмите **Enter**. - Windows 10/11 {#windows} Убедитесь, что учетная запись Windows обладает правами на чтение файлов в папке с ключами. Для подключения к ВМ в командной строке выполните команду: ```shell ssh <имя_пользователя>@<публичный_IP-адрес_ВМ> ``` Где: * `<имя_пользователя>` — имя учетной записи пользователя ВМ. Если ВМ создавалась через CLI, то пользователь по умолчанию — `yc-user`. * `<публичный_IP-адрес_ВМ>` — [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses) виртуальной машины для доступа к ней через интернет. Публичный IP-адрес ВМ можно узнать в поле **Публичный IPv4-адрес** сетевого интерфейса в блоке **Сеть** на странице ВМ в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [YC CLI](../../../cli/quickstart.md) `yc compute instance get <имя_ВМ>`. Если у вас несколько закрытых ключей, укажите нужный: ```shell ssh -i <путь_к_ключу\имя_файла_ключа> <имя_пользователя>@<публичный_IP-адрес_ВМ> ``` При первом подключении к ВМ появится предупреждение о неизвестном хосте: ```text The authenticity of host '89.169.132.223 (89.169.132.223)' can't be established. ECDSA key fingerprint is SHA256:DfjfFB+in0q0MGi0HnqLNMdHssLfm1yRanB********. Are you sure you want to continue connecting (yes/no/[fingerprint])? ``` {% note tip %} Прежде чем ввести `yes`, убедитесь, что отпечаток (`fingerprint`) ключа, отображаемый в терминале, совпадает с отпечатком SSH-ключа на ВМ. Это защитит соединение от подмены сервера. {% cut "Посмотреть отпечаток SSH-ключа на ВМ" %} 1. [Получите](../vm-info/get-serial-port-output.md) вывод последовательного порта ВМ. 1. В выводе найдите блок, который начинается со строки `BEGIN SSH HOST KEY FINGERPRINTS` и заканчивается строкой `END SSH HOST KEY FINGERPRINTS`. В этом блоке для каждого алгоритма шифрования (`ED25519`, `ECDSA`, `RSA`) приведен отпечаток вида `SHA256:...`. 1. Сравните отпечаток для нужного алгоритма с отпечатком, который SSH-клиент показал в терминале. Алгоритм указан в сообщении SSH-клиента. {% endcut %} Если отпечатки совпадают, продолжайте подключение. Если отпечатки различаются, отмените подключение и проверьте параметры ВМ и сети. {% endnote %} Введите в командной строке `yes` и нажмите **Enter**. - Windows 7/8 {#windows7-8} Установите соединение с помощью приложения PuTTY: 1. Запустите приложение Pageant. 1. Нажмите правой кнопкой мыши на значок Pageant на панели задач. 1. В контекстном меню выберите пункт **Add key**. 1. Выберите сгенерированный PuTTY приватный ключ в формате `.ppk`. Если для ключа задан пароль, введите его. 1. Запустите приложение PuTTY. 1. В поле **Host Name (or IP address)** введите [публичный IP-адрес ВМ](../../../vpc/concepts/address.md#public-addresses), к которой вы хотите подключиться. Укажите порт `22` и тип соединения **SSH**. Публичный IP-адрес ВМ можно узнать в поле **Публичный IPv4-адрес** сетевого интерфейса в блоке **Сеть** на странице ВМ в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [YC CLI](../../../cli/quickstart.md) `yc compute instance get <имя_ВМ>`. ![ssh_add_ip](../../../_assets/compute/ssh-putty/ssh_add_ip.png) 1. Откройте в дереве слева пункт **Connection** → **SSH** → **Auth**. 1. Установите флаг **Allow agent forwarding**. ![ssh_choose_private_key](../../../_assets/compute/ssh-putty/authentication_parameters.png) 1. Откройте в дереве слева пункт **Connection** → **SSH** → **Auth** → **Credentials**. 1. В поле **Private key file for authentication** выберите файл с приватным ключом. ![ssh_choose_private_key](../../../_assets/compute/ssh-putty/ssh_choose_private_key.png) 1. Вернитесь в меню **Sessions**. В поле **Saved sessions** введите любое название для сессии и нажмите кнопку **Save**. Настройки сессии сохранятся под указанным именем. Вы сможете использовать этот профиль сессии для подключения с помощью Pageant. ![ssh_save_session](../../../_assets/compute/ssh-putty/ssh_save_session.png) 1. Нажмите кнопку **Open**. Если вы подключаетесь к ВМ в первый раз, может появиться предупреждение о неизвестном хосте: ![ssh_unknown_host_warning](../../../_assets/compute/ssh-putty/ssh_unknown_host_warning.png) Нажмите кнопку **Accept**. Откроется окно терминала с предложением ввести логин пользователя, от имени которого устанавливается соединение. Введите имя пользователя, которое вы указали при создании ВМ, и нажмите **Enter**. Если ВМ создавалась через CLI, то пользователь по умолчанию — `yc-user`. Если все настроено верно, будет установлено соединение с сервером. ![ssh_login](../../../_assets/compute/ssh-putty/ssh_login.png) Если вы сохранили профиль сессии в PuTTY, в дальнейшем для установки соединения можно использовать Pageant: 1. Нажмите правой кнопкой мыши на значок Pageant на панели задач. 1. Выберите пункт меню **Saved sessions**. 1. В списке сохраненных сессий выберите нужную сессию. - Yandex Cloud Shell {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) на панели слева нажмите ![image](../../../_assets/console-icons/dots-9.svg) **Все сервисы** и выберите **Compute Cloud** или найдите его с помощью строки поиска на дашборде. 1. Перейдите в ВМ, к которой хотите подключиться. 1. Убедитесь, что ВМ находится в статусе `Running`. Если ВМ не запущена, в правом верхнем углу нажмите ![image](../../../_assets/console-icons/play.svg) **Запустить** и дождитесь перехода ВМ в статус `Running`. 1. Справа вверху нажмите ![image](../../../_assets/console-icons/terminal.svg) **Подключиться в Cloud Shell**. 1. Введите логин пользователя. По умолчанию введен логин, указанный при создании ВМ. 1. Вставьте содержимое или загрузите файл закрытого SSH-ключа. 1. Нажмите **Подключиться**. Внизу откроется терминал ![image](../../../_assets/console-icons/terminal.svg) **Cloud Shell** с открытым подключением к ВМ по SSH. Чтобы закрыть подключение, нажмите ![image](../../../_assets/console-icons/xmark.svg) или используйте команду `exit`. {% endlist %} О решении проблем при подключении читайте в разделе [Вопросы и ответы](../../qa/connection.md). ## Добавление SSH-ключей для других пользователей {#vm-authorized-keys} Вы можете добавить SSH-ключи для другого пользователя ВМ. Для этого нужно создать нового пользователя и добавить для него файл с авторизованными ключами. {% note tip %} Чтобы задать одновременно нескольких пользователей с ключами при [создании](../vm-create/create-with-cloud-init-scripts.md) ВМ, используйте [метаданные](../../concepts/metadata/sending-metadata.md). Добавить пользователей с ключами через метаданные в существующую ВМ нельзя. {% endnote %} Чтобы настроить пользователей изнутри ВМ, воспользуйтесь инструкцией: 1. [Подключитесь](#vm-connect) к ВМ от имени пользователя, которого вы указали при создании ВМ в консоли управления. {% note info %} Получить информацию о ВМ вместе с пользовательскими метаданными можно с помощью команды: ```bash yc compute instance get --full <имя_ВМ> ``` {% endnote %} 1. Создайте нового пользователя `testuser` и укажите для него оболочку `bash` для использования по умолчанию: ```bash sudo useradd -m -d /home/testuser -s /bin/bash testuser ``` 1. Переключитесь на созданного пользователя: ```bash sudo su - testuser ``` 1. Создайте папку `.ssh` в домашней директории нового пользователя: ```bash mkdir .ssh ``` 1. Создайте в папке `.ssh` файл `authorized_keys`: ```bash touch .ssh/authorized_keys ``` 1. Добавьте в файл `authorized_keys` публичный ключ нового пользователя: ```bash echo "<публичный_ключ>" >> /home/testuser/.ssh/authorized_keys ``` Где `<публичный_ключ>` — содержимое файла [публичного ключа](#creating-ssh-keys) для доступа к ВМ по SSH. Файл `authorized_keys` содержит список авторизованных публичных ключей. Каждый ключ записывается с новой строки в формате `<тип_ключа> <тело_открытого_ключа> <опциональный_комментарий>`. Пример содержимого файла с несколькими ключами: ```text ssh-ed25519 AAAAC3NzaC1lZDI1NTE5ABFLIFyapYheN7OZNhTaNqEHefjmU5mtzK********+gRPCz user1@Desktop ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDdlxLIFyapYheN7OZNhTaNqEHefjmU5mtzK********+gRPCzxyz user2@Desktop ``` Чтобы добавить новый ключ, допишите его в конец файла с новой строки. Не изменяйте и не удаляйте уже существующие ключи, если хотите сохранить доступ предыдущих пользователей. 1. Измените права доступа к файлу `authorized_keys` и каталогу `.ssh`: ```bash chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys ``` 1. Отключитесь от ВМ командой `exit`. 1. [Перезапустите ВМ](../vm-control/vm-stop-and-start.md#restart). 1. Проверьте подключение для нового пользователя: ```bash ssh testuser@<публичный_IP-адрес_ВМ> ``` Где `<публичный_IP-адрес_ВМ>` — [публичный IP-адрес](../../../vpc/concepts/address.md#public-addresses) виртуальной машины для доступа к ней через интернет. Публичный IP-адрес ВМ можно узнать в поле **Публичный IPv4-адрес** сетевого интерфейса в блоке **Сеть** на странице ВМ в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [YC CLI](../../../cli/quickstart.md) `yc compute instance get <имя_ВМ>`. #### Что дальше {#what-is-next} * [Узнайте, как работать с Yandex Cloud изнутри ВМ](auth-inside-vm.md). #### Полезные ссылки {#see-also} * [Подключиться к виртуальной машине Linux по SSH с помощью Yandex Cloud Shell](cloud-shell.md) * [Подключиться к виртуальной машине Windows по RDP](rdp.md) * [Подключиться к виртуальной машине Windows через PowerShell](powershell.md) * [Подключиться к виртуальной машине по OS Login](os-login.md)