Ошибка git pull permission denied на VPS: как исправить
Ошибка permission denied при git pull на VPS означает, что у пользователя нет прав на запись в каталог репозитория или на чтение SSH-ключа. Сначала проверьте, под каким пользователем вы работаете и кому принадлежат файлы в /var/www/example.com.
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.
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.
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.
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.
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.
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.
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.
Ещё по теме
- Ошибка · Деплой Ошибка 500 в Laravel: где искать причину и как исправить Разбираем ошибку 500 в Laravel: где смотреть логи, как проверить права на storage и bootstrap/cache, APP_KEY, синтаксис nginx и PHP-FPM. Команды для диагностики и…
- Ошибка · Деплой php artisan migrate ошибка: причины и исправление Разбираем ошибки php artisan migrate: отказ доступа к MySQL, неверный.env, права на storage. Команды проверки, конфиг nginx и PHP 8.3, как убедиться, что миграции…
- Ошибка · Деплой Ошибка composer install: как найти причину и исправить Разбираем ошибки composer install: нехватка памяти, права доступа, версия PHP. Команды для диагностики и исправления на Ubuntu 24.04 с nginx, PHP 8.3 и MySQL 8.
- Ошибка · Деплой Ошибка 419 Page Expired в Laravel: причины и исправление Почему Laravel выдаёт 419 Page Expired: CSRF-токен, cookie сессии, SESSION_DOMAIN, кэш конфига. Как проверить и исправить каждую причину.
- Ошибка · Деплой Ошибка 413 Request Entity Too Large в nginx: как исправить Ошибка 413 в nginx: как найти лимит client_max_body_size, изменить его в конфиге, проверить PHP и перезапустить nginx. Команды и примеры.
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы