Закрытый репозиторий 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
- Откройте «Доступ SSH» (группа «Безопасность») и нажмите «Управление ключами SSH».
- Нажмите «Импортировать ключ».
- В поле имени укажите
github_deploy. - В поле закрытого ключа вставьте содержимое файла
github_deployцеликом, поле пароля оставьте пустым. - В поле открытого ключа вставьте содержимое
github_deploy.pubи нажмите «Импорт».
Если создать ключ самому неудобно, напишите в поддержку: «создайте ключ github_deploy без пароля для Git». Мы создадим его в вашем аккаунте и пришлём открытую часть. Закрытый ключ никому не передаётся.
3. Укажите ключ для подключения к GitHub
Чтобы Git использовал именно этот ключ, откройте «Менеджер файлов», включите показ скрытых файлов (Настройки — «Показать скрытые файлы»), откройте папку .ssh и создайте в ней файл config с текстом:
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/github_deploy
IdentitiesOnly yes4. Добавьте открытый ключ в GitHub
- Откройте репозиторий на GitHub — Settings — Deploy keys — Add deploy key.
- Title — любое название, например «hosting».
- Key — содержимое
github_deploy.pub(одна строка). - Отметку «Allow write access» не ставьте: хостингу достаточно доступа на чтение.
- Нажмите «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» — ошибка в адресе или ключ добавлен в другой репозиторий.