Установка и настройка Git сервера: различия между версиями

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Оформление: строка навигации; в старых статьях — нумерация шагов, размер картинок, лишние пустые строки, повтор заголовка
Статья переписана по результатам проверки на Ubuntu 24.04: исправлены ошибки, добавлены снимки экрана
 
(не показаны 2 промежуточные версии этого же участника)
Строка 1: Строка 1:
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]]</div>
<div class="ark-crumbs">[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]]</div>
= Установка и настройка Git сервера =
Git — система, которая хранит историю изменений кода. Свой Git-сервер на VDS — это закрытое хранилище проектов, доступное только вам и вашей команде, без ограничений сторонних сервисов. В статье — простой и надёжный вариант: доступ по SSH и ключам, без веб-интерфейса. Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с Git 2.43, снимки экрана сняты с настоящего сервера.


== 1. Подготовка системы ==
'''Что выбрать.''' Способ из этой статьи подходит одному разработчику или небольшой команде, где все участники имеют доступ ко всем проектам. Если нужны веб-интерфейс, права на отдельные проекты, задачи и проверка кода — ставьте [[Настройка системы контроля версий GitLab|GitLab]]; ему нужен VDS от 8 ГБ памяти. Серверу из этой статьи хватит самого младшего тарифа.


* Войдите в систему под учетной записью с правами '''root''' или пользователя с правами '''sudo'''.
== 1. Пользователь и каталог ==
* Убедитесь, что у вас есть доступ к серверу через SSH или консоль.


== 2. Установка Git ==
Все участники подключаются к серверу под одним служебным пользователем <code>git</code>. Ему назначается особая оболочка <code>git-shell</code>: она разрешает только команды Git и не даёт войти в терминал сервера.


=== Установка пакета ===
<pre>sudo apt update
sudo apt install -y git
sudo adduser --disabled-password --gecos "" --shell /usr/bin/git-shell git
sudo mkdir -p /srv/git
sudo chown git:git /srv/git</pre>


1. Обновите список пакетов:
[[Файл:Linux-git-user.png|800px]]
<pre>sudo apt update</pre>


2. Установите Git:
* Ключ <code>--disabled-password</code> создаёт пользователя без пароля: войти под ним можно только по ключу.
<pre>sudo apt install git</pre>
* Проекты будут храниться в каталоге <code>/srv/git</code>.


3. Установите дополнительные компоненты:
== 2. Ключи участников ==
<pre>sudo apt install git-core gitweb git-daemon-run</pre>


=== Проверка установки ===
Каждый участник создаёт у себя на компьютере ключ SSH и передаёт вам открытую часть — содержимое файла <code>id_ed25519.pub</code>. Как создать ключ, описано в статье [[Установка и настройка SSH сервера]].


1. Проверьте версию Git:
Создайте файл ключей и вставьте в него открытые ключи — по одному в строке:
<pre>git --version</pre>


2. Проверьте конфигурацию:
<pre>sudo mkdir -p /home/git/.ssh
<pre>git config --list</pre>
sudo nano /home/git/.ssh/authorized_keys</pre>


== 3. Настройка Git сервера ==
Перед каждым ключом допишите ограничения — тогда этот ключ нельзя использовать ни для чего, кроме Git:


=== Создание пользователя для Git ===
<pre>no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty ssh-ed25519 AAAAC3... ivan@laptop</pre>


1. Создайте пользователя для Git:
Задайте права и отключите приветствие сервера при входе:
<pre>sudo useradd -m -s /bin/bash git</pre>


2. Установите пароль:
<pre>sudo chmod 700 /home/git/.ssh
<pre>sudo passwd git</pre>
sudo chmod 600 /home/git/.ssh/authorized_keys
sudo chown -R git:git /home/git/.ssh
sudo -u git touch /home/git/.hushlogin</pre>


3. Создайте директорию для репозиториев:
== 3. Хранилище проекта ==
<pre>sudo mkdir -p /home/git/repositories</pre>
<pre>sudo chown git:git /home/git/repositories</pre>
<pre>sudo chmod 755 /home/git/repositories</pre>


=== Настройка SSH ключей ===
<pre>sudo -u git git init --bare --initial-branch=main /srv/git/project.git</pre>


1. Переключитесь на пользователя git:
[[Файл:Linux-git-repo.png|800px]]
<pre>sudo su - git</pre>


2. Создайте директорию для SSH ключей:
Для каждого проекта создаётся своё хранилище; имя <code>project</code> замените названием проекта. Команду обязательно выполняйте с <code>sudo -u git</code>: хранилище должно принадлежать пользователю <code>git</code>, иначе в него не получится ничего отправить.
<pre>mkdir -p ~/.ssh</pre>
<pre>chmod 700 ~/.ssh</pre>


3. Создайте файл authorized_keys:
== 4. Работа с компьютера участника ==
<pre>touch ~/.ssh/authorized_keys</pre>
<pre>chmod 600 ~/.ssh/authorized_keys</pre>


== 4. Создание репозиториев ==
Эти команды выполняются не на сервере, а на компьютере участника. Вместо <code>203.0.113.10</code> подставьте адрес своего сервера.


=== Создание голого репозитория ===
'''Отправить существующий проект на сервер:'''


1. Создайте голый репозиторий:
<pre>cd project
<pre>cd /home/git/repositories</pre>
git remote add origin git@203.0.113.10:/srv/git/project.git
<pre>git init --bare my-project.git</pre>
git push -u origin main</pre>


2. Установите права доступа:
'''Получить проект с сервера:'''
<pre>sudo chown -R git:git my-project.git</pre>
<pre>sudo chmod -R 755 my-project.git</pre>


=== Создание репозитория с GitWeb ===
<pre>git clone git@203.0.113.10:/srv/git/project.git</pre>


1. Создайте репозиторий для GitWeb:
[[Файл:Linux-git-client.png|800px]]
<pre>cd /home/git/repositories</pre>
<pre>git init --bare --shared=group my-project-web.git</pre>


2. Настройте описание репозитория:
На снимках роль участника играет отдельный пользователь <code>ivan</code>. При первом подключении Git спросит, доверять ли серверу, — ответьте <code>yes</code>. Дальше обычная работа: <code>git pull</code> забирает чужие изменения, <code>git push</code> отправляет свои. Отправка и получение проверены и с другого компьютера — под Windows.
<pre>echo "My Project Repository" > my-project-web.git/description</pre>


3. Включите GitWeb:
Адрес хранилища состоит из трёх частей: пользователь <code>git</code>, адрес сервера и '''полный путь''' к хранилищу. Если сервер слушает SSH не на порту 22, адрес записывается так: <code>ssh://git@203.0.113.10:2222/srv/git/project.git</code>.
<pre>echo "gitweb" > my-project-web.git/gitweb</pre>


== 5. Настройка GitWeb ==
=== Войти в терминал под пользователем git нельзя ===


=== Установка и настройка GitWeb ===
[[Файл:Linux-git-shell.png|800px]]


1. Установите GitWeb:
Попытка обычного входа и попытка выполнить на сервере постороннюю команду отклоняются — так и должно быть.
<pre>sudo apt install gitweb</pre>


2. Отредактируйте конфигурацию GitWeb:
== 5. Автоматическая выкладка сайта ==
<pre>sudo nano /etc/gitweb.conf</pre>


3. Настройте основные параметры:
Git может выполнять на сервере команды после каждой отправки. Самое частое применение — сайт обновляется сам, как только разработчик выполнил <code>git push</code>.
<pre># Основные настройки
$projectroot = "/home/git/repositories";
$git_temp = "/tmp";
$projects_list = $projectroot;


# Настройки отображения
Создайте каталог, в который будут выкладываться файлы:
$site_name = "Git Server";
$site_html_head_string = "<link rel='stylesheet' type='text/css' href='/gitweb.css'/>";
$site_header = "/gitweb-header.html";
$site_footer = "/gitweb-footer.html";


# Настройки безопасности
<pre>sudo mkdir -p /var/www/project
$export_ok = "git-daemon-export-ok";
sudo chown git:git /var/www/project</pre>
$strict_export = 1;</pre>


=== Настройка веб-сервера для GitWeb ===
Создайте в хранилище файл, который Git запускает после приёма изменений:


1. Создайте конфигурацию для Apache:
<pre>sudo nano /srv/git/project.git/hooks/post-receive</pre>
<pre>sudo nano /etc/apache2/sites-available/gitweb.conf</pre>


2. Добавьте конфигурацию:
<pre>#!/bin/bash
<pre><VirtualHost *:80>
git --work-tree=/var/www/project --git-dir=/srv/git/project.git checkout -f main
    ServerName git.example.com
echo "Сайт обновлён: $(date '+%F %T')"</pre>
    DocumentRoot /usr/share/gitweb
   
    Alias /gitweb /usr/share/gitweb
    <Directory /usr/share/gitweb>
        Options +ExecCGI
        AddHandler cgi-script .cgi
        DirectoryIndex gitweb.cgi
        Require all granted
    </Directory>
   
    ScriptAlias /gitweb.cgi /usr/share/gitweb/gitweb.cgi
    <Directory /usr/share/gitweb>
        Options +ExecCGI
        AddHandler cgi-script .cgi
        Require all granted
    </Directory>
</VirtualHost></pre>


3. Включите сайт:
<pre>sudo chmod +x /srv/git/project.git/hooks/post-receive
<pre>sudo a2ensite gitweb</pre>
sudo chown git:git /srv/git/project.git/hooks/post-receive</pre>
<pre>sudo systemctl restart apache2</pre>


== 6. Настройка Git Daemon ==
[[Файл:Linux-git-hook.png|800px]]


=== Настройка Git Daemon ===
На снимке участник отправил новую страницу. Строки, начинающиеся с <code>remote:</code>, — ответ сервера. Последняя команда выполнена на сервере: файлы выложены в <code>/var/www/project</code>. Остаётся направить на этот каталог веб-сервер: [[Настройка Nginx веб-сервера]].


1. Отредактируйте конфигурацию Git Daemon:
* Первая строка файла <code>#!/bin/bash</code> обязательна — без неё файл не запустится.
<pre>sudo nano /etc/default/git-daemon</pre>
* Файл должен быть исполняемым (<code>chmod +x</code>).


2. Настройте параметры:
== 6. Участники ==
<pre>GIT_DAEMON_ENABLE=1</pre>
<pre>GIT_DAEMON_USER=git</pre>
<pre>GIT_DAEMON_BASE_PATH=/home/git/repositories</pre>
<pre>GIT_DAEMON_OPTIONS="--export-all --reuseaddr --verbose --base-path=/home/git/repositories"</pre>


3. Запустите Git Daemon:
{| class="wikitable"
<pre>sudo systemctl start git-daemon</pre>
! style="width:38%;" | Задача !! Что сделать
<pre>sudo systemctl enable git-daemon</pre>
|-
| Добавить участника || Дописать его открытый ключ новой строкой в <code>/home/git/.ssh/authorized_keys</code>
|-
| Убрать участника || Удалить строку с его ключом. По подписи в конце ключа: <code>sudo sed -i '/ivan@laptop/d' /home/git/.ssh/authorized_keys</code>
|-
| Посмотреть, чьи ключи добавлены || <code>sudo awk '{print $NF}' /home/git/.ssh/authorized_keys</code>
|-
| Создать ещё один проект || <code>sudo -u git git init --bare --initial-branch=main /srv/git/ИМЯ.git</code>
|}


=== Настройка репозиториев для Git Daemon ===
Удаление ключа проверено: после него участник получает отказ.


1. Создайте файл для экспорта репозитория:
'''Внимание:''' каждый, чей ключ есть в файле, может читать и изменять все проекты на этом сервере. Если разным людям нужен доступ к разным проектам, используйте [[Настройка системы контроля версий GitLab|GitLab]].
<pre>touch /home/git/repositories/my-project.git/git-daemon-export-ok</pre>


2. Установите права доступа:
Чтобы к серверу не подбирали пароли, закройте вход по паролю и поставьте защиту от подбора: [[Установка и настройка SSH сервера]], [[Настройка fail2ban для защиты от атак]].
<pre>sudo chown git:git /home/git/repositories/my-project.git/git-daemon-export-ok</pre>


== 7. Настройка SSH доступа ==
== 7. Резервная копия ==


=== Настройка SSH для Git ===
Все проекты лежат в одном каталоге — достаточно сохранить его:


1. Отредактируйте SSH конфигурацию:
<pre>sudo tar -czf /root/git-$(date +%F).tar.gz -C /srv git</pre>
<pre>sudo nano /etc/ssh/sshd_config</pre>


2. Добавьте настройки для Git:
[[Файл:Linux-git-backup.png|800px]]
<pre>Match User git</pre>
<pre>AllowUsers git</pre>
<pre>ForceCommand git-shell</pre>
<pre>X11Forwarding no</pre>
<pre>AllowTcpForwarding no</pre>


3. Перезапустите SSH:
Восстановление: <code>sudo tar -xzf /root/git-2026-11-16.tar.gz -C /srv</code>. Копия проверена: хранилище из архива открывается, история изменений на месте.
<pre>sudo systemctl restart ssh</pre>


=== Настройка Git Shell ===
Полная копия проекта есть и у каждого участника — в этом особенность Git. Но рассчитывать только на неё не стоит. Как делать копии по расписанию и хранить их вне сервера — в статье [[Настройка автоматических резервных копий]].


1. Создайте директорию для Git Shell:
Если проекты с большими файлами заняли весь диск, поможет [https://ark-hoster.ru/vpsgame/ тариф с диском большего объёма].
<pre>sudo mkdir -p /home/git/git-shell-commands</pre>
<pre>sudo chown git:git /home/git/git-shell-commands</pre>


2. Создайте скрипт для отображения репозиториев:
== Если что-то пошло не так ==
<pre>sudo nano /home/git/git-shell-commands/list-repos</pre>


3. Добавьте содержимое:
[[Файл:Linux-git-errors.png|800px]]
<pre>echo "Available repositories:"</pre>
<pre>ls -la /home/git/repositories/</pre>


4. Сделайте скрипт исполняемым:
{| class="wikitable"
<pre>sudo chmod +x /home/git/git-shell-commands/list-repos</pre>
! Что видите !! Причина и решение
<pre>sudo chown git:git /home/git/git-shell-commands/list-repos</pre>
|-
| «does not appear to be a git repository» || Неверный путь к хранилищу. Указывайте полный путь: <code>git@203.0.113.10:/srv/git/project.git</code>
|-
| «detected dubious ownership in repository» || Хранилище создано без <code>sudo -u git</code> и принадлежит root. Исправьте: <code>sudo chown -R git:git /srv/git/ИМЯ.git</code>
|-
| «Permission denied (publickey)» || Ключа участника нет в файле <code>authorized_keys</code>, ключ вставлен с переносом строки или у файла неверные права — шаг 2
|-
| Сервер спрашивает пароль пользователя <code>git</code> || Ключ не принят — причины те же. Пароля у пользователя <code>git</code> нет, вводить нечего
|-
| «src refspec main does not match any» || В проекте ещё нет ни одного сохранённого изменения, либо основная ветка называется иначе (<code>master</code>). Посмотрите: <code>git branch</code>
|-
| «fatal: Interactive git shell is not enabled» || Это не ошибка: вход в терминал под пользователем <code>git</code> закрыт намеренно
|-
| После <code>git push</code> сайт не обновился || Файл <code>post-receive</code> не исполняемый, в нём нет первой строки <code>#!/bin/bash</code> или каталог сайта не принадлежит пользователю <code>git</code> — шаг 5
|}


== 8. Настройка файрвола ==
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:'''


=== Настройка UFW ===
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов


1. Разрешите SSH трафик:
{{Телеграм}}
<pre>sudo ufw allow ssh</pre>
 
2. Разрешите HTTP трафик для GitWeb:
<pre>sudo ufw allow 80/tcp</pre>
 
3. Разрешите Git Daemon порт:
<pre>sudo ufw allow 9418/tcp</pre>
 
4. Проверьте статус:
<pre>sudo ufw status</pre>
 
=== Настройка iptables ===
 
1. Разрешите необходимые порты:
<pre>sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT</pre>
<pre>sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT</pre>
<pre>sudo iptables -A INPUT -p tcp --dport 9418 -j ACCEPT</pre>
 
2. Сохраните правила:
<pre>sudo iptables-save > /etc/iptables/rules.v4</pre>
 
== 9. Управление репозиториями ==
 
=== Создание репозитория ===
 
1. Создайте новый репозиторий:
<pre>cd /home/git/repositories</pre>
<pre>sudo -u git git init --bare new-project.git</pre>
 
2. Установите права доступа:
<pre>sudo chown -R git:git new-project.git</pre>
<pre>sudo chmod -R 755 new-project.git</pre>
 
3. Настройте описание:
<pre>echo "New Project Repository" | sudo tee new-project.git/description</pre>
 
=== Управление доступом ===
 
1. Добавьте SSH ключ пользователя:
<pre>sudo -u git bash -c "echo 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...' >> /home/git/.ssh/authorized_keys"</pre>
 
2. Удалите SSH ключ:
<pre>sudo -u git bash -c "sed -i '/ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC.../d' /home/git/.ssh/authorized_keys"</pre>
 
=== Управление репозиториями ===
 
1. Просмотрите список репозиториев:
<pre>ls -la /home/git/repositories/</pre>
 
2. Удалите репозиторий:
<pre>sudo rm -rf /home/git/repositories/old-project.git</pre>
 
3. Переименуйте репозиторий:
<pre>sudo mv /home/git/repositories/old-name.git /home/git/repositories/new-name.git</pre>
 
== 10. Мониторинг и логирование ==
 
=== Настройка логирования ===
 
1. Создайте скрипт логирования Git операций:
<pre>sudo nano /home/git/git-shell-commands/log-activity</pre>
 
2. Добавьте содержимое:
<pre>echo "$(date): $SSH_ORIGINAL_COMMAND" >> /home/git/git-activity.log</pre>
 
3. Сделайте скрипт исполняемым:
<pre>sudo chmod +x /home/git/git-shell-commands/log-activity</pre>
<pre>sudo chown git:git /home/git/git-shell-commands/log-activity</pre>
 
=== Просмотр логов ===
 
1. Просмотрите логи SSH:
<pre>sudo tail -f /var/log/auth.log | grep git</pre>
 
2. Просмотрите логи Git активности:
<pre>sudo tail -f /home/git/git-activity.log</pre>
 
3. Просмотрите логи Apache для GitWeb:
<pre>sudo tail -f /var/log/apache2/access.log | grep gitweb</pre>
 
=== Создание скрипта мониторинга ===
 
1. Создайте скрипт мониторинга:
<pre>sudo nano /usr/local/bin/git-monitor.sh</pre>
 
2. Добавьте содержимое:
<pre>if systemctl is-active --quiet ssh; then</pre>
<pre>echo "SSH is running"</pre>
<pre>else</pre>
<pre>echo "SSH is not running"</pre>
<pre>fi</pre>
<pre>if systemctl is-active --quiet git-daemon; then</pre>
<pre>echo "Git Daemon is running"</pre>
<pre>else</pre>
<pre>echo "Git Daemon is not running"</pre>
<pre>fi</pre>
<pre>if systemctl is-active --quiet apache2; then</pre>
<pre>echo "Apache is running"</pre>
<pre>else</pre>
<pre>echo "Apache is not running"</pre>
<pre>fi</pre>
<pre>REPO_COUNT=$(ls -1 /home/git/repositories/ | wc -l)</pre>
<pre>echo "Number of repositories: $REPO_COUNT"</pre>
<pre>DISK_USAGE=$(du -sh /home/git/repositories/ | cut -f1)</pre>
<pre>echo "Repository disk usage: $DISK_USAGE"</pre>
 
3. Сделайте скрипт исполняемым:
<pre>sudo chmod +x /usr/local/bin/git-monitor.sh</pre>
 
== 11. Устранение неполадок ==
 
=== Частые проблемы ===
 
1. '''Не могу клонировать репозиторий''':
* Проверьте SSH ключи: <pre>ssh -T git@server</pre>
* Проверьте права доступа: <pre>ls -la /home/git/repositories/</pre>
* Проверьте SSH конфигурацию
 
2. '''GitWeb не работает''':
* Проверьте Apache: <pre>sudo systemctl status apache2</pre>
* Проверьте конфигурацию GitWeb: <pre>sudo nano /etc/gitweb.conf</pre>
* Проверьте права доступа к репозиториям
 
3. '''Git Daemon не работает''':
* Проверьте статус: <pre>sudo systemctl status git-daemon</pre>
* Проверьте конфигурацию: <pre>sudo nano /etc/default/git-daemon</pre>
* Проверьте файрвол: <pre>sudo ufw status</pre>
 
=== Диагностика ===
 
1. Проверьте статус служб:
<pre>sudo systemctl status ssh</pre>
<pre>sudo systemctl status git-daemon</pre>
<pre>sudo systemctl status apache2</pre>
 
2. Проверьте подключения:
<pre>sudo netstat -tlnp | grep -E ':(22|80|9418)'</pre>
 
3. Проверьте SSH подключение:
<pre>ssh -T git@localhost</pre>
 
4. Проверьте права доступа:
<pre>ls -la /home/git/</pre>
<pre>ls -la /home/git/repositories/</pre>
 
== 12. Дополнительные настройки ==
 
=== Настройка хуков ===
 
1. Создайте хук для уведомлений:
<pre>sudo nano /home/git/repositories/my-project.git/hooks/post-receive</pre>
 
2. Добавьте содержимое:
<pre>echo "Repository updated: $(date)" | mail -s "Git Update" admin@example.com</pre>
 
3. Сделайте хук исполняемым:
<pre>sudo chmod +x /home/git/repositories/my-project.git/hooks/post-receive</pre>
<pre>sudo chown git:git /home/git/repositories/my-project.git/hooks/post-receive</pre>
 
=== Настройка резервного копирования ===
 
1. Создайте скрипт резервного копирования:
<pre>sudo nano /usr/local/bin/git-backup.sh</pre>
 
2. Добавьте содержимое:
<pre>BACKUP_DIR="/backup/git"</pre>
<pre>REPO_DIR="/home/git/repositories"</pre>
<pre>DATE=$(date +%Y%m%d_%H%M%S)</pre>
<pre>mkdir -p $BACKUP_DIR</pre>
<pre>tar -czf $BACKUP_DIR/git_repos_$DATE.tar.gz -C $REPO_DIR .</pre>
<pre>find $BACKUP_DIR -name "git_repos_*.tar.gz" -mtime +7 -delete</pre>
<pre>echo "Git backup completed: git_repos_$DATE.tar.gz"</pre>
 
3. Сделайте скрипт исполняемым:
<pre>sudo chmod +x /usr/local/bin/git-backup.sh</pre>
 
4. Добавьте в crontab:
<pre>0 2 * * * /usr/local/bin/git-backup.sh</pre>
 
== Заключение ==
 
Git сервер успешно установлен и настроен! Теперь вы можете предоставлять услуги управления версиями.
 
'''Для размещения ваших Git серверов на надежном хостинге рекомендуем воспользоваться услугами [https://ark-hoster.ru ARK-HOSTER.RU]:'''
 
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' - для высоконагруженных Git серверов
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' - для небольших и средних команд
 
Наши специалисты помогут с настройкой Git сервера и обеспечением безопасности ваших репозиториев!

Текущая версия от 14:32, 16 ноября 2026

Git — система, которая хранит историю изменений кода. Свой Git-сервер на VDS — это закрытое хранилище проектов, доступное только вам и вашей команде, без ограничений сторонних сервисов. В статье — простой и надёжный вариант: доступ по SSH и ключам, без веб-интерфейса. Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с Git 2.43, снимки экрана сняты с настоящего сервера.

Что выбрать. Способ из этой статьи подходит одному разработчику или небольшой команде, где все участники имеют доступ ко всем проектам. Если нужны веб-интерфейс, права на отдельные проекты, задачи и проверка кода — ставьте GitLab; ему нужен VDS от 8 ГБ памяти. Серверу из этой статьи хватит самого младшего тарифа.

1. Пользователь и каталог

Все участники подключаются к серверу под одним служебным пользователем git. Ему назначается особая оболочка git-shell: она разрешает только команды Git и не даёт войти в терминал сервера.

sudo apt update
sudo apt install -y git
sudo adduser --disabled-password --gecos "" --shell /usr/bin/git-shell git
sudo mkdir -p /srv/git
sudo chown git:git /srv/git

  • Ключ --disabled-password создаёт пользователя без пароля: войти под ним можно только по ключу.
  • Проекты будут храниться в каталоге /srv/git.

2. Ключи участников

Каждый участник создаёт у себя на компьютере ключ SSH и передаёт вам открытую часть — содержимое файла id_ed25519.pub. Как создать ключ, описано в статье Установка и настройка SSH сервера.

Создайте файл ключей и вставьте в него открытые ключи — по одному в строке:

sudo mkdir -p /home/git/.ssh
sudo nano /home/git/.ssh/authorized_keys

Перед каждым ключом допишите ограничения — тогда этот ключ нельзя использовать ни для чего, кроме Git:

no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty ssh-ed25519 AAAAC3... ivan@laptop

Задайте права и отключите приветствие сервера при входе:

sudo chmod 700 /home/git/.ssh
sudo chmod 600 /home/git/.ssh/authorized_keys
sudo chown -R git:git /home/git/.ssh
sudo -u git touch /home/git/.hushlogin

3. Хранилище проекта

sudo -u git git init --bare --initial-branch=main /srv/git/project.git

Для каждого проекта создаётся своё хранилище; имя project замените названием проекта. Команду обязательно выполняйте с sudo -u git: хранилище должно принадлежать пользователю git, иначе в него не получится ничего отправить.

4. Работа с компьютера участника

Эти команды выполняются не на сервере, а на компьютере участника. Вместо 203.0.113.10 подставьте адрес своего сервера.

Отправить существующий проект на сервер:

cd project
git remote add origin git@203.0.113.10:/srv/git/project.git
git push -u origin main

Получить проект с сервера:

git clone git@203.0.113.10:/srv/git/project.git

На снимках роль участника играет отдельный пользователь ivan. При первом подключении Git спросит, доверять ли серверу, — ответьте yes. Дальше обычная работа: git pull забирает чужие изменения, git push отправляет свои. Отправка и получение проверены и с другого компьютера — под Windows.

Адрес хранилища состоит из трёх частей: пользователь git, адрес сервера и полный путь к хранилищу. Если сервер слушает SSH не на порту 22, адрес записывается так: ssh://git@203.0.113.10:2222/srv/git/project.git.

Войти в терминал под пользователем git нельзя

Попытка обычного входа и попытка выполнить на сервере постороннюю команду отклоняются — так и должно быть.

5. Автоматическая выкладка сайта

Git может выполнять на сервере команды после каждой отправки. Самое частое применение — сайт обновляется сам, как только разработчик выполнил git push.

Создайте каталог, в который будут выкладываться файлы:

sudo mkdir -p /var/www/project
sudo chown git:git /var/www/project

Создайте в хранилище файл, который Git запускает после приёма изменений:

sudo nano /srv/git/project.git/hooks/post-receive
#!/bin/bash
git --work-tree=/var/www/project --git-dir=/srv/git/project.git checkout -f main
echo "Сайт обновлён: $(date '+%F %T')"
sudo chmod +x /srv/git/project.git/hooks/post-receive
sudo chown git:git /srv/git/project.git/hooks/post-receive

На снимке участник отправил новую страницу. Строки, начинающиеся с remote:, — ответ сервера. Последняя команда выполнена на сервере: файлы выложены в /var/www/project. Остаётся направить на этот каталог веб-сервер: Настройка Nginx веб-сервера.

  • Первая строка файла #!/bin/bash обязательна — без неё файл не запустится.
  • Файл должен быть исполняемым (chmod +x).

6. Участники

Задача Что сделать
Добавить участника Дописать его открытый ключ новой строкой в /home/git/.ssh/authorized_keys
Убрать участника Удалить строку с его ключом. По подписи в конце ключа: sudo sed -i '/ivan@laptop/d' /home/git/.ssh/authorized_keys
Посмотреть, чьи ключи добавлены sudo awk '{print $NF}' /home/git/.ssh/authorized_keys
Создать ещё один проект sudo -u git git init --bare --initial-branch=main /srv/git/ИМЯ.git

Удаление ключа проверено: после него участник получает отказ.

Внимание: каждый, чей ключ есть в файле, может читать и изменять все проекты на этом сервере. Если разным людям нужен доступ к разным проектам, используйте GitLab.

Чтобы к серверу не подбирали пароли, закройте вход по паролю и поставьте защиту от подбора: Установка и настройка SSH сервера, Настройка fail2ban для защиты от атак.

7. Резервная копия

Все проекты лежат в одном каталоге — достаточно сохранить его:

sudo tar -czf /root/git-$(date +%F).tar.gz -C /srv git

Восстановление: sudo tar -xzf /root/git-2026-11-16.tar.gz -C /srv. Копия проверена: хранилище из архива открывается, история изменений на месте.

Полная копия проекта есть и у каждого участника — в этом особенность Git. Но рассчитывать только на неё не стоит. Как делать копии по расписанию и хранить их вне сервера — в статье Настройка автоматических резервных копий.

Если проекты с большими файлами заняли весь диск, поможет тариф с диском большего объёма.

Если что-то пошло не так

Что видите Причина и решение
«does not appear to be a git repository» Неверный путь к хранилищу. Указывайте полный путь: git@203.0.113.10:/srv/git/project.git
«detected dubious ownership in repository» Хранилище создано без sudo -u git и принадлежит root. Исправьте: sudo chown -R git:git /srv/git/ИМЯ.git
«Permission denied (publickey)» Ключа участника нет в файле authorized_keys, ключ вставлен с переносом строки или у файла неверные права — шаг 2
Сервер спрашивает пароль пользователя git Ключ не принят — причины те же. Пароля у пользователя git нет, вводить нечего
«src refspec main does not match any» В проекте ещё нет ни одного сохранённого изменения, либо основная ветка называется иначе (master). Посмотрите: git branch
«fatal: Interactive git shell is not enabled» Это не ошибка: вход в терминал под пользователем git закрыт намеренно
После git push сайт не обновился Файл post-receive не исполняемый, в нём нет первой строки #!/bin/bash или каталог сайта не принадлежит пользователю git — шаг 5

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: