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