Установка HTTP-сервера Git с Nginx на Ubuntu 18.04
Организация централизованного доступа к Git-репозиториям через HTTP часто требуется в командах, где нет возможности или желания использовать SSH-ключи. Nginx в связке с модулем git-http-backend (входит в состав Git) позволяет быстро поднять сервер, который поддерживает как анонимное чтение, так и аутентифицированную запись. В этой статье рассмотрим полный цикл настройки на Ubuntu 18.04: от подготовки системы до проверки работоспособности и защиты соединения.
Материал ориентирован на администраторов и разработчиков, знакомых с основами Linux и Git. Все шаги проверены на практике и сопровождаются пояснениями, которые помогут избежать распространённых ошибок. Если вы впервые настраиваете подобный сервер, рекомендуется выполнять команды последовательно и внимательно проверять конфигурационные файлы.
Подготовка системы и установка пакетов
Перед установкой убедитесь, что система обновлена, а на сервере есть права sudo. Ubuntu 18.04 поставляется с Git версии 2.17 и Nginx 1.14, чего достаточно для базовой конфигурации. Начните с обновления списка пакетов и установки необходимого ПО.
sudo apt update
sudo apt install git nginx fcgiwrap -y
Пакет fcgiwrap потребуется для запуска CGI-скриптов через Nginx. Хотя Git-http-backend можно запускать напрямую через spawn-fcgi, fcgiwrap проще в настройке и автоматически управляет сокетом. После установки проверьте статусы служб:
systemctl status nginx
systemctl status fcgiwrap
Обе службы должны быть активны. Если Nginx не запустился, проверьте конфигурацию командой nginx -t и устраните ошибки. На этом подготовительный этап завершён.
Создание репозитория и настройка прав доступа
Для хранения репозиториев создайте отдельный каталог, например /var/git. Владельцем можно сделать пользователя www-data, от имени которого работает Nginx, или специального пользователя git. Второй вариант предпочтительнее с точки зрения безопасности.
sudo adduser —system —shell /bin/bash —gecos ‘Git Version Control’ —group —disabled-password —home /home/git git
sudo mkdir -p /var/git
sudo chown git:git /var/git
Теперь создайте пустой репозиторий. Это можно сделать от пользователя git:
sudo -u git git init —bare /var/git/project.git
Обратите внимание: для HTTP-доступа нужен именно bare-репозиторий (без рабочей копии). Права на каталог должны позволять чтение и запись пользователю, от которого работает CGI-скрипт (обычно www-data). Проще всего добавить www-data в группу git и выставить групповые права:
sudo usermod -aG git www-data
sudo chmod -R 775 /var/git
Если планируется только чтение, достаточно прав 755. Для записи через HTTP потребуется аутентификация и соответствующие права.
Настройка Nginx для Git HTTP
Создайте конфигурационный файл для виртуального хоста, например /etc/nginx/sites-available/git. В нём нужно описать location, который передаёт запросы к git-http-backend через fcgiwrap.
server {
listen 80;
server_name git.example.com;
location / {
root /var/git;
autoindex on;
}
location ~ ^/(.*\.git)/(.*)$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
fastcgi_param GIT_HTTP_EXPORT_ALL «»;
fastcgi_param GIT_PROJECT_ROOT /var/git;
fastcgi_param PATH_INFO /$1/$2;
fastcgi_param REMOTE_USER $remote_user;
fastcgi_pass unix:/var/run/fcgiwrap.socket;
}
}
Включите сайт и перезагрузите Nginx:
sudo ln -s /etc/nginx/sites-available/git /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
Проверьте доступность репозитория через браузер или curl. При обращении к http://git.example.com/project.git/info/refs?service=git-upload-pack должен вернуться ответ с корректным content-type. Если этого не произошло, проверьте логи Nginx (/var/log/nginx/error.log) и права доступа.
Аутентификация и управление доступом
По умолчанию любой пользователь сможет читать репозитории, если в конфигурации не ограничен доступ. Для базовой аутентификации используйте директиву auth_basic и файл паролей, созданный утилитой htpasswd (пакет apache2-utils).
sudo apt install apache2-utils -y
sudo htpasswd -c /etc/nginx/.htpasswd gituser
Добавьте в location с Git-бэкендом:
auth_basic «Git Repository»;
auth_basic_user_file /etc/nginx/.htpasswd;
Теперь при обращении к репозиторию потребуется ввести логин и пароль. Для разграничения прав на чтение и запись можно использовать два location: один с limit_except GET и проверкой пользователя, другой — без ограничений. Например:
location ~ ^/(.*\.git)/git-receive-pack$ {
auth_basic «Git Push»;
auth_basic_user_file /etc/nginx/.htpasswd;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
fastcgi_param GIT_HTTP_EXPORT_ALL «»;
fastcgi_param GIT_PROJECT_ROOT /var/git;
fastcgi_param PATH_INFO /$1/git-receive-pack;
fastcgi_param REMOTE_USER $remote_user;
fastcgi_pass unix:/var/run/fcgiwrap.socket;
}
Такой подход позволяет разрешить анонимное клонирование, но требовать пароль для отправки изменений. Не забывайте, что передача пароля по HTTP без шифрования небезопасна — используйте HTTPS.
Настройка HTTPS и защита соединения
Для шифрования трафика получите сертификат. Можно использовать самоподписанный сертификат для внутренних нужд или бесплатный от Let’s Encrypt. В случае самоподписанного:
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
-keyout /etc/ssl/private/git.key -out /etc/ssl/certs/git.crt
Затем измените конфигурацию Nginx, добавив listen 443 ssl и пути к сертификатам. Не забудьте перенаправить HTTP на HTTPS. После перезагрузки Nginx проверьте доступ по HTTPS. Для Let’s Encrypt удобно использовать certbot, который автоматически обновляет сертификаты.
Использование HTTPS критически важно, если вы передаёте учётные данные. Без шифрования пароли могут быть перехвачены.
Дополнительно рекомендуется ограничить доступ по IP для чувствительных репозиториев и регулярно обновлять ПО.
Типичные ошибки и их устранение
В процессе настройки администраторы часто сталкиваются с рядом проблем. Ниже приведены наиболее распространённые:
- Ошибка 403 при доступе к репозиторию — обычно вызвана неверными правами на каталог /var/git или отсутствием пользователя www-data в группе git.
- Ошибка 502 Bad Gateway — свидетельствует о проблемах с fcgiwrap. Проверьте, запущен ли сокет /var/run/fcgiwrap.socket и доступен ли он для Nginx.
- Некорректный ответ git-http-backend — часто связан с неправильной передачей PATH_INFO. Убедитесь, что в конфигурации используется правильное регулярное выражение.
- Отказ в доступе при push — проверьте, что для location git-receive-pack настроена аутентификация и пользователь имеет права на запись в каталог репозитория.
Для диагностики используйте логи Nginx и fcgiwrap. Включайте отладочный вывод при необходимости.
Проверка работоспособности и дальнейшие шаги
После настройки проверьте работу сервера с помощью клонирования:
git clone http://git.example.com/project.git
Если репозиторий клонируется, значит базовая конфигурация верна. Затем попробуйте внести изменения и выполнить push (с аутентификацией). Убедитесь, что изменения появляются в репозитории.
Для удобства управления можно добавить веб-интерфейс, например GitWeb или сторонние решения, но это выходит за рамки данной статьи. Регулярно создавайте резервные копии каталога /var/git и следите за обновлениями безопасности.
Частые вопросы
Можно ли использовать эту конфигурацию на других версиях Ubuntu?
Да, подход применим и к более новым версиям, однако пути к сокетам и версии пакетов могут отличаться. Рекомендуется проверять актуальную документацию.
Как добавить нового пользователя для доступа к Git?
Используйте команду htpasswd /etc/nginx/.htpasswd новый_пользователь и назначьте ему права на каталог репозитория при необходимости.
Почему при клонировании возникает ошибка «repository not found»?
Вероятно, путь к репозиторию в URL не совпадает с фактическим расположением или в конфигурации Nginx неверно указан GIT_PROJECT_ROOT. Проверьте соответствие.
Нужно ли устанавливать дополнительные модули для Nginx?
Нет, стандартный пакет Nginx из репозитория Ubuntu уже содержит всё необходимое для работы с FastCGI.