Установка 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». После завершения установки вы будете перенаправлены на страницу входа.
Настройка 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 и поддерживать систему в рабочем состоянии.
