Логотип Терафермы Тераферма Регистрация
Обучение · арендаторам

SSH-ключ: как создать и подключиться к серверу

Ключ, открывающий терминал на ноутбуке, и соединение с сервером с видеокартой

SSH-ключ — это пара файлов на вашем компьютере. Публичную часть (файл .pub) вы вставляете в кабинет, и сервер пускает вас без пароля. Создаётся один раз и работает для всех серверов. Если SSH не нужен, ключ можно не делать: Jupyter и готовые программы открываются кнопкой в кабинете.

1. Проверьте, есть ли ключ

Откройте терминал: на Mac — «Терминал», на Windows — PowerShell, на Linux — любой терминал. Выполните:

Mac и Linux

ls ~/.ssh/*.pub

Windows (PowerShell)

dir $env:USERPROFILE\.ssh\*.pub

Что делать с ответом:

  • В списке есть id_ed25519.pub — ключ уже есть, переходите к шагу 3.
  • Нет id_ed25519.pub, но есть id_rsa.pub или id_ecdsa.pub — он тоже подойдёт. В шаге 3 подставьте имя этого файла вместо id_ed25519.pub.
  • Файлов много, с разными именами (work.pub, github.pub и т. п.) — это ключи для других сервисов, их не трогайте. Нужен только id_ed25519.pub или id_rsa.pub: терминал сам подставляет только их. Если таких среди файлов нет — создайте ключ в шаге 2, остальные ключи не пострадают.
  • «No such file» или «Не удаётся найти путь» — ключей нет, создайте его в шаге 2.

2. Создайте ключ (если его нет)

Команда одна для Mac, Windows и Linux:

ssh-keygen -t ed25519

Терминал задаст три вопроса — на все просто нажмите Enter: место для файла оставьте по умолчанию, фразу-пароль можно не задавать.

Если спросит «already exists. Overwrite (y/n)?» — ответьте n. Ключ у вас уже есть, перезаписывать его не нужно: переходите к шагу 3.

3. Скопируйте публичный ключ

Mac — команда сразу кладёт ключ в буфер обмена:

pbcopy < ~/.ssh/id_ed25519.pub

Windows (PowerShell)

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

Linux — выведите ключ и скопируйте строку целиком:

cat ~/.ssh/id_ed25519.pub

Правильный ключ — одна строка, начинается с ssh-ed25519. Файл без .pub — приватный ключ, его никуда не вставляйте и никому не отправляйте.

4. Вставьте ключ в кабинет

Кабинет → «Настройки» → поле «Публичный SSH-ключ» → вставьте строку → «Сохранить». Ключ сам добавится и на серверы, которые уже работают, и на все следующие.

5. Подключитесь

В «Мои серверы» скопируйте команду SSH — она выглядит так (порт у каждого сервера свой):

ssh -p 41022 root@teraferma.io

Вставьте её в терминал. При первом подключении спросят Are you sure you want to continue connecting (yes/no)? — напишите yes и Enter. Готово: вы на сервере. Проверьте видеокарту командой nvidia-smi.

Частые ошибки

«id_ed25519 already exists. Overwrite (y/n)?»

Ключ у вас уже есть. Ответьте n — не перезаписывайте, иначе старый ключ перестанет работать везде, где он добавлен. Просто покажите и скопируйте существующий (шаг 3).

«Permission denied (publickey)»

Сервер не узнал ваш ключ. Проверьте в кабинете («Настройки»), что вставлен именно ваш публичный ключ — та же строка, что выводит cat ~/.ssh/id_ed25519.pub. Если ключей несколько, укажите нужный явно: ssh -i ~/.ssh/id_ed25519 -p … root@teraferma.io.

«Connection refused» или «Connection closed»

Сервер ещё запускается или уже остановлен. Дождитесь статуса «Работает» в «Мои серверы» и повторите. Если сервер работает, а ошибка остаётся дольше пары минут — напишите в чат поддержки.

«REMOTE HOST IDENTIFICATION HAS CHANGED»

Под этим же портом раньше был другой сервер, и компьютер его запомнил. Удалите старую запись (подставьте свой порт): ssh-keygen -R "[teraferma.io]:41022" — и подключитесь снова.

«UNPROTECTED PRIVATE KEY FILE» или «bad permissions»

Ключ доступен другим пользователям компьютера, и SSH его не берёт. На Mac и Linux: chmod 600 ~/.ssh/id_ed25519.

«ssh не является внутренней или внешней командой» (Windows)

Не установлен клиент OpenSSH. Откройте «Параметры» → «Приложения» → «Дополнительные компоненты» → «Добавить компонент» → «Клиент OpenSSH», затем откройте PowerShell заново.

В кабинете пишет «Это не похоже на публичный SSH-ключ»

Скорее всего, скопирован приватный ключ (начинается с -----BEGIN OPENSSH PRIVATE KEY-----). Его никому не отправляйте. Нужен файл с окончанием .pub — строка начинается с ssh-ed25519.

Терминал просит пароль

Пароля у сервера нет — вход только по ключу. Значит, ключ не подошёл: смотрите ошибку «Permission denied» выше. Если при создании ключа вы задали фразу-пароль, терминал может спрашивать её — это пароль от вашего ключа, а не от сервера.

Не получилось

Напишите в чат поддержки в правом нижнем углу и приложите скриншот терминала — его можно вставить в чат через Ctrl+V. Пока разбираемся, можно работать через Jupyter: «Открыть Jupyter» → File → New → Terminal — это тот же терминал на сервере, без ключа.

Ключ готов — запускайте

Готовые программы открываются кнопкой, SSH — для своих скриптов и обучения.