Raspberry Pi 5 Homelab Setup

Полная настройка домашнего сервера на Raspberry Pi 5 с медиа-сервисами, мониторингом и обратным прокси.

🚀 Возможности

• Медиа-стек: Sonarr, qBittorrent, Jackett, Jellyfin
• Мониторинг: Portainer, Homer Dashboard
• LCD дисплей: Мониторинг системы с температурой и использованием ресурсов
• Обратный прокси: Nginx с SSL терминацией
• Система бэкапов: Автоматическое резервное копирование конфигов на GitHub
• Безопасность: Усиленная конфигурация Nginx

📦 Включенные сервисы

Сервис	Порт	Описание
Homer	8080	Дашборд
Portainer	9443	Управление контейнерами
Sonarr	8989	Автоматизация загрузки сериалов
qBittorrent	8068	Торрент-клиент
Jackett	9117	Прокси для торрент-трекеров
Jellyfin	8096	Медиа-сервер

🛠️ Установка

1. Базовая настройка системы

chmod +x rpi.sh
sudo ./rpi.sh

Скрипт проведет вас через:

• Создание пользователя
• Установку пакетов
• Настройку LCD сервиса
• Установку Docker и развертывание контейнеров
• Конфигурацию Nginx

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

Отредактируйте homer-proxy.conf:

server_name ваш-домен.com;
ssl_certificate /путь/к/сертификату.crt;
ssl_certificate_key /путь/к/ключу.key;
proxy_pass http://ВАШ_IP_СЕРВЕРА:ПОРТ/;

3. Настройка бэкапов

Настройте автоматическое резервное копирование:

cd /srv/containers/backup
./push.sh  # Для бэкапов
./pull.sh  # Для восстановления

🔧 Конфигурация

Переменные окружения

Создайте файл .env для Docker Compose:

PUID=1000
PGID=1000
TZ=Europe/Kaliningrad

LCD монитор

• Отображает использование CPU, температуру и память
• Автоматическое управление подсветкой (10:00-22:00)
• Мониторинг через systemd сервисы

Функции безопасности

• SSL/TLS шифрование
• Заголовки безопасности (X-Frame-Options, XSS Protection)
• Конфигурация CORS
• Health checks для Docker контейнеров

📁 Структура проекта

/srv/
├── containers/
│   ├── configs/          # Конфигурации сервисов
│   ├── compose/          # Docker Compose файлы
│   └── backup/           # Скрипты бэкапов и репозиторий
└── mediahub/
    ├── downloads/        # Загрузки торрентов
    └── media/           # Организованные медиафайлы

🔄 Обновление сервисов

Обновление Portainer:

chmod +x update_portainer.sh
./update_portainer.sh

Обновление всех контейнеров:

cd /srv/containers/compose
docker-compose pull
docker-compose up -d

🌟 Советы по использованию

1. Доступ к сервисам через https://ваш-домен.com/сервис
2. Мониторинг системы через LCD или Homer дашборд
3. Регулярно делайте бэкапы используя push.sh скрипт
4. Обновляйте контейнеры ежемесячно для установки патчей безопасности

⚠️ Важные примечания

• Замените ВСЕ placeholder значения перед использованием
• Используйте настоящие SSL сертификаты в production
• Настройте фаервол для разрешения только необходимых портов
• Требуется регулярное обслуживание и обновления

📄 Лицензия

MIT License - свободно используйте и модифицируйте под свои нужды.

🤝 Участие в разработке

Вклады приветствуются! Пожалуйста, убедитесь что:

• Нет чувствительных данных в коммитах
• Используются placeholders для персональной информации
• Тестируйте изменения на непродакшен системах