Установка и настройка Git сервера: различия между версиями
Оформление: строка навигации; в старых статьях — нумерация шагов, размер картинок, лишние пустые строки, повтор заголовка |
Статья переписана по результатам проверки на 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-сервер на VDS — это закрытое хранилище проектов, доступное только вам и вашей команде, без ограничений сторонних сервисов. В статье — простой и надёжный вариант: доступ по SSH и ключам, без веб-интерфейса. Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с Git 2.43, снимки экрана сняты с настоящего сервера. | |||
'''Что выбрать.''' Способ из этой статьи подходит одному разработчику или небольшой команде, где все участники имеют доступ ко всем проектам. Если нужны веб-интерфейс, права на отдельные проекты, задачи и проверка кода — ставьте [[Настройка системы контроля версий GitLab|GitLab]]; ему нужен VDS от 8 ГБ памяти. Серверу из этой статьи хватит самого младшего тарифа. | |||
== 1. Пользователь и каталог == | |||
Все участники подключаются к серверу под одним служебным пользователем <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> | |||
[[Файл:Linux-git-user.png|800px]] | |||
* Ключ <code>--disabled-password</code> создаёт пользователя без пароля: войти под ним можно только по ключу. | |||
< | * Проекты будут храниться в каталоге <code>/srv/git</code>. | ||
== 2. Ключи участников == | |||
Каждый участник создаёт у себя на компьютере ключ SSH и передаёт вам открытую часть — содержимое файла <code>id_ed25519.pub</code>. Как создать ключ, описано в статье [[Установка и настройка SSH сервера]]. | |||
Создайте файл ключей и вставьте в него открытые ключи — по одному в строке: | |||
<pre>sudo mkdir -p /home/git/.ssh | |||
<pre>git | sudo nano /home/git/.ssh/authorized_keys</pre> | ||
Перед каждым ключом допишите ограничения — тогда этот ключ нельзя использовать ни для чего, кроме Git: | |||
<pre>no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty ssh-ed25519 AAAAC3... ivan@laptop</pre> | |||
Задайте права и отключите приветствие сервера при входе: | |||
<pre>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</pre> | |||
3. | == 3. Хранилище проекта == | ||
= | <pre>sudo -u git git init --bare --initial-branch=main /srv/git/project.git</pre> | ||
[[Файл:Linux-git-repo.png|800px]] | |||
Для каждого проекта создаётся своё хранилище; имя <code>project</code> замените названием проекта. Команду обязательно выполняйте с <code>sudo -u git</code>: хранилище должно принадлежать пользователю <code>git</code>, иначе в него не получится ничего отправить. | |||
< | |||
< | |||
== 4. Работа с компьютера участника == | |||
Эти команды выполняются не на сервере, а на компьютере участника. Вместо <code>203.0.113.10</code> подставьте адрес своего сервера. | |||
'''Отправить существующий проект на сервер:''' | |||
<pre>cd project | |||
<pre>cd / | git remote add origin git@203.0.113.10:/srv/git/project.git | ||
git push -u origin main</pre> | |||
'''Получить проект с сервера:''' | |||
<pre>git clone git@203.0.113.10:/srv/git/project.git</pre> | |||
[[Файл:Linux-git-client.png|800px]] | |||
На снимках роль участника играет отдельный пользователь <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>. | |||
< | |||
== | === Войти в терминал под пользователем git нельзя === | ||
[[Файл:Linux-git-shell.png|800px]] | |||
Попытка обычного входа и попытка выполнить на сервере постороннюю команду отклоняются — так и должно быть. | |||
== 5. Автоматическая выкладка сайта == | |||
Git может выполнять на сервере команды после каждой отправки. Самое частое применение — сайт обновляется сам, как только разработчик выполнил <code>git push</code>. | |||
< | |||
Создайте каталог, в который будут выкладываться файлы: | |||
<pre>sudo mkdir -p /var/www/project | |||
sudo chown git:git /var/www/project</pre> | |||
Создайте в хранилище файл, который Git запускает после приёма изменений: | |||
<pre>sudo nano /srv/git/project.git/hooks/post-receive</pre> | |||
<pre>sudo nano / | |||
<pre>#!/bin/bash | |||
<pre> | git --work-tree=/var/www/project --git-dir=/srv/git/project.git checkout -f main | ||
echo "Сайт обновлён: $(date '+%F %T')"</pre> | |||
<pre>sudo chmod +x /srv/git/project.git/hooks/post-receive | |||
<pre>sudo | sudo chown git:git /srv/git/project.git/hooks/post-receive</pre> | ||
[[Файл:Linux-git-hook.png|800px]] | |||
На снимке участник отправил новую страницу. Строки, начинающиеся с <code>remote:</code>, — ответ сервера. Последняя команда выполнена на сервере: файлы выложены в <code>/var/www/project</code>. Остаётся направить на этот каталог веб-сервер: [[Настройка Nginx веб-сервера]]. | |||
* Первая строка файла <code>#!/bin/bash</code> обязательна — без неё файл не запустится. | |||
< | * Файл должен быть исполняемым (<code>chmod +x</code>). | ||
== 6. Участники == | |||
{| class="wikitable" | |||
< | ! style="width:38%;" | Задача !! Что сделать | ||
< | |- | ||
| Добавить участника || Дописать его открытый ключ новой строкой в <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> | |||
|} | |||
Удаление ключа проверено: после него участник получает отказ. | |||
'''Внимание:''' каждый, чей ключ есть в файле, может читать и изменять все проекты на этом сервере. Если разным людям нужен доступ к разным проектам, используйте [[Настройка системы контроля версий GitLab|GitLab]]. | |||
Чтобы к серверу не подбирали пароли, закройте вход по паролю и поставьте защиту от подбора: [[Установка и настройка SSH сервера]], [[Настройка fail2ban для защиты от атак]]. | |||
== 7. | == 7. Резервная копия == | ||
Все проекты лежат в одном каталоге — достаточно сохранить его: | |||
<pre>sudo tar -czf /root/git-$(date +%F).tar.gz -C /srv git</pre> | |||
<pre>sudo | |||
[[Файл:Linux-git-backup.png|800px]] | |||
Восстановление: <code>sudo tar -xzf /root/git-2026-11-16.tar.gz -C /srv</code>. Копия проверена: хранилище из архива открывается, история изменений на месте. | |||
< | |||
Полная копия проекта есть и у каждого участника — в этом особенность Git. Но рассчитывать только на неё не стоит. Как делать копии по расписанию и хранить их вне сервера — в статье [[Настройка автоматических резервных копий]]. | |||
Если проекты с большими файлами заняли весь диск, поможет [https://ark-hoster.ru/vpsgame/ тариф с диском большего объёма]. | |||
== Если что-то пошло не так == | |||
[[Файл:Linux-git-errors.png|800px]] | |||
{| class="wikitable" | |||
< | ! Что видите !! Причина и решение | ||
< | |- | ||
| «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 | |||
|} | |||
'''Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:''' | |||
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов | |||
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов | |||
{{Телеграм}} | |||
Текущая версия от 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов