Files
glance/README.md
2025-12-06 11:58:43 +03:00

4.5 KiB
Raw Permalink Blame History

Glance Dashboard Configuration

Конфигурация для Glance - минималистичного дашборда для самостоятельного хостинга.

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

glance/
├── home.yml                      # Главный файл конфигурации
├── widgets/                      # Отдельные виджеты (модульная структура)
│   ├── bookmarks-general.yml     # Общие закладки (Личное)
│   ├── bookmarks-homelab.yml     # Закладки Homelab (Администрирование)
│   ├── countdown.yml             # Виджет обратного отсчета
│   ├── qbittorrent.yml           # Виджет qBittorrent
│   └── ...                       # Другие виджеты
├── upload-glance-config.ps1      # PowerShell скрипт для загрузки (Windows)
├── upload-glance-config.sh       # Shell скрипт для загрузки (Linux/macOS)
└── README.md                     # Этот файл

🚀 Установка и настройка

Требования

Для Windows:

  • PowerShell 5.1+ (предустановлен в Windows 10/11)
  • Установленный OpenSSH Client (обычно предустановлен в Windows 10/11)
    • Проверить: ssh -V

Для Linux/macOS:

  • bash
  • ssh и scp

📤 Загрузка конфигурации на сервер

Windows (PowerShell)

Скрипт использует нативный OpenSSH клиент в Windows.

# Запуск из директории репозитория (параметры по умолчанию)
.\upload-glance-config.ps1

# С указанием хоста
.\upload-glance-config.ps1 -RemoteHost "192.168.50.114"

# Полная версия (если запускаете из другой папки)
.\upload-glance-config.ps1 -LocalDir "e:\repos\glance" -User "root" -RemoteHost "192.168.50.114"

Linux/macOS (Bash)

# Добавьте права на выполнение
chmod +x upload-glance-config.sh

# Запуск
./upload-glance-config.sh

⚙️ Параметры скрипта (PowerShell)

Параметр Описание Значение по умолчанию
LocalDir Локальная директория с конфигурацией . (Текущая директория)
User Пользователь SSH root
RemoteHost IP адрес или hostname сервера 192.168.50.114

📋 Что делает скрипт

  1. Загружает home.yml/opt/glance/config/glance.yml на сервере.
  2. Синхронизирует директорию widgets//opt/glance/config/widgets/ на сервере.
  3. Автоматически создает необходимые директории на сервере.

Glance автоматически перезагружает конфигурацию при обнаружении изменений.

🎨 Модульная структура виджетов

Конфигурация использует функцию include для организации виджетов:

# В home.yml
pages:
  - name: Главная
    columns:
      - size: full
        widgets:
          - type: include
            path: widgets/bookmarks-homelab.yml

Это позволяет разделять конфигурацию на логические блоки (например, bookmarks-general.yml и bookmarks-homelab.yml).

🔧 Настройка SSH ключей (рекомендуется)

Для автоматической загрузки без ввода пароля настройте SSH ключи:

# Windows / Linux / macOS
# 1. Генерируем ключ (если нет)
ssh-keygen -t ed25519 -C "glance-config"

# 2. Копируем на сервер
# Windows (PowerShell):
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh root@192.168.50.114 "cat >> .ssh/authorized_keys"

# Linux/macOS:
ssh-copy-id root@192.168.50.114

📚 Полезные ссылки