Gitea на VDS: лёгкий аналог GitHub для команды с CI/CD

adduser \
  --system \
  --shell /bin/bash \
  --gecos 'Git Version Control' \
  --group \
  --disabled-password \
  --home /home/git \
  gitCopy

id gitCopy

apt install postgresql postgresql-contrib -yCopy

systemctl status postgresqlCopy

Active: active (running)Copy

Теперь создадим отдельную базу данных и пользователя:

sudo -u postgres psqlCopy

В консоли PostgreSQL выполните:

CREATE USER gitea WITH PASSWORD 'STRONG_PASSWORD';
CREATE DATABASE gitea OWNER gitea;Copy

После этого выйдите:

\qCopy

Пароль должен быть уникальным и достаточно сложным. Он используется только для подключения Gitea к PostgreSQL и не должен совпадать с паролями других сервисов.

Устанавливаем Gitea

Перед скачиванием проверьте актуальную версию Gitea на официальном сайте.

Создадим каталог для Gitea:

mkdir -p /var/lib/gitea/{custom,data,log}
mkdir -p /etc/giteaCopy

Назначим владельца:

chown -R git:git /var/lib/gitea
chown -R git:git /etc/giteaCopy

Теперь скачайте актуальный бинарный файл Gitea с официального источника и установите его:

https://docs.gitea.com/installation/install-from-binary/

wget -O /usr/local/bin/gitea https://dl.gitea.com/gitea/1.27.3/gitea-1.27.3-linux-amd64
chmod +x /usr/local/bin/gitea
gitea --versionCopy

Команда должна вернуть установленную версию Gitea.

Создаём systemd-сервис

Чтобы Gitea автоматически запускалась после перезагрузки VDS, создадим службу systemd:

nano /etc/systemd/system/gitea.serviceCopy

Добавьте:

[Unit]
Description=Gitea
After=network.target
After=postgresql.service

[Service]
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.targetCopy

Включим автозапуск сервиса, сам сервис и проверим статус:

systemctl daemon-reload
systemctl enable gitea
systemctl start gitea
systemctl status giteaCopy

Если всё настроено правильно, служба будет иметь статус:

Active: active (running)Copy

Если служба сразу завершается, посмотрите журнал:

journalctl -u gitea -n 50 --no-pagerCopy

Открываем веб-интерфейс

По умолчанию Gitea слушает порт 3000.

Проверить это можно:

ss -tlnp | grep 3000Copy

Временно открыть интерфейс можно по адресу:

http://194.48.141.32:3000Copy

Но для постоянного использования такой вариант не подходит. Лучше поставить перед Gitea Nginx и работать через обычный HTTPS-домен.

Например:

https://git.example.comCopy

Это также позволит нормально использовать Git по HTTPS и получить TLS-сертификат.

Настраиваем Nginx

Установим Nginx:

apt install nginx -yCopy

Создадим конфигурацию:

nano /etc/nginx/sites-available/giteaCopy

Добавьте:

server {
    listen 80;
    server_name git.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}Copy

Замените git.example.com на свой домен.

Активируем конфигурацию:

ln -s /etc/nginx/sites-available/gitea \
      /etc/nginx/sites-enabled/giteaCopy

Проверим Nginx:

nginx -tCopy

Если конфигурация корректна:

syntax is ok
test is successfulCopy

После этого перезагрузим Nginx:

systemctl reload nginxCopy

Настраиваем HTTPS

Для Git-сервера HTTPS нужен практически всегда. Через него передаются учётные данные, токены и исходный код.

Установим Certbot:

apt install certbot python3-certbot-nginx -yCopy

Получим сертификат:

certbot --nginx -d git.example.comCopy

Certbot настроит HTTPS и предложит перенаправлять HTTP-запросы на защищённое соединение.

После этого откройте:

https://git.example.comCopy

Должна появиться страница первоначальной настройки Gitea.

Проверить автоматическое обновление сертификата можно:

systemctl status certbot.timerCopy

А тестовое продление:

certbot renew --dry-runCopy

Если команда завершилась без ошибок, механизм обновления сертификата работает.

Завершаем установку через веб-интерфейс

На странице установки Gitea укажите параметры базы данных PostgreSQL:

Тип базы данных: PostgreSQL
Хост: 127.0.0.1:5432
Имя пользователя: gitea
Пароль: STRONG_PASSWORD
Имя базы: giteaCopy

Также проверьте URL сайта:

https://git.example.com/Copy

Gitea использует базовый URL при формировании ссылок на репозитории, issues и другие объекты.

Путь к репозиториям оставьте в каталоге пользователя git. Если вы использовали структуру из предыдущих шагов, не меняйте её без необходимости.

После сохранения настроек Gitea создаст таблицы в PostgreSQL и завершит установку.

Создаём администратора

После установки создайте первую учётную запись администратора.

Используйте отдельный пароль, который нигде больше не применяется.

После входа откройте настройки администратора и проверьте состояние системы. Там можно увидеть предупреждения о конфигурации, обновлениях и безопасности.

Создаём первый Git-репозиторий

Создадим новый репозиторий через веб-интерфейс Gitea.

Нажмите на плюс справа вверху

Например:

my-projectCopy

После создания Gitea покажет URL для подключения.

Через HTTPS он будет выглядеть примерно так:

git clone http://194.48.141.32:3000/admin/my-project.gitCopy

Введите логин и пароль пользователя

Перейдите в каталог проекта:

cd my-projectCopy

Добавьте файл:

echo "# My project" > README.mdCopy

Создайте первый коммит:

git config --global user.name "admin"
git config --global user.email "admin@example.com"Copy

git add README.md
git commit -m "Initial commit"Copy

Отправьте изменения:

git push origin mainCopy

После этого обновите страницу репозитория. Файл README.md должен появиться в веб-интерфейсе.

Итог

Gitea позволяет превратить обычный VDS в собственный сервер для разработки.

Он подходит чтобы хранить исходный код, работать с pull request, управлять доступом и запускать автоматические тесты и т.д.