docs: Обновить README
This commit is contained in:
134
README.md
134
README.md
@@ -8,11 +8,13 @@
|
|||||||
glance/
|
glance/
|
||||||
├── home.yml # Главный файл конфигурации
|
├── home.yml # Главный файл конфигурации
|
||||||
├── widgets/ # Отдельные виджеты (модульная структура)
|
├── widgets/ # Отдельные виджеты (модульная структура)
|
||||||
│ ├── bookmarks-homelab.yml # Закладки Homelab
|
│ ├── bookmarks-general.yml # Общие закладки (Личное)
|
||||||
|
│ ├── bookmarks-homelab.yml # Закладки Homelab (Администрирование)
|
||||||
|
│ ├── countdown.yml # Виджет обратного отсчета
|
||||||
│ ├── qbittorrent.yml # Виджет qBittorrent
|
│ ├── qbittorrent.yml # Виджет qBittorrent
|
||||||
│ └── ... # Другие виджеты
|
│ └── ... # Другие виджеты
|
||||||
├── upload-glance-config.sh # Shell скрипт для загрузки конфигурации
|
├── upload-glance-config.ps1 # PowerShell скрипт для загрузки (Windows)
|
||||||
├── upload-glance-config.ps1 # PowerShell обертка (использует WSL)
|
├── upload-glance-config.sh # Shell скрипт для загрузки (Linux/macOS)
|
||||||
└── README.md # Этот файл
|
└── README.md # Этот файл
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -20,66 +22,55 @@ glance/
|
|||||||
|
|
||||||
### Требования
|
### Требования
|
||||||
|
|
||||||
|
**Для Windows:**
|
||||||
|
- PowerShell 5.1+ (предустановлен в Windows 10/11)
|
||||||
|
- Установленный OpenSSH Client (обычно предустановлен в Windows 10/11)
|
||||||
|
- Проверить: `ssh -V`
|
||||||
|
|
||||||
**Для Linux/macOS:**
|
**Для Linux/macOS:**
|
||||||
- `bash`
|
- `bash`
|
||||||
- `ssh` и `scp` (обычно предустановлены)
|
- `ssh` и `scp`
|
||||||
- SSH доступ к серверу с Glance
|
|
||||||
|
|
||||||
**Для Windows:**
|
|
||||||
- [WSL (Windows Subsystem for Linux)](https://docs.microsoft.com/ru-ru/windows/wsl/install)
|
|
||||||
- PowerShell 5.1+ (предустановлен в Windows 10/11)
|
|
||||||
- SSH доступ к серверу с Glance
|
|
||||||
|
|
||||||
### Установка WSL (только для Windows)
|
|
||||||
|
|
||||||
```powershell
|
|
||||||
# Запустите PowerShell от имени администратора
|
|
||||||
wsl --install
|
|
||||||
```
|
|
||||||
|
|
||||||
После установки перезагрузите компьютер.
|
|
||||||
|
|
||||||
## 📤 Загрузка конфигурации на сервер
|
## 📤 Загрузка конфигурации на сервер
|
||||||
|
|
||||||
### Linux/macOS
|
### Windows (PowerShell)
|
||||||
|
|
||||||
```bash
|
Скрипт использует нативный OpenSSH клиент в Windows.
|
||||||
# С параметрами по умолчанию (./glance, root@192.168.50.114)
|
|
||||||
./upload-glance-config.sh
|
|
||||||
|
|
||||||
# С произвольными параметрами
|
|
||||||
./upload-glance-config.sh /path/to/glance username 192.168.50.100
|
|
||||||
```
|
|
||||||
|
|
||||||
### Windows
|
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
# С параметрами по умолчанию
|
# Запуск из директории репозитория (параметры по умолчанию)
|
||||||
.\upload-glance-config.ps1
|
.\upload-glance-config.ps1
|
||||||
|
|
||||||
# С произвольными параметрами
|
# С указанием хоста
|
||||||
.\upload-glance-config.ps1 -LocalDir "e:\repos\glance" -User "root" -Host "192.168.50.114"
|
.\upload-glance-config.ps1 -RemoteHost "192.168.50.114"
|
||||||
|
|
||||||
# Или в кратком виде
|
# Полная версия (если запускаете из другой папки)
|
||||||
.\upload-glance-config.ps1 "e:\repos\glance" "root" "192.168.50.114"
|
.\upload-glance-config.ps1 -LocalDir "e:\repos\glance" -User "root" -RemoteHost "192.168.50.114"
|
||||||
```
|
```
|
||||||
|
|
||||||
> **Примечание:** PowerShell скрипт является оберткой, которая вызывает shell скрипт через WSL, избегая дублирования кода.
|
### Linux/macOS (Bash)
|
||||||
|
|
||||||
## ⚙️ Параметры скрипта
|
```bash
|
||||||
|
# Добавьте права на выполнение
|
||||||
|
chmod +x upload-glance-config.sh
|
||||||
|
|
||||||
|
# Запуск
|
||||||
|
./upload-glance-config.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## ⚙️ Параметры скрипта (PowerShell)
|
||||||
|
|
||||||
| Параметр | Описание | Значение по умолчанию |
|
| Параметр | Описание | Значение по умолчанию |
|
||||||
|----------|----------|----------------------|
|
|----------|----------|----------------------|
|
||||||
| `LOCAL_DIR` / `-LocalDir` | Локальная директория с конфигурацией | `./glance` |
|
| `LocalDir` | Локальная директория с конфигурацией | `.` (Текущая директория) |
|
||||||
| `USER` / `-User` | Пользователь SSH | `root` |
|
| `User` | Пользователь SSH | `root` |
|
||||||
| `HOST` / `-Host` | IP адрес или hostname сервера | `192.168.50.114` |
|
| `RemoteHost` | IP адрес или hostname сервера | `192.168.50.114` |
|
||||||
|
|
||||||
## 📋 Что делает скрипт
|
## 📋 Что делает скрипт
|
||||||
|
|
||||||
1. **Загружает `home.yml`** → `/opt/glance/config/glance.yml` на сервере
|
1. **Загружает `home.yml`** → `/opt/glance/config/glance.yml` на сервере.
|
||||||
2. **Синхронизирует директорию `widgets/`** → `/opt/glance/config/widgets/` на сервере
|
2. **Синхронизирует директорию `widgets/`** → `/opt/glance/config/widgets/` на сервере.
|
||||||
3. **Автоматически создает** необходимые директории на сервере
|
3. **Автоматически создает** необходимые директории на сервере.
|
||||||
4. **Проверяет наличие** файлов и директорий перед загрузкой
|
|
||||||
|
|
||||||
> Glance автоматически перезагружает конфигурацию при обнаружении изменений.
|
> Glance автоматически перезагружает конфигурацию при обнаружении изменений.
|
||||||
|
|
||||||
@@ -98,64 +89,27 @@ pages:
|
|||||||
path: widgets/bookmarks-homelab.yml
|
path: widgets/bookmarks-homelab.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
### Преимущества модульной структуры
|
Это позволяет разделять конфигурацию на логические блоки (например, `bookmarks-general.yml` и `bookmarks-homelab.yml`).
|
||||||
|
|
||||||
- ✅ Легче управлять и редактировать отдельные виджеты
|
|
||||||
- ✅ Переиспользование виджетов в разных страницах
|
|
||||||
- ✅ Простота версионирования и отладки
|
|
||||||
- ✅ Чище git история изменений
|
|
||||||
|
|
||||||
## 🔧 Настройка SSH ключей (рекомендуется)
|
## 🔧 Настройка SSH ключей (рекомендуется)
|
||||||
|
|
||||||
Для автоматической загрузки без ввода пароля:
|
Для автоматической загрузки без ввода пароля настройте SSH ключи:
|
||||||
|
|
||||||
```bash
|
```powershell
|
||||||
# Сгенерируйте SSH ключ (если еще не создан)
|
# Windows / Linux / macOS
|
||||||
|
# 1. Генерируем ключ (если нет)
|
||||||
ssh-keygen -t ed25519 -C "glance-config"
|
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
|
ssh-copy-id root@192.168.50.114
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🐛 Устранение неполадок
|
|
||||||
|
|
||||||
### Windows: "wsl: команда не найдена"
|
|
||||||
|
|
||||||
Убедитесь, что WSL установлен:
|
|
||||||
```powershell
|
|
||||||
wsl --version
|
|
||||||
```
|
|
||||||
|
|
||||||
Если WSL не установлен, выполните:
|
|
||||||
```powershell
|
|
||||||
wsl --install
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ошибка SSH подключения
|
|
||||||
|
|
||||||
Проверьте подключение вручную:
|
|
||||||
```bash
|
|
||||||
ssh root@192.168.50.114
|
|
||||||
```
|
|
||||||
|
|
||||||
### Директория не найдена
|
|
||||||
|
|
||||||
Убедитесь, что вы запускаете скрипт из правильной директории:
|
|
||||||
```bash
|
|
||||||
# Linux/macOS
|
|
||||||
ls -la glance/
|
|
||||||
|
|
||||||
# PowerShell
|
|
||||||
Get-ChildItem glance/
|
|
||||||
```
|
|
||||||
|
|
||||||
## 📚 Полезные ссылки
|
## 📚 Полезные ссылки
|
||||||
|
|
||||||
- [Glance Documentation](https://github.com/glanceapp/glance)
|
- [Glance Documentation](https://github.com/glanceapp/glance)
|
||||||
- [Glance Configuration Examples](https://github.com/glanceapp/glance/blob/main/docs/configuration.md)
|
- [Glance Configuration Examples](https://github.com/glanceapp/glance/blob/main/docs/configuration.md)
|
||||||
- [WSL Documentation (RU)](https://docs.microsoft.com/ru-ru/windows/wsl/)
|
|
||||||
|
|
||||||
## 📝 Лицензия
|
|
||||||
|
|
||||||
Этот проект следует лицензии основного проекта [Glance](https://github.com/glanceapp/glance).
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user