Закрытый репозиторий GitHub в cPanel: ключ развёртывания

Закрытый репозиторий GitHub нельзя склонировать по обычной https-ссылке. Надёжный способ — SSH-ключ развёртывания (deploy key): отдельный ключ, который даёт доступ только к одному репозиторию и только на чтение.

Git Version Control в cPanel подключается к GitHub сам, без вашего участия, и не может ввести пароль ключа (passphrase). Поэтому ключ должен быть без пароля. Форма «Создать новый ключ» в cPanel требует пароль, так что ключ без пароля нужно создать на своём компьютере и импортировать — или попросить поддержку.

1. Создайте ключ на своём компьютере

В Windows (PowerShell), macOS или Linux выполните команду и на вопрос о пароле дважды нажмите Enter:

ssh-keygen -t ed25519 -C "github_deploy" -f github_deploy -N ""

Появятся два файла: github_deploy — закрытый ключ, github_deploy.pub — открытый.

2. Импортируйте ключ в cPanel

  1. Откройте «Доступ SSH» (группа «Безопасность») и нажмите «Управление ключами SSH».
  2. Нажмите «Импортировать ключ».
  3. В поле имени укажите github_deploy.
  4. В поле закрытого ключа вставьте содержимое файла github_deploy целиком, поле пароля оставьте пустым.
  5. В поле открытого ключа вставьте содержимое github_deploy.pub и нажмите «Импорт».

Если создать ключ самому неудобно, напишите в поддержку: «создайте ключ github_deploy без пароля для Git». Мы создадим его в вашем аккаунте и пришлём открытую часть. Закрытый ключ никому не передаётся.

3. Укажите ключ для подключения к GitHub

Чтобы Git использовал именно этот ключ, откройте «Менеджер файлов», включите показ скрытых файлов (Настройки — «Показать скрытые файлы»), откройте папку .ssh и создайте в ней файл config с текстом:

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/github_deploy
    IdentitiesOnly yes

4. Добавьте открытый ключ в GitHub

  1. Откройте репозиторий на GitHub — Settings — Deploy keys — Add deploy key.
  2. Title — любое название, например «hosting».
  3. Key — содержимое github_deploy.pub (одна строка).
  4. Отметку «Allow write access» не ставьте: хостингу достаточно доступа на чтение.
  5. Нажмите «Add key».

5. Склонируйте репозиторий

В Git Version Control нажмите «Создать», в «Клонировать URL-адрес» укажите SSH-адрес репозитория, например git@github.com:user/repo.git, выберите папку и нажмите «Создать». Пароль запрашиваться не будет.

Обновление по расписанию

Чтобы сайт обновлялся из GitHub сам, без GitHub Actions, добавьте в Cron Jobs задание, например раз в 15 минут:

cd $HOME/repositories/repo && git pull --ff-only

Если файлы нужно копировать в папку сайта, используйте файл .cpanel.yml из статьи Git в cPanel.

Если не работает

  • «Permission denied (publickey)» — открытый ключ не добавлен в Deploy keys этого репозитория или в config указано другое имя ключа.
  • Клонирование зависает или требует пароль — ключ создан с паролем; создайте ключ без пароля.
  • «Repository not found» — ошибка в адресе или ключ добавлен в другой репозиторий.
Вопросы и ответы
Нужен SSH-ключ без пароля, добавленный в Deploy keys репозитория: cPanel не может ввести пароль ключа. Ключ с паролем, созданный формой cPanel, не подойдёт.
Создайте ключ на своём компьютере командой ssh-keygen без пароля и импортируйте его через «Доступ SSH» — «Управление ключами SSH» — «Импортировать ключ», или попросите поддержку создать ключ.
Нет. Для клонирования и обновления сайта достаточно доступа на чтение — не ставьте отметку Allow write access.