116 lines
4.5 KiB
Markdown
116 lines
4.5 KiB
Markdown
# Glance Dashboard Configuration
|
||
|
||
Конфигурация для [Glance](https://github.com/glanceapp/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.
|
||
|
||
```powershell
|
||
# Запуск из директории репозитория (параметры по умолчанию)
|
||
.\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)
|
||
|
||
```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` для организации виджетов:
|
||
|
||
```yaml
|
||
# В home.yml
|
||
pages:
|
||
- name: Главная
|
||
columns:
|
||
- size: full
|
||
widgets:
|
||
- type: include
|
||
path: widgets/bookmarks-homelab.yml
|
||
```
|
||
|
||
Это позволяет разделять конфигурацию на логические блоки (например, `bookmarks-general.yml` и `bookmarks-homelab.yml`).
|
||
|
||
## 🔧 Настройка SSH ключей (рекомендуется)
|
||
|
||
Для автоматической загрузки без ввода пароля настройте SSH ключи:
|
||
|
||
```powershell
|
||
# 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
|
||
```
|
||
|
||
## 📚 Полезные ссылки
|
||
|
||
- [Glance Documentation](https://github.com/glanceapp/glance)
|
||
- [Glance Configuration Examples](https://github.com/glanceapp/glance/blob/main/docs/configuration.md)
|
||
|