mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-16 04:02:52 +02:00
Divarion_D
dbf535bcc5
Fix Markdown-mangling artifacts the free web engine (yandex) produced in the
committed docs/ru, and regenerate the whole tree cleanly (0 fallbacks):
- Sentinel format @@N@@ -> {N}. MT engines are trained to preserve curly
format-string placeholders, so {N} survives code-heavy lines where @@N@@ (and
ZZZ…ZZZ, which also duplicated its Z) were split/moved — e.g. the stray
"@0@@" in the FAQ and "load balancerZ" in the README are gone.
- Possessive: a trailing English `'s` is consumed INTO the masked span and
dropped on restore. Every sentinel format breaks when a bare `'s` sits right
after it, and Russian has no possessive `'s`.
- Validate + retry: after restore, any leftover brace fragment triggers a retry
(the engine is non-deterministic); after a few failures the line stays English
so a broken token is never emitted.
- Glossary += KeyDB, yt-dlp, Ubuntu, iptables, MAGSCAN.
Regenerated docs/ru (37 files, translators/yandex): no residual sentinels,
mkdocs build --strict clean.
189 lines
8.0 KiB
Markdown
189 lines
8.0 KiB
Markdown
# XC_VM Руководство по миграции
|
|
|
|
Безопасная миграция с совместимых IPTV-систем с помощью встроенных инструментов миграции XC_VM.
|
|
|
|
---
|
|
|
|
## Важное уведомление о переносе
|
|
|
|
> **Прочтите это перед началом миграции.**
|
|
|
|
XC_VM миграция переносит только **данные**.
|
|
**Вся конфигурация намеренно исключена из процесса миграции.**
|
|
|
|
Это включает в себя (но не ограничивается этим):
|
|
|
|
- Ключи API (например, **TMDb**)
|
|
- Учетные данные внешней службы
|
|
- Настройки, зависящие от конкретной среды
|
|
- Конфигурация панели и системы
|
|
- Время выполнения и состояние потока
|
|
|
|
Эти значения ** должны быть перенастроены вручную после миграции**.
|
|
|
|
Это ** дизайнерское решение**, а не ограничение или ошибка.
|
|
Пропуск переконфигурации приведет к ** прерыванию выборки метаданных, обновлению заголовков потоков и связанных с ними функций **.
|
|
|
|
---
|
|
|
|
## Прежде чем Вы начнете
|
|
|
|
> 💡 **Рекомендация:**
|
|
> Выполните миграцию при **новой установке XC_VM**.
|
|
>
|
|
> ⚠️ **Важно:**
|
|
> Системные настройки и настройки панели ** НЕ перенесены**.
|
|
> Передаются только данные базы данных, поддерживаемые процессом миграции.
|
|
|
|
Если вы решите перейти на **существующую установку**, имейте в виду:
|
|
|
|
- XC_VM приведет к удалению всех таблиц в основной базе данных, которые соответствуют данным из базы данных миграции.
|
|
- **Резервное копирование является обязательным.** Автоматический откат не предусмотрен.
|
|
|
|
---
|
|
|
|
## Этапы миграции
|
|
|
|
### 1. Загрузить резервную копию
|
|
|
|
Загрузите существующую резервную копию базы данных на сервер XC_VM, используя **SFTP**.
|
|
|
|
Примерное местоположение:
|
|
|
|
```text
|
|
/tmp/backup.sql
|
|
```
|
|
|
|
---
|
|
|
|
### 2. Восстановить резервную копию в базе данных миграции
|
|
|
|
Очистите базу данных миграции и восстановите резервную копию:
|
|
|
|
```bash
|
|
sudo /home/xc_vm/console.php tools migration "/tmp/backup.sql"
|
|
```
|
|
|
|
Прежде чем продолжить, убедитесь, что восстановление завершилось ** без ошибок**.
|
|
|
|
---
|
|
|
|
### 3. Начать миграцию
|
|
|
|
Как только резервная копия будет восстановлена, запустите миграцию, используя один из следующих способов.
|
|
|
|
#### Вариант 1 — Командная строка (рекомендуется)
|
|
|
|
```bash
|
|
/home/xc_vm/console.php migrate
|
|
```
|
|
|
|
#### Вариант 2 — Веб-установщик
|
|
|
|
- Вернитесь к веб-установщику ** (ссылка показана во время настройки панели).
|
|
- Выберите **Перенос**
|
|
- Следуйте инструкциям на экране
|
|
|
|
Вы будете видеть обновления о ходе выполнения в режиме реального времени.
|
|
После завершения работы система будет доступна.
|
|
|
|
---
|
|
|
|
## Восстановление Доступа После Миграции
|
|
|
|
Если войти в систему не удается из-за отсутствия учетных данных или кода доступа, воспользуйтесь средствами восстановления.
|
|
|
|
### Создайте аварийный код доступа
|
|
|
|
```bash
|
|
sudo /home/xc_vm/console.php tools access
|
|
```
|
|
|
|
### Создайте учетную запись администратора
|
|
|
|
```bash
|
|
sudo /home/xc_vm/console.php tools user
|
|
```
|
|
|
|
> ❗️ После восстановления доступа ** немедленно измените ** код доступа и учетные данные администратора.
|
|
|
|
---
|
|
|
|
## Подготовка балансировщика нагрузки
|
|
|
|
Подсистемы балансировки нагрузки **не перенесены**.
|
|
|
|
- При необходимости переустановите операционную систему
|
|
- Перенастройка сети и маршрутизации
|
|
- Повторно подключите их к основному серверу
|
|
|
|
---
|
|
|
|
## Постмиграционный период (обязательно)
|
|
|
|
После миграции система ** не готова к работе** до тех пор, пока не будут выполнены эти шаги.
|
|
|
|
Пропуск их приведет к ** ожидаемому, но нарушенному поведению **.
|
|
|
|
---
|
|
|
|
### 1. Повторная инициализация состояния среды выполнения
|
|
|
|
- Запускайте все потоки вручную
|
|
- Убедитесь, что потоки доступны и стабильны
|
|
|
|
> Состояние выполнения потока ** никогда не сохраняется ** во время миграции.
|
|
|
|
---
|
|
|
|
### 2. Перенастроить системные параметры
|
|
|
|
Просмотрите и восстановите все настройки, зависящие от конкретной среды:
|
|
|
|
- Пути к файлам
|
|
- Ограничения и квоты
|
|
- Настройки сети и обратного прокси-сервера
|
|
- Настройка производительности
|
|
|
|
> Не предполагайте, что значения по умолчанию соответствуют вашим предыдущим настройкам.
|
|
> Значения по умолчанию применяются намеренно.
|
|
|
|
---
|
|
|
|
### 3. Восстановление ключей API и поставщиков
|
|
|
|
#### Ключи API Никогда Не Переносятся
|
|
|
|
Следующие параметры ** необходимо перенастроить вручную**:
|
|
|
|
- **Ключ API TMDb**
|
|
|
|
Это ** ожидаемое поведение**.
|
|
|
|
> Если выборка метаданных не работает после миграции,
|
|
> убедитесь, что ключ API был повторно добавлен и поставщик включен.
|
|
> Это не указывает на ошибку переноса.
|
|
|
|
---
|
|
|
|
## Общие проблемы после миграции
|
|
|
|
### Метаданные Не извлекаются (TMDb)
|
|
|
|
**Причина:**
|
|
Ключ API TMDb и конфигурация поставщика не были восстановлены.
|
|
|
|
**Разрешение:**
|
|
Повторно добавьте ключ API TMDb и включите провайдера в настройках главного сервера.
|
|
|
|
---
|
|
|
|
## Резюме
|
|
|
|
- Миграционный перенос ** только основных данных приложения**
|
|
- Конфигурация ** исключена по замыслу**
|
|
- Ключи API и настройки, зависящие от среды **, должны быть восстановлены вручную**
|
|
- Отсутствие функциональности после миграции ** ожидается до завершения реконфигурации**
|
|
|
|
---
|