git config: настройки Git на сервере сайта
Git хранит настройки в двух местах: общие для пользователя сервера — в файле ~/.gitconfig, настройки одной папки сайта — в .git/config. Команда git config показывает и меняет их. Здесь — какие настройки пригодятся на сервере сайта и как узнать, откуда Git взял значение.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Посмотрите все настройки и файлы, где они записаны:
git config --list --show-originfile:/home/ivan/.gitconfig user.name=Ivan file:/home/ivan/.gitconfig user.email=ivan@example.com file:.git/config core.filemode=true file:.git/config remote.origin.url=git@github.com:user/site.gitСлева — файл, справа — настройка и её значение.
file:.git/config— настройка только этой папки сайта.
Одна настройка: git config user.name — Git выведет значение. Пустой ответ — настройка не задана.
Где Git хранит настройки
| Ключ | Файл | Для чего |
|---|---|---|
--global | ~/.gitconfig в домашней папке пользователя | все папки этого пользователя сервера |
без ключа или --local | .git/config в папке сайта | только эта папка |
--system | /etc/gitconfig | все пользователи сервера |
Без ключа git config записывает настройку в .git/config той папки, где вы стоите. Настройка папки важнее общей: если user.name задан и в ~/.gitconfig, и в .git/config, Git возьмёт значение из .git/config.
Откуда Git взял значение:
git config --show-origin user.emailfile:/home/ivan/.gitconfig ivan@example.com--global записываются для того пользователя, от имени которого запущена команда. Если git pull на сервере запускают от другого пользователя, задайте настройки от его имени или в .git/config папки — без --global.Имя и почта для коммитов
Если на сервере делают коммиты или git pull создаёт коммит слияния, Git нужно знать имя и почту:
git config --global user.name "Ivan"
git config --global user.email "ivan@example.com"Вместо Ivan и ivan@example.com — ваши имя и почта. Ответа нет — настройки записаны, проверьте git config user.name. Без них Git ответит Author identity unknown (разбор).
Только для одной папки сайта — те же команды без --global.
Настройки для папки сайта
| Что нужно | Команда | Что изменится |
|---|---|---|
| обновлять только без коммитов слияния | git config pull.ff only | git pull остановится, если на сервере свои коммиты (git pull) |
| не замечать смену прав файлов | git config core.fileMode false | git status перестанет показывать файлы, у которых поменялись только права (old mode и new mode) |
| работать с папкой другого пользователя | git config --global --add safe.directory /var/www/example.com | Git перестанет писать detected dubious ownership (разбор) |
Проверить: git config pull.ff — ответ only; git config core.fileMode — ответ false.
safe.directory задавайте только с --global: из .git/config папки Git эту настройку не читает.
Удалить настройку
git config --unset pull.ffОтвета нет — настройка удалена. Если её не было, Git тоже ничего не напишет. Общую настройку удаляют с ключом --global: git config --global --unset user.name.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
error: key does not contain a section: name | пропущено имя раздела | пишите user.name, а не name |
warning: user.name has multiple values и error: cannot overwrite multiple values with a single value | настройка записана несколько раз, например через --add | git config --unset-all user.name, затем задайте её заново |
fatal: --local can only be used inside a git repository | команда запущена не в папке сайта | cd /var/www/example.com (разбор) |
Author identity unknown или Committer identity unknown при git commit и git pull | не заданы имя и почта | выше |
fatal: detected dubious ownership in repository | папка принадлежит другому пользователю | разбор |
| настройка задана, а Git её не видит | она записана для другого пользователя или в другой папке | git config --show-origin имя-настройки |
Команды и ответы проверены в Git 2.54; в Ubuntu 24.04 стоит Git 2.43.0 — все команды страницы в нём есть.
Источники
- Документация Git: git config — на английском: ключи --global, --local, --show-origin и --unset, настройки pull.ff, core.fileMode и safe.directory.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Установка Git на Ubuntuкак поставить Git и забрать сайт из репозитория.
- git pullкак обновить сайт и прочитать ответ.
- Команды Gitвсе команды на одной странице.