Установка Forgejo — своего сервера Git на Ubuntu 24.04

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Forgejo — собственный сервер Git с веб-интерфейсом: репозитории, задачи, запросы на слияние, вики, организации и права доступа — всё как в привычных облачных службах, но на вашем VDS и под вашим управлением. Это свободная программа с открытым исходным кодом, которую развивает сообщество. Главное её достоинство — лёгкость: при проверке сервер занимал около 100 МБ памяти, тогда как GitLab нужно от 4 ГБ. В статье — установка на VDS с Ubuntu 24.04, первая настройка, первый репозиторий, доступ по HTTP и SSH, резервная копия. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4 с Forgejo 17.0.1; снимки экрана сняты с настоящего сервера.

Forgejo, GitLab или «голый» Git

Сервер Git по SSH Forgejo GitLab
Веб-интерфейс, задачи, запросы на слияние Нет Есть Есть
Память Десятки МБ Около 100 МБ От 4 ГБ
Встроенная сборка и проверка кода (CI) Нет Есть (Forgejo Actions, ставится отдельно) Есть, развитая
Кому подойдёт Один-два человека, только хранение кода Команда до нескольких десятков человек, свои проекты и модификации Большая команда, сложные конвейеры сборки
Инструкция Установка и настройка Git сервера Эта статья Настройка системы контроля версий GitLab

Для сервера игрового проекта — кода модификаций, скриптов, настроек — Forgejo обычно лучший выбор: ему хватает младшего тарифа VDS, и он уживается на одном сервере с другими программами.

Что понадобится

  • VDS с Ubuntu 24.04 LTS и установленным Docker — Установка и настройка Docker.
  • Память: от 1 ГБ свободной. Диск: сам Forgejo занимает около 200 МБ, остальное — ваши репозитории.

1. Установка

Заведите служебного пользователя, которому будут принадлежать данные, и запомните его номера:

sudo useradd -r -s /usr/sbin/nologin forgejo
id forgejo

Команда id покажет uid и gid — подставьте их в файл Compose вместо 996 и 988:

sudo mkdir -p /opt/forgejo && cd /opt/forgejo
sudo nano compose.yaml
services:
  forgejo:
    image: codeberg.org/forgejo/forgejo:17
    container_name: forgejo
    restart: unless-stopped
    environment:
      - USER_UID=996
      - USER_GID=988
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - ./data:/data
      - /etc/localtime:/etc/localtime:ro
sudo docker compose up -d
sudo docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "NAMES|forgejo" | cut -c1-108
curl -s http://127.0.0.1:3000/api/v1/version; echo

Строка Что означает
image: …/forgejo:17 Семнадцатая версия. Число в конце — номер ветки: внутри неё обновления ставятся командой pull, на следующую ветку переходят, поменяв число
"3000:3000" Веб-интерфейс
"2222:22" Доступ к репозиториям по SSH. Порт 22 занят SSH самого VDS, поэтому снаружи — 2222
./data:/data Репозитории, база данных и настройки — в каталоге /opt/forgejo/data

Откройте порты:

sudo ufw allow OpenSSH
sudo ufw allow 3000/tcp
sudo ufw allow 2222/tcp
sudo ufw enable

2. Первая настройка

Откройте в браузере http://203.0.113.10:3000, подставив адрес своего VDS. Forgejo покажет страницу начальной настройки — на русском языке, если русский выбран в браузере:

Большинство полей менять не нужно. Проверьте четыре:

Поле Что указать
Тип базы данных SQLite3 — для команды до нескольких десятков человек отдельная база не нужна
Домен сервера IP-адрес VDS или доменное имя, по которому сервер будут открывать
Порт SSH-сервера 2222 — тот, что указан в файле Compose слева от двоеточия
Базовый URL http://203.0.113.10:3000/ — полный адрес сервера. По нему Forgejo строит ссылки для клонирования

Внизу страницы раскройте раздел настроек учётной записи администратора и задайте имя, пароль и почту. Имя admin занято самой программой — выберите другое. Если раздел пропустить, администратором станет первый, кто зарегистрируется на сервере, — поэтому не пропускайте.

Нажмите «Установить Forgejo». Через несколько секунд откроется главная страница:

3. Первый репозиторий

Нажмите «+» в правом верхнем углу → «Новый репозиторий»:

Достаточно названия. Отметка «Частный» скрывает репозиторий от всех, кому вы не дали доступ. Затем отправьте в него код со своего компьютера или с сервера:

mkdir -p ~/demo-project && cd ~/demo-project
git init -q -b main && echo "# Demo project" > README.md && git add README.md
git -c user.name="Admin" -c user.email="admin@example.com" commit -q -m "First commit"
git remote add origin http://203.0.113.10:3000/gitadmin/demo-project.git
git push -u origin main
git log --oneline | head -n 3; git branch -vv | cut -c1-80

Git спросит имя и пароль учётной записи Forgejo. Адрес репозитория складывается из адреса сервера, имени пользователя и названия репозитория. Отправленный код сразу виден в веб-интерфейсе:

4. Доступ по SSH-ключу

Вводить пароль при каждой отправке неудобно. Удобнее ключ: откройте «Настройки» (значок профиля справа вверху) → «Ключи SSH / GPG» → «Добавить ключ» и вставьте содержимое своего открытого ключа — файла ~/.ssh/id_ed25519.pub. Если ключа ещё нет, создайте его на своём компьютере: ssh-keygen -t ed25519.

После этого репозиторий клонируется и обновляется без пароля. В адресе — порт 2222:

git clone ssh://git@203.0.113.10:2222/gitadmin/demo-project.git

5. Что настроить сразу

Настройки, которых нет в веб-интерфейсе, лежат в файле /opt/forgejo/data/gitea/conf/app.ini. Самое важное для сервера, открытого в интернет, — запретить посторонним регистрироваться. Найдите раздел [service] и поставьте:

DISABLE_REGISTRATION = true

Затем перезапустите: cd /opt/forgejo && sudo docker compose restart. Новых пользователей после этого заводит администратор: «Управление сервером» → «Учётные записи».

Если сервер должен открываться по доменному имени с шифрованием, поставьте перед ним обратный прокси — Установка Nginx Proxy Manager на Ubuntu 24.04 — и поменяйте в app.ini строку ROOT_URL на новый адрес с https://.

6. Резервная копия и обновление

Всё, что нужно сохранить, лежит в каталоге data:

cd /opt/forgejo
sudo docker compose stop
sudo tar -czf /root/forgejo-backup-$(date +%F).tar.gz -C /opt/forgejo data compose.yaml
sudo docker compose start
ls -lh /root/forgejo-backup-*.tar.gz
sudo docker compose pull
sudo docker compose up -d

Последние две команды — обновление внутри текущей ветки. Чтобы перейти на следующую (с 17 на 18), сделайте копию, поменяйте число в строке image: и выполните те же две команды. Ветки не пропускайте: с 17 сначала на 18, потом на 19.

Копию храните не только на этом VDS — репозитории и есть то, ради чего сервер существует: Настройка автоматических резервных копий.

Что не проверено

Проверены: установка, первая настройка с созданием администратора, создание репозитория, отправка кода по HTTP с паролем, доступ по SSH-ключу (чтение репозитория через порт 2222), резервная копия и команды обновления. Репозиторий и ключ при проверке создавались через программный интерфейс Forgejo — теми же действиями, что и кнопки на снимках. Не проверены: запрет регистрации через app.ini, работа за обратным прокси, переход на следующую ветку и восстановление из копии.

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

Что видите Причина и решение
Страница не открывается tail
В журнале «permission denied» при запуске USER_UID и USER_GID в файле Compose не совпадают с владельцем каталога data
Ссылки для клонирования ведут на localhost При первой настройке не изменён «Базовый URL». Поправьте ROOT_URL в app.ini и перезапустите контейнер
git push: «Authentication failed» Неверное имя или пароль; для учётных записей с двухэтапным входом вместо пароля нужен токен доступа из настроек профиля
SSH: «Connection refused» или запрос пароля В адресе не указан порт 2222, порт закрыт файрволом, либо ключ не добавлен в профиль
Имя admin не принимается Оно зарезервировано. Выберите другое имя администратора

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