UK Installation - KnevS/Tesla-Carview GitHub Wiki
Інструкція з встановлення
🤖 Цей український переклад створений з AI-підтримкою з англійського оригіналу. Виправлення приймаються на GitHub.
🌐 Мова: EN · DE · FR · ES · TR · EL · UK
Потрібен час: ~30 хвилин | Складність: дружня до новачків
Ця інструкція проведе вас через повне встановлення Tesla Carview з нуля.
Що вам потрібно перед початком
Перш ніж торкатися будь-яких команд, переконайтеся, що ви маєте:
- Linux-сервер, VPS або Raspberry Pi (див. варіанти обладнання нижче)
- Доменне ім'я, що вказує на ваш сервер — АБО плани використовувати DynDNS / Cloudflare Tunnel (→ Доступ через мережу)
- Обліковий запис Tesla Developer (→ Налаштування Tesla API)
- SSH-доступ до вашого сервера (або клавіатура + екран на Pi)
Варіанти обладнання
Варіант 1: Raspberry Pi (домашній сервер)
Найкраще для: особистого використання вдома, низька вартість (~€60–120 загалом)
| Модель | RAM | Рекомендоване сховище |
|---|---|---|
| Raspberry Pi 5 (рекомендовано) | 4 ГБ або 8 ГБ | NVMe SSD через M.2 HAT+ |
| Raspberry Pi 4 | 4 ГБ | USB SSD |
| Raspberry Pi 3 | 1 ГБ | більше не підтримується ¹ |
¹ Raspberry Pi 3 і старіші (32-бітний ARM) більше не підтримуються з v3.51.0: Node.js не публікує образи ARMv7 починаючи з версії 24.
⚠️ Важливо: Не використовуйте SD-карту для постійної роботи. Вона вийде з ладу за кілька місяців під навантаженням записів Tesla Carview. Див. Сховище Raspberry Pi для виправлення за 20 хвилин.
Варіант 2: VPS у хостинг-провайдера
Найкраще для: доступності 24/7, відсутності обладнання для керування, легкого налаштування
| Провайдер | Місячна вартість | Примітки |
|---|---|---|
| Hetzner CX22 | ~€4.35 | Рекомендовано, дуже надійний |
| netcup VPS 1000 | ~€4.44 | Німецькі дата-центри |
| Contabo VPS S | ~€5.99 | Багато сховища |
VPS має фіксовану публічну IP-адресу — налаштування DynDNS не потрібне.
Крок 1: Підготуйте сервер
Підключіться до вашого сервера через SSH (або відкрийте термінал на Pi):
ssh root@YOUR-SERVER-IP
Переконайтеся, що система оновлена:
apt update && apt upgrade -y
Крок 2: Отримайте домен, що вказує на ваш сервер
Tesla Carview вимагає HTTPS (Tesla API працює лише через захищені з'єднання). Це означає, що вам потрібен домен з дійсним SSL-сертифікатом.
У мене VPS з фіксованим IP: → Перейдіть до вашого реєстратора доменів і створіть запис A:
tesla.yourdomain.com → A → YOUR-VPS-IP
Зачекайте 5–30 хвилин на розповсюдження DNS, потім продовжуйте.
Я вдома без фіксованого IP: → Див. Доступ через мережу — спочатку налаштуйте DynDNS або Cloudflare Tunnel, потім поверніться сюди.
У мене взагалі немає домену:
→ Отримайте безкоштовний піддомен на DuckDNS.org (напр. my-tesla.duckdns.org) — це безкоштовно і працює з Let's Encrypt.
Крок 3: Запустіть скрипт налаштування
Ця одна команда завантажує та запускає інтерактивного майстра налаштувань:
curl -fsSL https://raw.githubusercontent.com/KnevS/Tesla-Carview/main/deploy/setup.sh | bash
Майстер ставить вам серію запитань:
| Питання | Що ввести |
|---|---|
| Доменне ім'я | tesla.yourdomain.com або my-tesla.duckdns.org |
| Ім'я адміна | Будь-яке ім'я (напр. ваше ім'я, admin) |
| Пароль адміна | Сильний пароль (мін. 12 символів) |
| Назва орендаря | Як назвати вашу інсталяцію (напр. "My Tesla") |
| Увімкнути HTTPS | Так (завжди — необхідно для Tesla API) |
Скрипт запитує режим розгортання перед тим, як щось робити:
| Режим | Коли використовувати |
|---|---|
| 1 — Direct | Виділена VM або VPS без наявного проксі — nginx + certbot встановлюються та налаштовуються автоматично |
| 2 — Proxy | Вже запущений nginx, Caddy, Traefik або налаштування WireGuard+VPS — встановлення nginx повністю пропускається |
У режимі Proxy додайте це до вашої наявної конфігурації проксі:
proxy_pass http://127.0.0.1:8080;
Потім скрипт автоматично (режим Direct):
- Встановлює Docker, nginx, certbot, fail2ban
- Отримує SSL-сертифікат Let's Encrypt для вашого домену
- Налаштовує nginx з заголовками безпеки
- Запускає всі Docker-контейнери
- Налаштовує базу даних
Це займає 5–10 хвилин.
Крок 4: Перший вхід
Відкрийте ваш браузер і перейдіть на https://tesla.yourdomain.com
Ви маєте побачити сторінку входу Tesla Carview. Введіть ім'я користувача та пароль адміна, які ви встановили в Кроці 3.
💡 Підказка: Поставте галочку "Stay signed in (90 days)" на сторінці входу, щоб не доводилося вводити пароль щоразу — особливо корисно при доступі з браузера Tesla.
Крок 5: Підключіть ваш обліковий запис Tesla
Після входу ви побачите підказку налаштування для підключення вашого облікового запису Tesla. Дотримуйтесь інструкцій у Налаштування Tesla API.
Крок 6: Готово!
Ваша інсталяція Tesla Carview працює. Застосунок почне опитувати дані вашого автомобіля автоматично.
Що робити далі:
- Налаштуйте ваш автомобіль → Dashboard → Add Vehicle
- Налаштуйте сповіщення → Settings → Push Notifications
- Запросіть членів родини → Admin → Users → Invite
- Налаштуйте локацію заряджання → Settings → Charging Locations
Оновлення
Tesla Carview може оновлюватися автоматично. Увімкніть це в налаштуваннях:
# У /opt/tesla-carview/backend/.env:
AUTO_UPDATE_ENABLED=true
Або оновіть вручну:
cd /opt/tesla-carview
git pull
docker compose -f docker-compose.prod.yml up -d --build
Усунення проблем встановлення
"Permission denied" при запуску скрипту
→ Переконайтеся, що ви запускаєте як root. Запустіть спочатку sudo su.
"Domain not found" під час certbot
→ Ваш DNS ще не розповсюдився. Зачекайте 10–30 хвилин і спробуйте знову. Перевірте за допомогою: nslookup tesla.yourdomain.com
Контейнери не запускаються
→ Перевірте журнали: docker compose -f /opt/tesla-carview/docker-compose.prod.yml logs
Більше допомоги → Усунення несправностей | Відкрити Issue
Windows-ПК замість сервера (від v3.53.0)
Застосунок повністю працює в Linux-контейнерах — Windows лише хост. З Docker Desktop у режимі WSL2 запускається той самий стек. Скрипт deploy/setup.sh там не працює (bash, apt, systemd, certbot); замість нього є deploy\setup-windows.ps1.
git clone https://github.com/KnevS/Tesla-Carview.git
cd Tesla-Carview
powershell -ExecutionPolicy Bypass -File .\deploy\setup-windows.ps1
Два обмеження, обидва виміряні: команди до автомобіля не працюють (tesla-http-proxy потребує Linux bind-mount і фіксованого UID), а хто все ж запускає проксі, має задати TESLA_PROXY_BASE — у Docker Desktop host.docker.internal вказує на шлюз хоста, а не на контейнер проксі. Усе, що на читання, працює повністю.
Windows не перевіряється в CI. Повний опис: docs/02-deployment.uk.md, розділ «Windows (Docker Desktop)».