Runtipi — это открытая панель управления для самостоятельного хостинга (self-hosting), построенная поверх Docker. Она позволяет устанавливать и управлять сервисами (Nextcloud, Jellyfin, n8n и другими) в один клик, как в магазине приложений.
Runtipi официально работает только на Linux. Пользователям Windows и macOS придётся сначала создать Linux-виртуальную машину — нативно установить Runtipi на эти системы нельзя. Ниже — что это за приложение, как развернуть его на каждой платформе, какие контейнеры стоит поставить и на что обратить внимание с точки зрения безопасности.
1. Что такое Runtipi и зачем он нужен
1.1 Определение
Runtipi — это открытый инструмент для управления домашним сервером, по сути веб-интерфейс поверх Docker. Официальная позиция разработчиков: сделать self-hosting таким же простым, как установка приложения на телефон. Вам не нужно вручную писать docker-compose.yml, настраивать обратный прокси и разбираться с портами — достаточно нажать «Install» в браузере, и Runtipi сделает всё остальное.
1.2 Какую проблему он решает
Классический self-hosting упирается в три барьера: сложность командной строки Docker, настройка обратного прокси и SSL-сертификатов, конфликты портов и сетей между сервисами. Runtipi решает их за счёт встроенного обратного прокси Traefik, который автоматически маршрутизирует запросы и выдаёт HTTPS-сертификаты, и визуального App Store для установки, обновления и удаления приложений.
1.3 Из чего состоит Runtipi
Согласно официальной документации, система включает несколько ключевых компонентов :
|
Компонент
|
Назначение
|
|---|---|
|
Runtipi Dashboard
|
Веб-интерфейс на React для просмотра и управления приложениями
|
|
Runtipi CLI
|
Командная строка для запуска/остановки системы, обновления, бэкапа и отладки
|
|
App Store
|
Отдельный Git-репозиторий с описаниями приложений (config.json и docker-compose.yml)
|
|
Traefik
|
Обратный прокси: маршрутизация и автоматические SSL-сертификаты
|
|
PostgreSQL
|
Хранит учётные записи, статусы установки и конфигурацию системы
|
|
Компонент
|
Назначение
|
|
Runtipi Dashboard
|
Веб-интерфейс на React для просмотра и управления приложениями
|
1.4 Отсутствие привязки к платформе
Важное преимущество: Runtipi не блокирует пользователя. Все приложения — это стандартные Docker-контейнеры, а сгенерированные файлы docker-compose лежат в каталоге apps/. Если вы решите отказаться от Runtipi, можно просто экспортировать эти файлы и запустить сервисы обычной командой docker compose up — данные не пропадут.
2. Системные требования и совместимость платформ
2.1 Аппаратные требования
По данным официального FAQ, минимальная конфигурация :
- Процессор: 64-битный (x86_64 / amd64 или ARM64)
- Оперативная память: минимум 4 ГБ, рекомендуется 8 ГБ
- Диск: не менее 10 ГБ свободного места
- Архитектура: x86_64 поддерживает подавляющее большинство приложений; ARM64 (Raspberry Pi 4/5) поддерживает большинство, но часть приложений скрывается автоматически
2.2 Правда о поддержке операционных систем
Это самое важное место, где легко ошибиться. Runtipi официально заявляет: нативная установка на Windows или macOS не поддерживается, система должна работать на Linux-сервере. В документации прямо сказано: «Runtipi requires a Linux server. You can run it in a Linux VM on Windows/macOS, but native support is not available».
Поэтому для Windows и Mac единственный рабочий вариант — сначала создать локальную Linux-виртуальную машину, а уже внутри неё ставить Runtipi. Это не «опциональный путь», а обязательный шаг.
3. Пошаговое развёртывание на каждой платформе
3.1 Linux (рекомендуемый и самый простой путь)
Когда подходит: у вас есть VPS (рекомендуется Ubuntu 22.04/24.04) или домашний Linux-сервер.
Шаг 1. Подключитесь к серверу по SSH
ssh root@IP-вашего-сервераШаг 2. Запустите установочный скрипт
Официальная команда сама проверит и установит Docker (если его нет), а затем скачает все контейнеры Runtipi :
curl -L https://setup.runtipi.io | sudo bashВнимание!
в официальном FAQ указано, что при ошибке «Permission denied» нужно добавить sudo .
Шаг 3. Откройте панель
После установки откройте в браузере http://IP-вашего-сервера. При первом входе система попросит создать аккаунт администратора (email и пароль).
Шаг 4 (опционально). Установка в свой каталог
Если не хотите ставить в путь по умолчанию, перейдите через cd в нужный каталог и запустите скрипт оттуда.
3.2 Windows (только через Linux-виртуальную машину)
Когда подходит: у вас только компьютер с Windows, и вы хотите попробовать Runtipi.
Вариант: WSL2 или VirtualBox с Ubuntu.
Рассмотрим WSL2 (Windows Subsystem for Linux) — самый лёгкий способ.
Шаг 1. Включите WSL2 и установите Ubuntu
В PowerShell от имени администратора:
--install -d Ubuntu-22.04После установки перезагрузите компьютер и задайте имя пользователя и пароль Ubuntu.
Шаг 2. Войдите в среду WSL
Откройте «Ubuntu» через меню «Пуск» или введите wsl в PowerShell.
Шаг 3. Установите Runtipi внутри WSL
curl -L https://setup.runtipi.io | sudo bashШаг 4. Узнайте IP-адрес WSL
В терминале Ubuntu выполните:
hostname -IВы получите внутренний IP вида 172.x.x.x.
Шаг 5. Откройте панель в браузере Windows
Введите в Chrome/Edge адрес http://172.x.x.x (подставив IP из шага 4).
Важно: IP-адрес WSL2 может меняться после каждой перезагрузки. Для постоянного доступа настройте статический IP в WSL или проброс портов на стороне Windows. Для долгосрочного использования надёжнее создать полноценную виртуальную машину Ubuntu в VirtualBox — сетевая конфигурация там стабильнее.
3.3 macOS (только через Linux-виртуальную машину)
Когда подходит: вы работаете на Mac (Intel или Apple Silicon) и хотите запустить Runtipi.
Вариант: UTM (бесплатно, поддерживает Apple Silicon) или Parallels Desktop (платно).
Рассмотрим UTM (рекомендуется для Mac на Apple Silicon).
Шаг 1. Скачайте и установите UTM
Скачайте UTM с utm.app, установите и откройте.
Шаг 2. Скачайте образ Ubuntu Server
На официальном сайте Ubuntu скачайте Ubuntu Server 22.04 LTS ARM64 (для Apple Silicon) или x86_64 (для Intel Mac).
Шаг 3. Создайте виртуальную машину в UTM
- Нажмите «Create a New Virtual Machine»
- Выберите «Virtualize» (виртуализация)
- Выберите Linux и загрузите скачанный ISO-образ
- Выделите минимум 4 ГБ RAM и 20 ГБ диска
- Завершите создание и запустите, пройдя установку Ubuntu по мастеру
Шаг 4. Установите Runtipi внутри виртуальной машины
После входа в Ubuntu выполните ту же команду, что и для Linux:
curl -L https://setup.runtipi.io | sudo bashШаг 5. Откройте панель с Mac
В виртуальной машине Ubuntu выполните hostname -I, чтобы узнать IP, затем введите этот адрес в Safari/Chrome на macOS.
Особенность Apple Silicon: Runtipi поддерживает ARM64, но часть приложений (например, контейнеры только с x86-образами) будет недоступна. Runtipi автоматически определяет архитектуру и скрывает несовместимые приложения — при этом большинство популярных сервисов работают нормально.
4. Рекомендуемые контейнеры из App Store и их назначение
Официальный App Store Runtipi содержит сотни приложений, а社区-магазины (GeiserX Store, JigSaw Store и другие) позволяют расширить каталог. Ниже — подборка самых полезных контейнеров по сценариям.
4.1 Продуктивность и офис
|
Приложение
|
Назначение
|
Чем полезно
|
|---|---|---|
|
Nextcloud
|
Личное облако + офисный пакет
|
Замена Google Drive / OneDrive: синхронизация файлов, календарь, контакты
|
|
Paperless-ngx
|
Система управления документами (DMS)
|
Сканируете бумаги, сервис распознаёт текст (OCR) и делает полнотекстовый поиск
|
|
Outline
|
База знаний / Wiki для команды
|
Аккуратный интерфейс, лёгкая альтернатива Notion
|
|
n8n
|
Автоматизация рабочих процессов
|
Визуально связывает API, замена Zapier / Make
|
4.2 Медиа и развлечения
|
Приложение
|
Назначение
|
Чем полезно
|
|---|---|---|
|
Jellyfin
|
Личный медиасервер
|
Свой Netflix: фильмы и сериалы, аппаратное транскодирование
|
|
Navidrome
|
Музыкальный стриминг-сервер
|
Свой Spotify, поддержка протокола Subsonic
|
|
Immich
|
Резервное копирование и управление фото
|
Свой Google Photos: распознавание лиц, карта
|
|
MeTube
|
Загрузчик видео с YouTube
|
Самостоятельный инструмент скачивания видео
|
4.3 Разработка и эксплуатация
|
Приложение
|
Назначение
|
Чем полезно
|
|---|---|---|
|
Gitea
|
Собственный Git-сервис
|
Лёгкая замена GitHub
|
|
Dockge
|
Управление Docker Compose
|
Графическое управление стеками compose
|
|
Dozzle
|
Просмотр логов Docker в реальном времени
|
Лёгкий веб-мониторинг логов
|
|
Uptime Kuma
|
Мониторинг доступности сервисов
|
Проверяет, онлайн ли сайт/сервис, и шлёт уведомления
|
4.4 Быт и инструменты
|
Приложение
|
Назначение
|
Чем полезно
|
|---|---|---|
|
Mealie
|
Управление рецептами и план питания
|
Хранит рецепты, генерирует список покупок
|
|
Firefly III
|
Личные финансы
|
Учёт расходов, бюджеты, отчёты
|
|
Wallos
|
Трекер подписок
|
Контроль расходов на Netflix, Spotify и другие подписки
|
|
PairDrop
|
Передача файлов в локальной сети
|
Обмен файлами прямо в браузере, аналог AirDrop
|
4.5 Как посмотреть полный список
Войдите в панель Runtipi и нажмите App Store в левом меню — откроется каталог всех доступных приложений. На карточке каждого приложения видны название, краткое описание и иконка. Внутри карточки — скриншоты и подробности; после подтверждения нажмите Install, и приложение развернётся в один клик.
5. Предупреждение по безопасности (обязательно для VPS)
В официальной документации Runtipi есть очень заметное предупреждение: устанавливать Runtipi напрямую на публичный VPS — «плохая идея». Цитата: «When you install Runtipi on a VPS it is immediately vulnerable and open to the world through its public IP. The same goes for all apps you will install down the line through their respective ports».
Что это значит на практике?
После установки Runtipi на VPS с публичным IP сама панель и все последующие приложения оказываются напрямую доступны из интернета — любой сканер их обнаружит. Если в каком-то приложении есть известная уязвимость или вы поставили слабый пароль, сервер может быть скомпрометирован.
Рекомендуемые меры защиты:
- Cloudflare Tunnel — спрятать Runtipi за Cloudflare, не открывая порты напрямую.
- Настроить файрвол — оставить открытыми только необходимые порты (например, 80/443), закрыть все остальные входящие.
- SSL-сертификаты через DNS Challenge — в официальной документации есть отдельное руководство по получению сертификатов через Cloudflare DNS Challenge, что избавляет от необходимости выставлять сервер в интернет для валидации домена.
- Домашний сервер безопаснее — если вы запускаете Runtipi на старом компьютере или Raspberry Pi без публичного IP, рисков гораздо меньше. Самый безопасный вариант доступа — через Tailscale или WireGuard в виртуальной локальной сети.
6. Частые вопросы и устранение неполадок
При установке пишет «Permission denied»?
Добавьте sudo перед командой: curl -L https://setup.runtipi.io | sudo bash.
Можно ли поставить напрямую на Windows/Mac?
Нет. Только через Linux-виртуальную машину (WSL2, UTM, VirtualBox и т.п.).
Где хранятся данные и как делать бэкап?
Все данные приложений лежат в каталоге установки Runtipi, в папке app-data/, с организацией app-data/<store-slug>/<app-name>/. Регулярный бэкап этого каталога = бэкап всех ваших данных.
Удаление приложения стирает данные?
Да. Официально указано: при удалении приложения контейнер останавливается, образ удаляется, а данные в app-data/ удаляются безвозвратно. Перед удалением обязательно убедитесь, что бэкап сделан.
Работает ли на ARM (Raspberry Pi)?
Да. Runtipi поддерживает ARM64, Raspberry Pi 4/5 запускаются. Но приложения, для которых есть только x86-образы, отображаться не будут.
Как посмотреть логи для диагностики?
В каталоге установки Runtipi выполните docker compose logs, чтобы увидеть общие логи.
7. Итог: кому подходит Runtipi
Подходит: новичкам в self-hosting, которых отпугивает командная строка Docker; владельцам домашних серверов, желающим управлять несколькими сервисами из одной панели; тем, кто не хочет платить за подписки и хочет держать данные под контролем.
Не подходит: тем, у кого только Windows/Mac и кто не готов возиться с виртуальной машиной; тем, кто требует максимальной безопасности и не разбирается в сетевых настройках (прямое выставление VPS в интернет рискованно); тем, кому нужна максимальная производительность и кто не готов платить дополнительные ресурсы за графический интерфейс.
Главная ценность Runtipi — снижение психологического порога входа в self-hosting. Он не сделает вас экспертом по Docker, но позволит за полчаса получить рабочий набор私有ых облачных сервисов. Если вы готовы потратить немного времени на подготовку Linux-окружения — стоит попробовать.
