Пост

Установка Gitea на Raspberry Pi 3B+ с загрузкой с SSD

Gitea — это легковесный и полностью автономный сервер для Git, который хорошо подходит для развертывания на одноплатных компьютерах, таких как Raspberry Pi 3B+. Использование SSD вместо microSD-карты повышает производительность, надёжность и долговечность системы. В этой статье рассмотрен процесс установки и настройки Gitea на Raspberry Pi 3B+ с загрузкой операционной системы с внешнего SSD-накопителя: от подготовки оборудования до веб-конфигурации, оптимизации и решения типичных проблем.

Установка Gitea на Raspberry Pi 3B+ с загрузкой с SSD Gitea — это легковесный и полностью автономный сервер для Git, который хорошо подходит для развертывания на одноплатных компьютерах, таких как Raspberry Pi 3B+. Использование SSD вместо microSD-карты повышает производительность, надёжность и долговечность системы. В этой статье рассмотрен процесс установки и настройки Gitea на Raspberry Pi 3B+ с загрузкой операционной системы с внешнего SSD-накопителя: от подготовки оборудования до веб-конфигурации, оптимизации и решения типичных проблем.

Рекомендации

Для стабильной работы используйте SSD-накопитель в USB-корпусе. Если SSD потребляет много энергии, подключите его через USB-хаб с внешним питанием: порты Raspberry Pi 3B+ не всегда обеспечивают достаточный ток. Желательно применять 64-битную версию Raspberry Pi OS Lite без графического интерфейса — она экономит ресурсы. Для первоначальной настройки удобно использовать Ethernet-подключение и качественный блок питания.

Подготовка оборудования и программного обеспечения

Понадобятся Raspberry Pi 3B+, SSD-накопитель рекомендуемого объёма от 16 ГБ, USB-корпус для SSD, компьютер с картридером для записи образа и стабильное сетевое подключение. Из программного обеспечения нужны утилита Raspberry Pi Imager с официального сайта и образ Raspberry Pi OS Lite 64-bit. Raspberry Pi 3B+ поддерживает загрузку с USB-накопителей по умолчанию, поэтому отдельное изменение прошивки обычно не требуется.

Запись образа ОС на SSD и настройка загрузки

Подключите SSD к компьютеру и запустите Raspberry Pi Imager. Выберите образ Raspberry Pi OS Lite 64-bit и целевой накопитель — SSD. В настройках Imager можно сразу задать имя пользователя, пароль, параметры Wi-Fi и включить SSH. После записи отключите SSD от компьютера, вставьте его в USB-порт Raspberry Pi, убедитесь, что microSD-карта извлечена, и подайте питание. Найдите IP-адрес платы в локальной сети и подключитесь по SSH командой ssh pi@<IP-адрес_вашего_Pi>.

Первоначальная настройка системы

После подключения по SSH обновите систему и установите необходимые пакеты. SQLite выбрана как простая и лёгкая база данных, подходящая для Raspberry Pi:

1
2
sudo apt update && sudo apt upgrade -y
sudo apt install -y git sqlite3 wget

Установка Gitea из бинарного файла

Создайте системного пользователя git, от имени которого будет работать Gitea:

1
sudo adduser --system --group --disabled-password --home /home/git git

Переключитесь на пользователя git, скачайте актуальную версию бинарного файла для архитектуры linux-arm64 и сделайте его исполняемым. Номер версии замените на текущий со страницы загрузок Gitea:

1
2
3
4
5
6
sudo -u git bash
cd /home/git
wget https://dl.gitea.com/gitea/1.22.0/gitea-1.22.0-linux-arm64
chmod +x gitea-1.22.0-linux-arm64
mv gitea-1.22.0-linux-arm64 gitea
exit

Создайте структуру каталогов для данных, конфигурации и логов:

1
2
3
4
5
6
sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R git:git /var/lib/gitea/
sudo chmod -R 750 /var/lib/gitea/
sudo mkdir /etc/gitea
sudo chown root:git /etc/gitea
sudo chmod 770 /etc/gitea

Настройка службы systemd

Создайте файл службы /etc/systemd/system/gitea.service:

1
sudo nano /etc/systemd/system/gitea.service

Вставьте следующее содержимое:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target

[Service]
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/home/git/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.target

Активируйте и запустите службу:

1
2
3
sudo systemctl daemon-reload
sudo systemctl enable gitea
sudo systemctl start gitea

Первоначальная веб-конфигурация Gitea

Откройте браузер на компьютере и перейдите по адресу http://<IP-адрес_вашего_Pi>:3000. На странице первоначальной настройки оставьте базу данных SQLite3, задайте название сайта, проверьте базовый URL вида http://<IP-адрес_вашего_Pi>:3000/, создайте учётную запись администратора и нажмите «Установить Gitea». После завершения установки вы будете перенаправлены на страницу входа.

Страница входа в Gitea

Настройка Nginx как обратного прокси

Для доступа к Gitea по стандартному порту 80 и повышения удобства установите Nginx:

1
sudo apt install -y nginx

Создайте конфигурационный файл /etc/nginx/sites-available/gitea:

1
sudo nano /etc/nginx/sites-available/gitea

Вставьте конфигурацию, заменив ваш_домен_или_IP на ваш IP-адрес или доменное имя:

1
2
3
4
5
6
7
8
9
10
11
12
server {
    listen 80;
    server_name ваш_домен_или_IP;

    location / {
        proxy_pass http://localhost: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;
    }
}

Активируйте сайт и перезапустите Nginx:

1
2
3
sudo ln -s /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Теперь Gitea доступна по адресу http://<ваш_IP_или_домен>/.

Оптимизация и обслуживание SSD

Не добавляйте необоснованные опции монтирования в /etc/fstab: современные SSD и Raspberry Pi OS штатно справляются с обслуживанием накопителя. Для снижения объёма записи логов можно опционально установить log2ram:

1
sudo apt install log2ram

Для контроля состояния SSD установите smartmontools и проверьте накопитель:

1
2
sudo apt install -y smartmontools
sudo smartctl -a /dev/sda

Проверить статус службы Gitea и просмотреть логи можно командами:

1
2
sudo systemctl status gitea
sudo journalctl -u gitea -f

Типичные проблемы и решения

Проблема: Raspberry Pi не загружается с SSD. Решение: Убедитесь, что SSD подключён напрямую к USB-порту или через хаб с внешним питанием, microSD-карта извлечена, а образ записан корректно. Для Raspberry Pi 3B+ загрузка с USB включена по умолчанию; если используется очень старый образ, обновите прошивку и повторите попытку.

Проблема: Служба Gitea не запускается. Решение: Просмотрите логи командой sudo journalctl -u gitea -f. Частая причина — неправильные права на каталоги /var/lib/gitea или /etc/gitea. Убедитесь, что владелец git:git, права соответствуют инструкции, а файл /home/git/gitea исполняемый.

Проблема: Ошибка 502 Bad Gateway при доступе через Nginx. Решение: Проверьте, что Gitea запущена и слушает порт 3000 командой sudo systemctl status gitea. Проверьте конфигурацию Nginx командой sudo nginx -t и убедитесь, что в proxy_pass указан адрес http://localhost:3000.

Проблема: Недостаточно памяти при работе Gitea. Решение: Gitea обычно потребляет около 50–150 МБ ОЗУ. Используйте Lite-версию ОС без графического интерфейса, закройте неиспользуемые службы и при необходимости увеличьте swap-файл.

Проблема: Медленная работа SSD или ошибки ввода-вывода. Решение: Проверьте питание SSD, замените USB-кабель и при необходимости используйте USB-хаб с внешним питанием. Состояние накопителя можно проверить командой sudo smartctl -a /dev/sda после установки smartmontools.

Gitea на Raspberry Pi 3B+ с SSD — это надёжное и энергоэффективное решение для личного Git-сервера. Оно даёт полный контроль над репозиториями, не требует ежемесячных платежей и хорошо подходит для небольших проектов. Следуя инструкции, вы сможете развернуть сервер, настроить доступ через Nginx и поддерживать систему в рабочем состоянии.

Авторский пост защищен лицензией CC BY 4.0 .

© evdokimoff. Некоторые права защищены.

Использует тему Chirpy для Jekyll