SSH-ключи в аккаунте (blackbox.md)
Как сохранить публичные SSH-ключи в аккаунте для заказов, серверов и AI-ассистента, какие действуют лимиты и что значат ошибки.
На этой странице
На странице «SSH-ключи» (blackbox.md/ru/account/ssh-keys, «Мой аккаунт» → «SSH-ключи») хранятся публичные SSH-ключи, которые вы затем выбираете при заказе нового сервера, устанавливаете на уже работающие серверы или используете через AI-ассистента. На странице написано: «Зарегистрируйте публичные SSH-ключи, которые сможете использовать при заказе новых серверов и подключать через AI-ассистента (MCP). Приватный ключ никогда не передаётся и не хранится здесь.»
Доступно: любому клиенту, вошедшему на blackbox.md, — для ключей своего аккаунта.
Подготовьте публичный ключ
SSH-ключ состоит из двух частей. Приватная часть остаётся только на вашем компьютере. Публичная часть (файл с расширением .pub) — это то, что вы сохраняете в аккаунте. Если пары ключей у вас ещё нет, воспользуйтесь статьёй Создание SSH-ключа (Windows, macOS, Linux).
Чтобы вывести публичный ключ в Linux или macOS, выполните:
cat ~/.ssh/id_ed25519.pubВ Windows (PowerShell):
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pubЕсли ваш файл называется иначе (например, id_rsa.pub), укажите его имя. Скопируйте строку целиком — она выглядит так: ssh-ed25519 AAAAC3Nza… комментарий.
Внимание Никогда не вставляйте приватный ключ (файл без
.pub, файл.ppkиз PuTTY или текст, который начинается с-----BEGIN). Страница его не примет, но приватный ключ в любом случае не должен покидать ваш компьютер.
Как добавить ключ
- Войдите на blackbox.md и нажмите «Личный кабинет» в верхней панели (на телефоне — кружок с вашими инициалами).
- В меню слева выберите «SSH-ключи». На телефоне или планшете меню открывается кнопкой «Меню аккаунта».
- В карточке «Добавить SSH-ключ» заполните поле «Название ключа» — по нему вы будете узнавать ключ, например «Рабочий ноутбук». Поле принимает не более 80 символов.
- В поле «Публичный SSH-ключ» вставьте скопированную строку. Под полем написано: «Вставьте содержимое файла .pub (например, ~/.ssh/id_ed25519.pub). НИКОГДА не вставляйте приватный ключ.»
- Нажмите «Добавить ключ». Пока ключ сохраняется, на кнопке написано «Добавление…».
- Поля очищаются, а ключ появляется первым в таблице. Отдельного сообщения об успехе нет. Если под полями появился красный текст, найдите его в таблице ошибок ниже.
Правила и лимиты
| Правило | Значение |
|---|---|
| Поддерживаемые типы | ssh-ed25519, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, sk-ssh-ed25519@openssh.com, sk-ecdsa-sha2-nistp256@openssh.com (последние два — аппаратные ключи FIDO) |
| RSA-ключи | не менее 2048 бит |
| Формат | одна строка, не более 16 КБ |
| Название | обязательно, не более 80 символов |
| Ключей в аккаунте | не более 20 |
| Повторы | один и тот же ключ сохраняется только один раз, даже под другим названием или с другим комментарием |
| Добавление | не более 10 попыток в час; учитываются и отклонённые попытки |
| Удаление | не более 20 попыток в час |
Список сохранённых ключей
Под формой находится таблица ключей — сначала самые новые:
| Столбец | Что в нём |
|---|---|
| «Название» | название, которое вы дали ключу |
| «Тип» | тип ключа, например ssh-ed25519 |
| «Отпечаток» | отпечаток ключа SHA-256 в формате SHA256:… |
| «Добавлен» | дата и время сохранения |
| — | кнопка «Удалить» |
Если ключей нет, на странице написано «У вас пока нет сохранённых SSH-ключей.»
Чтобы проверить, что отпечаток совпадает с ключом на вашем компьютере, выполните:
ssh-keygen -lf ~/.ssh/id_ed25519.pubВ Windows (PowerShell):
ssh-keygen -lf $env:USERPROFILE\.ssh\id_ed25519.pubЗначение SHA256:… в выводе должно совпадать со значением в столбце «Отпечаток».
Где используются сохранённые ключи
Сохранение в аккаунте не устанавливает ключ ни на один сервер. Сохранённый ключ используется в трёх местах:
| Где | Как |
|---|---|
| При заказе нового сервера | На шаге «SSH-ключ для сервера» в блоке «Сохранённые ключи» отметьте один или несколько ключей (всего не более 10 ключей на заказ, считая и вставленный вручную). Подробнее — в статье SSH-ключ при заказе и серверы «только по ключу». |
| На работающем сервере | В панели app.blackbox.md → «Мои серверы», на карточке сервера: «Добавить SSH-ключ» → «Использовать сохранённый ключ», выберите ключ в списке «Выберите ключ…», затем «Добавить ключ». Результат — «Ключ добавлен.» Пошагово — в статье Добавление и удаление SSH-ключей на сервере. |
| Через AI-ассистента (MCP) | С API-токеном, у которого есть разрешение «Читать список моих SSH-ключей», ассистент видит список. С разрешением «Добавлять и удалять мои SSH-ключи» ассистент может добавлять ключи в аккаунт и удалять их. Чтобы установить ключ на сервер, нужно разрешение «Просматривать пароли/доступы к серверам». См. SSH-доступ и SSH-ключи через AI-ассистента. |
Ссылка «Как работает подключение AI (MCP) — полное руководство →» на странице открывает описание AI-интеграции (blackbox.md/ru/info/mcp).
Как удалить ключ из аккаунта
- В таблице нажмите «Удалить» в строке ключа.
- Откроется окно «Удалить SSH-ключ?» с текстом «Удалить этот SSH-ключ? Если он уже установлен на сервере, доступ к серверу это НЕ затронет — ключ удаляется только из вашего аккаунта blackbox.md.»
- Нажмите «Удалить», чтобы подтвердить, или «Отмена», чтобы передумать.
- На кнопке появится «Удаление…», затем строка исчезнет из таблицы. Если строка осталась, удалить ключ не удалось (например, вы превысили лимит в 20 попыток удаления в час); сообщения об ошибке при этом нет. Повторите попытку позже.
Важно Удаление из аккаунта НЕ убирает ключ с серверов: тот, у кого есть приватный ключ, по-прежнему может подключаться к серверам, на которых этот ключ установлен. Чтобы отозвать доступ, удалите ключ с каждого сервера: в панели «Мои серверы» → «Добавить SSH-ключ» → список «Установленные ключи» → «Удалить». В этом списке ключ показан с его комментарием и началом отпечатка, а не с названием из аккаунта.
Ошибки и сообщения
| Сообщение | Что означает | Что делать |
|---|---|---|
| «Это похоже на приватный ключ. Вставьте публичный ключ (обычно файл с расширением .pub).» | В тексте приватный ключ. | Вставьте содержимое файла .pub. |
| «Неподдерживаемый тип ключа.» | Типа ключа нет в списке (например, ssh-dss). |
Создайте ключ ssh-ed25519. |
| «RSA-ключ слишком слабый — минимум 2048 бит.» | RSA-ключ короче 2048 бит. | Создайте новый ключ, лучше ssh-ed25519. |
| «Не удалось распознать публичный ключ. Проверьте, что вставлена ровно одна строка.» | Несколько строк, неполная или повреждённая строка либо текст больше 16 КБ. | Скопируйте заново всю строку из файла .pub. |
| «Этот ключ уже добавлен в вашем аккаунте.» | Этот ключ уже сохранён, возможно под другим названием. | Используйте ключ, который уже есть в таблице. |
| «Достигнут лимит сохранённых ключей.» | У вас уже 20 ключей. | Удалите ключ, которым больше не пользуетесь. |
| «Укажите название ключа.» / «Вставьте публичный ключ.» | Одно из полей пустое. | Заполните оба поля. |
| «Не удалось добавить ключ.» | Другая ошибка, в том числе превышение лимита в 10 попыток добавления в час. | Подождите час и не повторяйте попытки: каждая попытка в это время продлевает блокировку. Если ошибка повторяется, напишите нам. |
| «Ошибка загрузки.» или другой текст ошибки (иногда на английском) вместо таблицы | Не удалось загрузить список. | Обновите страницу или войдите в аккаунт заново. |
| «Управление SSH-ключами временно недоступно.» | Функция временно недоступна, форма на странице не показывается. | Зайдите позже. Если сообщение не исчезает, обратитесь в поддержку (см. Как связаться с поддержкой BLACKBOX). |
Частые вопросы
Попадает ли сохранённый ключ на мои серверы автоматически? Нет. Вы выбираете его при заказе нового сервера или устанавливаете на работающий сервер кнопкой «Добавить SSH-ключ» в панели.
Можно ли переименовать ключ? Кнопки переименования нет. Удалите ключ из аккаунта и добавьте его снова под новым названием. На ключи, уже установленные на серверах, это не повлияет.
Ноутбук с приватным ключом потерян. Что делать? Создайте новый ключ на другом компьютере и установите его на серверы через панель. Затем удалите старый ключ из списка «Установленные ключи» на каждом сервере, а в конце — из раздела «SSH-ключи». Если доступа к серверу уже нет, воспользуйтесь статьёй Потерян доступ к серверу (пароль или ключ).
Ключ создан в PuTTYgen. Что вставлять?
Скопируйте текст из поля «Public key for pasting into OpenSSH authorized_keys file» в PuTTYgen — это одна строка, которая начинается с ssh-ed25519 или ssh-rsa. Файл, сохранённый кнопкой «Save public key», начинается с ---- BEGIN SSH2 PUBLIC KEY ----, занимает несколько строк и отклоняется с сообщением «Не удалось распознать публичный ключ…».
Почему появляется «Этот ключ уже добавлен в вашем аккаунте.», хотя название другое? Ключи сравниваются по отпечатку. Название и комментарий не учитываются, поэтому один и тот же ключ нельзя сохранить дважды.