Homepage на VPS: установка, настройка и обслуживание

Homepage на VPS — это персонализированная панель управления для быстрого доступа к вашим self-hosted приложениям и сервисам, устанавливаемая на виртуальный сервер для централизованного мониторинга и навигации по всей вашей инфраструктуре. Эта статья подробно расскажет, как выполнить установку Homepage на VPS, настроить его для оптимальной работы и обеспечить регулярное обслуживание, включая резервное копирование и обновления. Мы рассмотрим системные требования, пошаговую установку через Docker/Compose, интеграцию с reverse proxy (Nginx/Caddy) для безопасного доступа по HTTPS, а также дадим рекомендации по выбору подходящей конфигурации VPS для различных сценариев использования Homepage.

В мире, где каждый стремится к максимальной эффективности и контролю над своей цифровой средой, инструменты для централизованного управления становятся необходимостью. Homepage – это именно такой инструмент: гибкий, настраиваемый и мощный дашборд, который позволяет собрать все ваши важные ссылки, API-метрики и информацию о состоянии сервисов в одном месте. Представьте, что у вас есть единый портал, с которого вы можете запустить code-server, проверить логи Docker-контейнеров через Dozzle, или перейти к панели управления вашим проектом в OpenProject – и все это с одной страницы, доступной из любой точки мира через ваш собственный VPS. Именно поэтому установка Homepage на собственный виртуальный сервер становится выбором многих энтузиастов и профессионалов.

Что такое Homepage и зачем он нужен на VPS?

Homepage – это современный, настраиваемый стартовый экран или дашборд, который предоставляет удобный и быстрый доступ к вашим self-hosted приложениям, сервисам, мониторингу и другой полезной информации. Он разработан для тех, кто управляет множеством локальных или удаленных сервисов и хочет иметь централизованное место для их организации. Развертывание Homepage на VPS позволяет вам создать собственный веб-портал, доступный из любой точки мира, без зависимости от сторонних облачных сервисов.

Основная идея Homepage заключается в агрегации информации и ссылок в интуитивно понятном интерфейсе. Вы можете добавить ярлыки для ваших веб-приложений (например, Nextcloud, Jellyfin, AdGuard Home), виджеты для отображения системной информации (загрузка CPU, RAM, диска), метрики с API (например, погода, новости, статус сервера) и многое другое. Все это настраивается через простые YAML-файлы, что делает Homepage невероятно гибким и мощным инструментом для организации вашего цифрового пространства.

Преимущества Homepage self-hosted на собственном сервере

Централизованный доступ: Все ваши сервисы и ссылки собраны в одном месте, сокращая время на поиск нужного приложения.
Полный контроль: Поскольку Homepage self-hosted развернут на вашем VPS, вы полностью контролируете данные, безопасность и конфигурацию, не полагаясь на сторонних провайдеров.
Кастомизация: Гибкая настройка внешнего вида, тем, ярлыков, виджетов и интеграций под ваши специфические нужды.
Мониторинг: Возможность отображать статус сервисов, системные метрики и данные с различных API прямо на дашборде.
Независимость: Отсутствие рекламы, ограничений и подписок, присущих многим облачным решениям.
Безопасность: Вы сами управляете доступом и безопасностью, используя такие инструменты, как Reverse Proxy и HTTPS, что особенно важно, когда Homepage на сервере становится точкой входа к вашей инфраструктуре.

Ключевые функции и возможности

Категории и закладки: Организация ссылок по категориям для удобной навигации.
Виджеты: Встроенные виджеты для отображения времени, даты, погоды, статуса сети, системных ресурсов и т.д.
Интеграция с API: Поддержка широкого спектра API для получения данных из различных сервисов (Sonarr, Radarr, Plex, Pi-hole, Proxmox, TrueNAS и многие другие).
Поиск: Встроенная строка поиска для быстрого нахождения нужных сервисов или информации.
Темы и стили: Возможность выбора из множества предустановленных тем и создания собственных CSS-стилей.
Автоматическое обнаружение: Интеграция с Docker API для автоматического обнаружения и отображения запущенных контейнеров.

Системные требования для установки Homepage на VPS

Homepage является относительно легким приложением, особенно если он используется в основном как набор ссылок и простых виджетов. Однако, когда вы начинаете добавлять множество API-интеграций, мониторинг большого количества сервисов и активный Docker-сокет, требования к ресурсам могут незначительно возрасти. Развертывание Homepage на VPS через Docker делает его еще более эффективным, поскольку контейнер минимально использует ресурсы.

Минимальные и рекомендуемые конфигурации

Для успешной установки Homepage и комфортной работы на VPS, рассмотрите следующие рекомендации:

Процессор (CPU):
- Минимально: 1 vCPU (виртуальное ядро) с частотой 1.5 GHz. Этого достаточно для запуска Homepage и нескольких базовых виджетов.
- Рекомендуется: 2 vCPU с частотой 2.0 GHz или выше. Обеспечит плавную работу интерфейса, быструю загрузку виджетов и стабильную работу с множеством API-интеграций.
Оперативная память (RAM):
- Минимально: 512 MB. Сам Homepage в Docker-контейнере потребляет около 50-100 MB RAM. Остальное будет использоваться операционной системой и Docker Engine.
- Рекомендуется: 1 GB или 2 GB. Это позволит комфортно работать операционной системе (например, Ubuntu Server), Docker Engine и самому Homepage, а также иметь запас для других фоновых процессов или небольших Docker-контейнеров, которые вы, возможно, захотите запустить на том же VPS.
Дисковое пространство (Storage):
- Минимально: 10 GB NVMe/SSD. Большая часть этого объема будет занята операционной системой и Docker Engine. Сам Homepage занимает очень мало места (несколько десятков мегабайт для образа и конфигурации).
- Рекомендуется: 20-40 GB NVMe/SSD. Предоставит достаточно места для системы, Docker-образов, логов, резервных копий конфигурации Homepage и, возможно, других небольших приложений. NVMe или SSD диски критически важны для скорости операций ввода-вывода, что обеспечивает быструю загрузку приложений и отклик системы.
Сетевое соединение:
- Минимально: 100 Mbps.
- Рекомендуется: 1 Gbps. Высокая скорость соединения обеспечит быстрый доступ к Homepage извне и оперативную загрузку данных из API.

Выбор операционной системы

Для развертывания Homepage через Docker рекомендуется использовать стабильные дистрибутивы Linux. Наиболее популярные и хорошо поддерживаемые варианты:

Ubuntu Server (LTS версии, например, 22.04 или 24.04): Широко используется, имеет обширную документацию и большое сообщество. Отличный выбор для большинства пользователей.
Debian (Stable версии): Известен своей стабильностью и безопасностью, немного более минималистичен, чем Ubuntu.
CentOS Stream / AlmaLinux / Rocky Linux: Хороший выбор для тех, кто предпочитает RHEL-подобные дистрибутивы.

Убедитесь, что выбранная ОС имеет минимальную установку без лишних графических оболочек, чтобы максимально освободить ресурсы для вашего Homepage Docker контейнера и других приложений.

Ищете надёжный сервер для ваших проектов?

VPS от $10/мес и выделенные серверы от $9/мес с NVMe, DDoS-защитой и поддержкой 24/7.

Смотреть предложения →

Подготовка VPS к установке Homepage через Docker

Перед тем как приступить к установке Homepage, необходимо подготовить ваш VPS. Это включает обновление системы, установку Docker Engine и Docker Compose, а также создание необходимых директорий для хранения конфигурационных файлов.

Обновление системы и установка Docker Engine

Начните с подключения к вашему VPS по SSH и обновите список пакетов, а затем обновите все установленные пакеты до последних версий. Это обеспечит наличие всех необходимых зависимостей и патчей безопасности.

sudo apt update
sudo apt upgrade -y

Далее установите Docker Engine. Рекомендуется использовать официальный скрипт установки Docker, который гарантирует получение последней стабильной версии.

sudo apt install ca-certificates curl gnupg -y
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Добавьте вашего пользователя в группу docker, чтобы выполнять команды Docker без sudo (не забудьте выйти и снова войти в SSH-сессию, чтобы изменения вступили в силу):

sudo usermod -aG docker $USER

Проверьте, что Docker установлен и работает:

docker run hello-world

Вы должны увидеть сообщение "Hello from Docker!".

Создание директорий и настройка прав

Для хранения конфигурационных файлов Homepage создайте отдельную директорию. Это поможет поддерживать порядок и облегчит процесс резервного копирования.

mkdir -p ~/homepage/config

Теперь мы готовы к созданию файла docker-compose.yml и его настройке.

rocket_launch Быстрый выбор

Ищете сервер, который просто работает?

Valebyte VPS — NVMe, поддержка 24/7, развёртывание за 60 секунд.

Смотреть тарифы VPS arrow_forward

Пошаговая установка Homepage на VPS с Docker Compose

Установка Homepage наиболее эффективно выполняется с использованием Docker Compose. Это позволяет определить все параметры контейнера (образ, порты, тома, переменные окружения) в одном YAML-файле, что упрощает управление и развертывание.

Настройка файла docker-compose.yml

Перейдите в созданную директорию и создайте файл docker-compose.yml:

cd ~/homepage
nano docker-compose.yml

Вставьте следующее содержимое. Этот файл описывает минимальную конфигурацию для запуска Homepage Docker контейнера:

version: '3.3'
services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - ./config:/app/config # Директория для конфигурационных файлов Homepage
      - /var/run/docker.sock:/var/run/docker.sock:ro # Для интеграции с Docker API
    environment:
      PUID: 1000 # ID пользователя, под которым будет работать контейнер
      PGID: 1000 # ID группы, под которой будет работать контейнер
      TZ: Europe/Moscow # Ваша временная зона
    restart: unless-stopped

Разберем основные параметры:

image: ghcr.io/gethomepage/homepage:latest: Указывает на использование последнего стабильного образа Homepage из GitHub Container Registry.
container_name: homepage: Присваивает контейнеру понятное имя.
ports: - 3000:3000: Пробрасывает порт 3000 контейнера на порт 3000 хост-системы. Это означает, что Homepage будет доступен по адресу http://ВАШ_IP_VPS:3000.
volumes::
- ./config:/app/config: Монтирует локальную директорию ./config (которую мы создали ранее) внутрь контейнера по пути /app/config. Здесь будут храниться все ваши настройки Homepage, включая settings.yaml, services.yaml и другие. Это критически важно для сохранения данных при обновлении контейнера.
- /var/run/docker.sock:/var/run/docker.sock:ro: Монтирует сокет Docker хост-системы внутрь контейнера в режиме "только для чтения" (ro). Это позволяет Homepage взаимодействовать с Docker API и отображать информацию о других запущенных Docker-контейнерах (например, их статус).
environment::
- PUID: 1000 и PGID: 1000: Определяют ID пользователя и группы, под которыми будут запускаться процессы внутри контейнера. Обычно 1000 соответствует первому созданному пользователю (вашему пользователю) в большинстве Linux-систем. Вы можете узнать свои ID, выполнив команды id -u и id -g на вашем VPS.
- TZ: Europe/Moscow: Устанавливает временную зону для контейнера. Замените на вашу временную зону (например, America/New_York, Asia/Tokyo).
restart: unless-stopped: Гарантирует, что контейнер будет автоматически перезапускаться после сбоев или перезагрузки VPS, если только вы не остановите его вручную.

Запуск Homepage и первоначальная настройка

После сохранения файла docker-compose.yml (Ctrl+O, Enter, Ctrl+X в nano) запустите контейнер:

docker compose up -d

Опция -d запускает контейнер в фоновом режиме (detached mode). Docker загрузит образ Homepage, создаст контейнер и запустит его.

Проверьте статус контейнера:

docker compose ps

Вы должны увидеть, что контейнер homepage находится в статусе "Up".

Теперь вы можете получить доступ к Homepage, открыв в браузере адрес http://ВАШ_IP_VPS:3000. Вы увидите базовый интерфейс Homepage.

Для настройки Homepage вам нужно будет отредактировать YAML-файлы в директории ~/homepage/config. Основные файлы:

settings.yaml: Общие настройки Homepage (тема, язык, виджеты).
services.yaml: Определение ваших сервисов и ссылок.
widgets.yaml: Дополнительные виджеты.

Пример services.yaml:

- Home:
    - Valebyte:
        icon: https://valebyte.com/favicon.ico
        href: https://valebyte.com
        description: VPS и выделенные серверы
    - Dozzle:
        icon: docker
        href: http://ВАШ_IP_VPS:8080 # Если Dozzle запущен на том же VPS
        description: Мониторинг Docker логов
    - NocoDB:
        icon: database
        href: http://ВАШ_IP_VPS:8081 # Если NocoDB запущен на том же VPS
        description: База данных как таблица

После каждого изменения файлов конфигурации в директории ~/homepage/config, Homepage автоматически перезагружает их, и изменения сразу отображаются в браузере. Если изменения не видны, очистите кэш браузера или перезапустите контейнер:

docker compose restart homepage

Помните, что для работы с Homepage на сервере и его интеграциями, такими как NocoDB, важно правильно настроить порты и доступ.

Настройка Reverse Proxy (Nginx или Caddy) и HTTPS для Homepage

Доступ к Homepage по IP-адресу и порту 3000 не является ни безопасным, ни удобным. Для обеспечения безопасного доступа по доменному имени и шифрования трафика (HTTPS) необходимо использовать reverse proxy. Nginx и Caddy – два популярных выбора для этой задачи.

Зачем нужен Reverse Proxy и HTTPS

HTTPS (SSL/TLS): Шифрует весь трафик между вашим браузером и сервером, защищая ваши данные от перехвата. Это критически важно для любого публично доступного веб-сервиса.
Доменное имя: Позволяет обращаться к Homepage по удобному доменному имени (например, homepage.yourdomain.com) вместо IP-адреса и порта.
Маскировка порта: Reverse proxy позволяет скрыть порт 3000, сделав Homepage доступным по стандартному порту 443 (HTTPS).
Централизованное управление: Вы можете использовать один reverse proxy для маршрутизации трафика к нескольким приложениям, запущенным на вашем VPS.
Дополнительная безопасность: Reverse proxy может выступать в качестве первого рубежа обороны, фильтруя вредоносный трафик.

Для настройки HTTPS вам понадобится доменное имя, указывающее на IP-адрес вашего VPS. Также нужно будет открыть порты 80 (HTTP) и 443 (HTTPS) в вашем фаерволе (например, UFW):

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Конфигурация Nginx для Homepage

Сначала установите Nginx:

sudo apt install nginx -y

Затем создайте новый файл конфигурации для вашего домена (например, homepage.conf) в директории /etc/nginx/sites-available/:

sudo nano /etc/nginx/sites-available/homepage.conf

Вставьте следующую базовую конфигурацию (замените homepage.yourdomain.com на ваш домен):

server {
    listen 80;
    server_name homepage.yourdomain.com;

    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;
    }
}

Создайте символическую ссылку на этот файл в sites-enabled и проверьте конфигурацию Nginx:

sudo ln -s /etc/nginx/sites-available/homepage.conf /etc/nginx/sites-enabled/
sudo nginx -t

Если ошибок нет, перезагрузите Nginx:

sudo systemctl restart nginx

Теперь ваш Homepage доступен по HTTP через http://homepage.yourdomain.com. Для HTTPS используйте Certbot:

sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
sudo certbot --nginx -d homepage.yourdomain.com

Certbot автоматически настроит Nginx для HTTPS и добавит автоматическое обновление сертификатов. Следуйте инструкциям на экране. После завершения ваш Homepage будет доступен по https://homepage.yourdomain.com.

Конфигурация Caddy для Homepage

Caddy – это современный веб-сервер, который автоматически управляет HTTPS-сертификатами с Let's Encrypt, что делает его очень удобным для self-hosted приложений. Установите Caddy:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy -y

Создайте или отредактируйте файл /etc/caddy/Caddyfile:

sudo nano /etc/caddy/Caddyfile

Удалите все существующее содержимое и добавьте следующую конфигурацию (замените homepage.yourdomain.com на ваш домен):

homepage.yourdomain.com {
    reverse_proxy localhost:3000
}

Это все! Caddy автоматически получит и настроит HTTPS-сертификат для вашего домена. Перезагрузите Caddy:

sudo systemctl restart caddy

Теперь ваш Homepage будет доступен по https://homepage.yourdomain.com.

Резервное копирование и обновление Homepage на VPS

Регулярное резервное копирование и своевременные обновления – критически важные аспекты обслуживания любого приложения, особенно когда речь идет о Homepage на сервере, который является центральной точкой доступа к вашей инфраструктуре.

Стратегии бэкапов данных Homepage

Все важные данные Homepage хранятся в директории ~/homepage/config, которую мы смонтировали как том Docker. Это значительно упрощает процесс резервного копирования.

Что нужно бэкапить:

Вся директория ~/homepage/config.

Методы резервного копирования:

Ручное копирование:
Вы можете просто скопировать директорию config в безопасное место на вашем VPS или скачать ее на локальный компьютер через SCP/SFTP.
```
cp -r ~/homepage/config ~/homepage_config_backup_$(date +%Y%m%d%H%M)
```
Для скачивания на локальную машину (из терминала на вашей локальной машине):
```
scp -r user@your_vps_ip:~/homepage/config ~/homepage_backup/
```
Автоматизированное резервное копирование (Cron + Rsync/Rclone):
Для автоматизации можно использовать cron и rsync или rclone для копирования данных на удаленное хранилище (например, S3-совместимое облачное хранилище, Google Drive, Dropbox).

Пример скрипта для бэкапа в локальную папку:
```
#!/bin/bash
BACKUP_DIR="/var/backups/homepage"
CONFIG_DIR="/home/$USER/homepage/config"
TIMESTAMP=$(date +%Y%m%d%H%M%S)
ARCHIVE_NAME="homepage_config_${TIMESTAMP}.tar.gz"

mkdir -p $BACKUP_DIR
tar -czf "${BACKUP_DIR}/${ARCHIVE_NAME}" -C "$(dirname "$CONFIG_DIR")" "$(basename "$CONFIG_DIR")"

# Удаление старых бэкапов (например, старше 7 дней)
find $BACKUP_DIR -name "homepage_config_*.tar.gz" -type f -mtime +7 -delete

echo "Homepage config backup created: ${BACKUP_DIR}/${ARCHIVE_NAME}"
```
Сохраните этот скрипт как ~/backup_homepage.sh, сделайте его исполняемым (chmod +x ~/backup_homepage.sh) и добавьте в cron для ежедневного запуска:
```
crontab -e
```
Добавьте строку для ежедневного запуска в 3:00 ночи:
```
0 3 * * * /home/$USER/backup_homepage.sh >> /var/log/homepage_backup.log 2>&1
```

Процесс обновления Homepage и Docker-контейнеров

Благодаря использованию Docker Compose, обновление Homepage сводится к нескольким простым командам.

Шаги обновления:

Перейдите в директорию с docker-compose.yml:
```
cd ~/homepage
        
```
Остановите текущий контейнер Homepage:
```
docker compose stop homepage
        
```
Вытяните последний образ Homepage:
```
docker compose pull homepage
        
```
Это загрузит новую версию образа ghcr.io/gethomepage/homepage:latest, если она доступна.
Запустите контейнер с новым образом:
```
docker compose up -d homepage
        
```
Docker Compose пересоздаст контейнер, используя новый образ, но сохранит все ваши данные, так как они находятся в смонтированном томе ./config.
Очистите старые Docker-образы (опционально):
После обновления могут остаться старые образы, которые занимают место. Их можно удалить:
```
docker image prune -f
        
```

Важные замечания:

Всегда делайте резервную копию директории config перед обновлением, чтобы иметь возможность откатиться в случае проблем.
Проверяйте официальный репозиторий Homepage на GitHub или их документацию на предмет важных изменений или инструкций по обновлению, которые могут потребовать изменения в docker-compose.yml.

rocket_launch Быстрый выбор

Ищете сервер, который просто работает?

Valebyte VPS — NVMe, поддержка 24/7, развёртывание за 60 секунд.

Смотреть тарифы VPS arrow_forward

Какой VPS-конфиг выбрать для Homepage под реальную нагрузку?

Выбор подходящей конфигурации VPS для Homepage на VPS зависит от ваших потребностей. Homepage сам по себе не требует много ресурсов, но если вы планируете размещать на том же VPS другие приложения или использовать Homepage с большим количеством виджетов и API-интеграций, стоит задуматься о более мощном решении.

Таблица сравнения VPS-конфигураций для разных сценариев

Ниже представлена таблица, которая поможет вам определиться с выбором VPS-конфигурации от Valebyte для различных сценариев использования Homepage. Цены указаны ориентировочно и могут варьироваться.

Сценарий использования	CPU (vCores)	RAM (GB)	NVMe/SSD (GB)	Пропускная способность (Mbps)	Примерная стоимость/мес (Valebyte VPS)	Рекомендации
Минимальный (Только Homepage, несколько ссылок)	1	1	20	500	От $4.99	Базовый тариф, идеален для ознакомления и личного использования с минимумом виджетов.
Стандартный (Homepage + 2-3 Docker-приложения)	2	2	40	1000	От $9.99	Хороший выбор для Homepage с активными виджетами и несколькими легкими приложениями (например, Dozzle, AdGuard Home).
Продвинутый (Homepage + 5+ Docker-приложений, API-интеграции)	4	4	80	1000+	От $19.99	Подходит для тех, кто хочет разместить на одном VPS множество сервисов (например, NocoDB, code-server, Plex) и использовать Homepage как полноценный центр управления.
Высоконагруженный (Homepage + ресурсоемкие приложения, базы данных)	6+	8+	160+	1000+	От $39.99	Для профессионалов и команд, управляющих крупными проектами или требующих высокой производительности для всех self-hosted сервисов.

Выводы

Homepage – это мощный и гибкий инструмент для создания персонализированного дашборда ваших self-hosted сервисов. Развернутый на VPS, он предоставляет полный контроль над вашей цифровой инфраструктурой, обеспечивая удобный доступ и мониторинг. Для большинства пользователей оптимальным выбором будет VPS с 2 vCPU, 2-4 GB RAM и 40-80 GB NVMe-диска, что обеспечит стабильную работу Homepage и достаточный запас для размещения нескольких дополнительных Docker-приложений.

Готовы выбрать сервер?

VPS и выделенные серверы в 72+ странах с мгновенной активацией и полным root-доступом.

Начать сейчас →