Установка и настройка Git сервера
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
При первом подключении 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов