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

.gitignore: какие файлы сайта Git не должен трогать

В файле .gitignore перечислено, что Git не должен добавлять в репозиторий: настройки с паролями, загрузки посетителей, журналы, кэш. Эти файлы живут только на сервере. Если они вписаны в .gitignore, их не удалят команды git clean -f -d и git stash -u. Здесь — что вписать, как проверить правило и что делать, если файл уже попал в репозиторий.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Откройте файл: nano .gitignore (редактор nano). Если файла нет, nano создаст его.
  4. Впишите по одному правилу в строке, например для WordPress:
    wp-config.php
    .env
    wp-content/uploads/
    wp-content/cache/
    *.log
  5. Сохраните: Ctrl+O, Enter, затем Ctrl+X.
  6. Проверьте, что правила работают:
    git check-ignore -v wp-config.php error.log
    .gitignore:1:wp-config.php	wp-config.php
    .gitignore:5:*.log	error.log

    В строке — файл с правилами, номер строки, само правило и закрытый файл. Нет строки для файла — он не закрыт.

Если .gitignore уже есть в репозитории, правку сделайте в репозитории, а на сервере выполните git pull. Правка только на сервере покажет в git status строку M .gitignore, и следующий git pull может остановиться на этом файле. Правила только для сервера пишите в .git/info/exclude — ниже.

Как писать правила

ПравилоЧто закрывает
wp-config.phpфайл с этим именем в любой папке сайта
/wp-config.phpтолько файл в корне папки сайта
wp-content/uploads/папку загрузок со всем, что в ней
*.logвсе файлы, имя которых заканчивается на .log
!keep.logисключение: этот файл не закрывать, хотя есть *.log
# комментарийпояснение, Git эту строку пропускает

Если git check-ignore -v выводит правило с !, файл не закрыт: сработало исключение.

Проверить, что закрыто

git status --ignored -s
!! .env
!! error.log
!! wp-config.php
!! wp-content/

!! — файл или папка закрыты правилами. Без --ignored команда git status их не показывает (git status).

Если попробовать добавить закрытый файл:

git add .env
The following paths are ignored by one of your .gitignore files:
.env

Файл не добавлен — так и задумано. git add . закрытые файлы пропускает молча. Ключ -f (git add -f .env) добавит файл, несмотря на правило: с файлами, где лежат пароли, так не делайте.

Правила только для сервера

Файл .git/info/exclude пишется так же, как .gitignore, но в репозиторий не попадает и git pull его не меняет. Сюда — то, что есть только на этом сервере: копии, архивы, файлы проверки домена.

nano .git/info/exclude

Впишите правило в конце файла, например backup.zip, и проверьте:

git check-ignore -v backup.zip
.git/info/exclude:7:backup.zip	backup.zip

Если файл уже в репозитории

Правило не действует на файлы, которые уже есть в репозитории: Git по-прежнему показывает их правки в git status, а git check-ignore -v для них ничего не выводит. Проверьте: git ls-files wp-config.php — если Git вывел имя, файл в репозитории.

Убрать файл из репозитория и оставить его на диске:

  1. В папке, где вы делаете коммиты:
    git rm --cached wp-config.php

    Ответ: rm 'wp-config.php'. Файл остался в папке, а git status -s показывает D wp-config.php — из репозитория он уйдёт со следующим коммитом.

  2. Сделайте коммит и отправьте его в репозиторий: git commit -m "wp-config.php в .gitignore", затем git push.
Когда такой коммит придёт на сервер, git pull удалит файл из папки сайта: для Git файл удалён из репозитория. Перед git pull сохраните копию — cp wp-config.php ~/wp-config.php.bak, — после верните: cp ~/wp-config.php.bak wp-config.php. Если файл уже пропал, сразу после git pull достаньте его из прошлой версии: git show ORIG_HEAD:wp-config.php > wp-config.php, затем проверьте права файла (права на файлы сайта). Подробнее — разбор.
Пароль, который попал в репозиторий, остаётся в истории коммитов и после git rm --cached. Смените его.

Ошибки и как их исправить

Что видитеПричинаЧто делать
правило вписано, а git status показывает правки файлафайл уже в репозиториивыше, разбор
The following paths are ignored by one of your .gitignore files:файл закрыт правиломтак и задумано; какое правило — git check-ignore -v имя-файла
после git pull пропал wp-config.php или .envфайл убрали из репозитория командой git rm --cachedgit show ORIG_HEAD:wp-config.php > wp-config.php (выше)
M .gitignore в git status.gitignore правили на сервереперенесите правку в репозиторий, на сервере git restore .gitignore и git pull; правила для сервера — в .git/info/exclude
fatal: pathspec 'wp-content/' did not match any files при git rm --cached -r wp-content/папки нет в репозиторииничего делать не нужно: Git её и так не хранит

Команды и ответы проверены в Git 2.54; в Ubuntu 24.04 стоит Git 2.43.0 — все команды страницы в нём есть.

Источники

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

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

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

  • git cleanкак удалить лишние файлы и не задеть закрытые.
  • git stashпочему git stash -u может убрать .env.
  • Команды Gitвсе команды на одной странице.