К содержимому

Ошибка git pull permission denied на VPS: как исправить

Ошибка permission denied при git pull на VPS означает, что у пользователя нет прав на запись в каталог репозитория или на чтение SSH-ключа. Сначала проверьте, под каким пользователем вы работаете и кому принадлежат файлы в /var/www/example.com.

Ошибка Деплой 3 мин чтения

01Файлы репозитория принадлежат другому пользователю

Если git pull запущен от пользователя deploy, а файлы в /var/www/example.com принадлежат root или www-data, Git не сможет обновить рабочую копию. Проверьте владельца командой ls -la /var/www/example.com. Исправьте владельца на пользователя, который выполняет деплой: sudo chown -R deploy:deploy /var/www/example.com.

bash
ls -la /var/www/example.com
sudo chown -R deploy:deploy /var/www/example.com

02Нет прав на запись в каталог.git

Git хранит служебные файлы в подкаталоге .git. Если на него или на отдельные файлы внутри установлены права только для чтения, git pull завершится с permission denied. Проверьте права: ls -la /var/www/example.com/.git. Убедитесь, что владелец совпадает с пользователем деплоя, и при необходимости выполните sudo chown -R deploy:deploy /var/www/example.com/.git.

bash
ls -la /var/www/example.com/.git
sudo chown -R deploy:deploy /var/www/example.com/.git

03SSH-ключ не найден или недоступен

При подключении к удалённому репозиторию по SSH Git использует ключ из ~/.ssh. Если ключ отсутствует, лежит не у того пользователя или имеет слишком открытые права, соединение не установится. Проверьте наличие ключа: ls -la ~/.ssh/id_rsa. Права на файл ключа должны быть 600, на каталог .ssh, 700. Исправьте: chmod 700 ~/.ssh && chmod 600 ~/.ssh/id_rsa.

bash
ls -la ~/.ssh/id_rsa
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_rsa

04Публичный ключ не добавлен в GitHub или GitLab

Если в выводе ошибки есть Permission denied (publickey), сервер не прошёл аутентификацию. Убедитесь, что публичный ключ пользователя деплоя добавлен в настройки аккаунта или в Deploy Keys репозитория. Проверьте подключение: ssh -T git@github.com. Для GitLab команда будет ssh -T git@gitlab.com.

bash
ssh -T git@github.com

05Репозиторий подключён по HTTPS без токена

Если git remote -v показывает URL вида https://github.com/user/app.git, Git может запрашивать пароль, а при его отсутствии выдавать ошибку доступа. Для приватных репозиториев используйте personal access token или переключитесь на SSH. Проверьте текущий remote и при необходимости замените его: git remote set-url origin git@github.com:user/app.git.

bash
git remote -v
git remote set-url origin git@github.com:user/app.git

06Как убедиться, что ошибка устранена

Выполните git pull от пользователя деплоя. Команда должна завершиться без сообщений permission denied. Затем проверьте, что новые файлы появились в рабочей копии, и при необходимости обновите зависимости и права на каталоги Laravel: sudo chown -R www-data:www-data storage bootstrap/cache.

bash
git pull
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan optimize
sudo chown -R www-data:www-data storage bootstrap/cache

Что не помогает

  • Запускать git pull от root, а потом удивляться, что веб-сервер не может писать в storage.

    Выполняйте деплой от отдельного пользователя, например deploy, и выставляйте права на storage и bootstrap/cache для www-data.

  • Исправлять права командой chmod -R 777 на весь проект.

    Такой доступ открывает файлы всем пользователям системы. Достаточно сменить владельца через chown и выдать точечные права на запись только нужным каталогам.

  • Копировать приватный SSH-ключ в репозиторий или в открытый каталог.

    Храните ключ в ~/.ssh пользователя деплоя с правами 600. Для CI используйте переменные окружения или deploy-ключи с ограниченным доступом.

Deploykin

Как это делается в Deploykin

В Deploykin репозиторий GitHub подключается к сайту из панели, и после каждого пуша панель сама запускает деплой с миграциями и кэшами. git pull по SSH не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему git pull выдаёт Permission denied (publickey)?

Сервер не смог аутентифицироваться по SSH-ключу. Проверьте, что публичный ключ добавлен в GitHub или GitLab, а приватный ключ доступен пользователю, от которого выполняется git pull.

Можно ли делать git pull от root?

Технически можно, но тогда новые файлы будут принадлежать root, и www-data не сможет писать в storage и bootstrap/cache. Лучше деплоить от отдельного пользователя.

Как сменить владельца файлов после неудачного git pull?

Выполните sudo chown -R deploy:deploy /var/www/example.com, где deploy, пользователь, который делает деплой. Для каталогов storage и bootstrap/cache отдельно установите владельца www-data.

Что делать, если git pull пишет permission denied на файл .git/FETCH_HEAD?

Файл принадлежит другому пользователю. Смените владельца всего каталога .git на пользователя деплоя: sudo chown -R deploy:deploy /var/www/example.com/.git.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.