Поиск
Справочник

git config: настройки Git на сервере сайта

Git хранит настройки в двух местах: общие для пользователя сервера — в файле ~/.gitconfig, настройки одной папки сайта — в .git/config. Команда git config показывает и меняет их. Здесь — какие настройки пригодятся на сервере сайта и как узнать, откуда Git взял значение.

≈ 4 мин чтения
Содержание 8

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Посмотрите все настройки и файлы, где они записаны:
    git config --list --show-origin
    file:/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.email
file:/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 onlygit pull остановится, если на сервере свои коммиты (git pull)
не замечать смену прав файловgit config core.fileMode falsegit status перестанет показывать файлы, у которых поменялись только права (old mode и new mode)
работать с папкой другого пользователяgit config --global --add safe.directory /var/www/example.comGit перестанет писать 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настройка записана несколько раз, например через --addgit 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 — все команды страницы в нём есть.

Источники

Сверено 9 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше