Home Media Server — Open Source

Ваш сервер. Ваши правила. Ваши данные.

Модульная медиаплатформа для Synology NAS. Управляй контентом, ботами и плагинами без облаков, без подписок и без компромиссов с приватностью.

Изучить архитектуру →

Scroll

01 — Философия

Почему home server?

Потому что твои данные — это ты. Не продукт для монетизации, не строчка в чужой базе данных, не заложник подписки.

Суверенитет данных

Каждый файл, каждая настройка, каждая история просмотров живёт на твоём железе. Никаких сторонних серверов, никаких «умных» облаков, которые анализируют что ты смотришь. Данные уходят только туда, куда ты явно это разрешил.

Модульность без компромиссов

Home.Media v3 построена вокруг одной идеи: ядро должно быть стабильным, а плагины — независимыми. Новый плагин не требует пересборки контейнера. Сломанный плагин не роняет сервер. Каждый компонент изолирован и заменяем.

NAS как первый класс

Большинство self-hosted решений рассчитаны на выделенный сервер. Home.Media проектировалась для Synology с 2 ядрами Celeron и 2GB RAM. Никаких docker build при установке плагинов — только venv + subprocess. Быстро, легко, надёжно.

Telegram как нативный UI

Веб-интерфейс хорош за компьютером. Но медиа потребляются с дивана, с телефона, в дороге. Telegram-бот — это не костыль, это первоклассный интерфейс для поиска фильмов, управления загрузками и мониторинга сервера прямо из чата.

02 — Архитектура

Ядро стабильно. Плагины независимы.

Браузер / Telegram

Клиент

React SPA или Telegram Bot — два равноправных способа управления

→

FastAPI + React
Ядро
Аутентификация, хранение состояния, роутинг до плагинов. Собирается один раз.

→

venv + subprocess

Плагины

Каждый плагин — отдельный FastAPI процесс со своим venv и web UI

# Структура .hm плагина — всё что нужно для установки
plugin.hm
├── manifest.json    # id, name, version, port
├── requirements.txt # зависимости Python
└── app/
    ├── main.py      # FastAPI: API endpoints
    └── web/
        └── index.html  # полный UI плагина (ванильный JS)

# Установка: pip install → venv → subprocess.Popen → готово
# Пересборка ядра: НЕ НУЖНА
  

Доступные плагины

🤖

Bot UI Engine

Telegram gateway, allowlist, команды

🔍

Media Search

TMDB + Кинопоиск, отправка в Telegram

🎬

Torrent

Управление загрузками

📡

Prowlarr

Индексаторы и поиск раздач

📋

Watchlist

Список «хочу посмотреть»

＋

Ваш плагин

Любой FastAPI сервис

03 — Принципы

⚡

Ресурсы — это роскошь

NAS — не сервер. Каждая операция должна быть оправдана. venv вместо Docker. SQLite там где можно. Polling вместо WebSocket.

🔒

Изоляция по умолчанию

Плагин не может сломать ядро. Плагин не может прочитать данные другого плагина без явного API. Процессы изолированы через subprocess.

🧩

Плагин — это сервис

Каждый плагин это полноценный FastAPI с собственным UI, API и данными. Никаких import из ядра. Никаких общих зависимостей.

🚀

Установка за секунды

pip install + запуск процесса. Без сборки образов, без реестров, без ожидания 60 секунд пока Celeron компилирует Python пакеты.

🌐

UI в плагине

Плагин отдаёт свой HTML через /ui/. Ядро монтирует iframe. Смена UI плагина — переустановить .hm файл. Ядро не трогаем.

📡

API-first

Каждая функция доступна через REST. Telegram-бот — это просто ещё один клиент, который вызывает те же endpoints что и веб UI.

04 — Технологии

Проверенный стек. Минимум магии.

Ядро — бэкенд

Python 3.11 FastAPI SQLAlchemy Alembic PostgreSQL 16 psycopg3 Uvicorn httpx

Ядро — фронтенд

React 18 Vite 5 React Router 6 Lucide React Vanilla CSS

Плагины

FastAPI venv subprocess aiogram 3 aiohttp Vanilla JS

Инфраструктура

Docker Compose Synology DSM 7 Container Manager TMDB API Кинопоиск API Telegram Bot API

Не арендуй.

Владей.

Управляй.

mddev

Разработчик · Автор проекта

Synology NAS Self-hosted Python · FastAPI · React

О проекте

Home.Media начиналась как личный инструмент для управления домашним сервером на Synology. Три версии спустя — это полноценная модульная платформа с плагинами, Telegram-ботом и философией «твои данные остаются дома».

© 2024–2026 mddev · Home.Media v3.0.0

Built with ♥ for Synology NAS