UK Backup and Restore - KnevS/Tesla-Carview GitHub Wiki

Резервне копіювання та відновлення

🤖 Цей український переклад створений з AI-підтримкою з англійського оригіналу. Виправлення приймаються на GitHub.

🌐 Мова: EN · DE · FR · ES · TR · EL · UK

Ваші дані (поїздки, історія заряджання, журнал, налаштування) живуть у базах даних SQLite на вашому сервері. Регулярні резервні копії захищають від збоїв обладнання, випадкового видалення або міграції на новий сервер.

Що потрібно резервувати?

Дані Розташування Розмір (типово)
Master-база даних /app/data/master.db ~1 МБ
Бази даних орендарів /app/data/tenants/*.db ~50 МБ на орендаря (3 роки)
Конфігурація середовища /opt/tesla-carview/backend/.env Мізерно
SSL-сертифікат /etc/letsencrypt/ Мізерно

Docker-образи та код застосунку не потребують резервного копіювання — їх можна повторно завантажити з GitHub у будь-який момент.

Варіант 1: Резервне копіювання у застосунку (рекомендовано для більшості користувачів)

Tesla Carview має вбудовану функцію резервного копіювання:

  1. Перейдіть до Admin → Data → Backup
  2. Натисніть Download Backup
  3. Завантажується JSON-файл, що містить усі 25 таблиць бази даних
  4. Збережіть його в безпечному місці (зовнішній диск, хмарне сховище, інший пристрій)

Відновлення з резервної копії:

  1. Перейдіть до Admin → Data → Restore
  2. Завантажте JSON-файл резервної копії
  3. Введіть фразу підтвердження RESTORE
  4. Відновлення завершується за лічені секунди
  5. Перед відновленням автоматично створюється страхувальна копія поточних даних

Варіант 2: Скрипт автоматичного резервного копіювання

Для безконтрольних резервних копій створіть cron-завдання, що зберігає копію щодня:

# Створити каталог резервних копій
mkdir -p /opt/backups/tesla-carview

# Створити скрипт резервного копіювання
cat > /opt/backups/backup-tesla.sh << 'EOF'
#!/bin/bash
DATE=$(date +%Y%m%d-%H%M)
BACKUP_DIR="/opt/backups/tesla-carview"
DATA_DIR="/var/lib/docker/volumes/tesla_data/_data"

# Скопіювати бази даних
cp "$DATA_DIR/master.db" "$BACKUP_DIR/master-$DATE.db"
cp -r "$DATA_DIR/tenants" "$BACKUP_DIR/tenants-$DATE/"
cp "/opt/tesla-carview/backend/.env" "$BACKUP_DIR/env-$DATE.bak"

# Зберігати лише останні 14 днів
find "$BACKUP_DIR" -name "*.db" -mtime +14 -delete
find "$BACKUP_DIR" -name "*.bak" -mtime +14 -delete
find "$BACKUP_DIR" -type d -name "tenants-*" -mtime +14 -exec rm -rf {} +

echo "Backup done: $DATE"
EOF

chmod +x /opt/backups/backup-tesla.sh

# Додати до cron (запускається щодня о 02:00)
echo "0 2 * * * root /opt/backups/backup-tesla.sh >> /var/log/tesla-backup.log 2>&1" > /etc/cron.d/tesla-backup

Варіант 3: Резервне копіювання поза сайтом (рекомендовано для важливих даних)

Резервна копія на тому самому сервері не захищає від збою сервера. Копіюйте резервні копії поза сайт:

На віддалений SSH-сервер / NAS

# Додайте до вашого скрипту резервного копіювання:
rsync -az /opt/backups/tesla-carview/ user@nas-ip:/backups/tesla-carview/

На Hetzner Storage Box (дешево, ~1€/місяць за 100 ГБ)

# Додайте до вашого скрипту резервного копіювання:
rsync -az /opt/backups/tesla-carview/ your-storagebox.your-storagebox.de:/backups/

До хмарного провайдера (Backblaze B2, AWS S3)

# Встановити rclone (підтримує більшість хмарних провайдерів):
curl https://rclone.org/install.sh | sudo bash
rclone config  # Інтерактивне налаштування вашого хмарного провайдера

# Додати до скрипту резервного копіювання:
rclone sync /opt/backups/tesla-carview/ backblaze:my-bucket/tesla-carview/

Міграція на новий сервер

При переході на новий сервер (оновлення обладнання, зміна VPS):

  1. На старому сервері: Завантажте повну резервну копію через Admin → Data → Backup
  2. На новому сервері: Запустіть скрипт налаштування: curl -fsSL https://raw.githubusercontent.com/KnevS/Tesla-Carview/main/deploy/setup.sh | bash
  3. Увійдіть у нову інсталяцію
  4. Перейдіть до Admin → Data → Restore → завантажте резервну копію
  5. Оновіть запис DNS, щоб він вказував на IP нового сервера
  6. Оновіть Redirect URI у Tesla Developer Portal, якщо ваш домен змінився

Нічне обслуговування (автоматично)

Tesla Carview виконує автоматичне завдання обслуговування щовечора о 03:30 (Берлінський часовий пояс):

  • Видаляє прострочені токени та осиротілі записи
  • Контрольна точка WAL (оптимізація SQLite)
  • VACUUM — повертає дисковий простір, якщо база даних перевищує 50 МБ
  • Якщо AUTO_UPDATE_ENABLED=true: завантажує останній код і перезапускається

Ви можете запустити це вручну:

  • Admin → System → Run Maintenance Now

Або переглянути журнал обслуговування:

  • Admin → System → Maintenance Log

Найкращі практики резервного копіювання

  • Правило 3-2-1: 3 копії, 2 різних типи сховища, 1 поза сайтом
  • Тестуйте резервні копії, фактично відновивши одну (використовуйте функцію Admin → Restore test)
  • Зберігайте резервну копію вашого .env файлу окремо та надійно (він містить облікові дані)
  • Робіть резервну копію перед будь-яким великим оновленням або зміною конфігурації