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

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Статья переписана по результатам проверки на Ubuntu 24.04: исправлены ошибки, добавлены снимки экрана
Статья переписана по результатам проверки на Ubuntu 24.04: исправлены ошибки, добавлены снимки экрана
 
Строка 63: Строка 63:
[[Файл:Linux-git-client.png|800px]]
[[Файл:Linux-git-client.png|800px]]


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


Адрес хранилища состоит из трёх частей: пользователь <code>git</code>, адрес сервера и '''полный путь''' к хранилищу. Если сервер слушает SSH не на порту 22, адрес записывается так: <code>ssh://git@203.0.113.10:2222/srv/git/project.git</code>.
Адрес хранилища состоит из трёх частей: пользователь <code>git</code>, адрес сервера и '''полный путь''' к хранилищу. Если сервер слушает SSH не на порту 22, адрес записывается так: <code>ssh://git@203.0.113.10:2222/srv/git/project.git</code>.
Строка 95: Строка 95:
[[Файл:Linux-git-hook.png|800px]]
[[Файл:Linux-git-hook.png|800px]]


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


* Первая строка файла <code>#!/bin/bash</code> обязательна — без неё файл не запустится.
* Первая строка файла <code>#!/bin/bash</code> обязательна — без неё файл не запустится.

Текущая версия от 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: