מדריך התקנה

איך לחבר את HedgieMate לשרת ה-TeslaMate שלך

דרישות מוקדמות

1

דרישות מערכת

HedgieMate עובדת עם התקנת ה-TeslaMate הקיימת שלך. לגישה מרחוק תצטרך:

  • התקנת TeslaMate פעילה, או השירות MyTeslaMate
  • בלי גישה מרחוק, HedgieMate עובדת רק ברשת המקומית שלך
  • אפשר להשתמש בדומיין עם מנהרת Cloudflare Zero Trust, בכתובת IP ציבורית או בפתרון VPN (Tailscale, OpenVPN ואחרים)

התקנת ה-API של TeslaMate

2

התקנת TeslaMate API

HedgieMate צריכה את ה-API של TeslaMate כדי לעבוד. יש להתקין אותו על אותו שרת שבו TeslaMate פועל.

הוראות מפורטות נמצאות בTeslaMate API ב-GitHub.

הוסף את השירות הזה לקובץ docker-compose.yml הקיים של TeslaMate, ועדכן את משתני הסביבה כך שיתאימו לתצורת ה-TeslaMate הנוכחית שלך:

docker-compose.yml
... existing TeslaMate docker-compose configuration ...

services:
  teslamateapi:
    image: tobiasehlert/teslamateapi:latest
    restart: always
    depends_on:
      - database
    environment:
      - ENCRYPTION_KEY=MySuperSecretEncryptionKey
      - DATABASE_USER=teslamate
      - DATABASE_PASS=secret
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
      - MQTT_HOST=mosquitto
      - TZ=Europe/Berlin
    ports:
      - 8080:8080

לתשומת לבך: MQTT_HOST חייב להצביע על אותו ברוקר MQTT שבו TeslaMate משתמש. העתק את הערך מתצורת ה-Docker של TeslaMate הקיימת שלך.

הגדרת גישה מבחוץ (אופציונלי)

3

הגדרת גישה מבחוץ

אל תחשוף את ה-API של TeslaMate כלפי חוץ בלי אימות ראוי. גישה לא מורשית עלולה לפגוע בפרטיות ובאבטחה שלך.

לגישה מרחוק ל-API של TeslaMate, אלה כמה אפשרויות מאובטחות שכדאי לשקול:

פתרונות מומלצים

אפשרות 1: פתרונות VPN

אפשרות 2: פרוקסי הפוך עם אימות

אפשרות 3: Cloudflare Zero Trust (דורש דומיין)

  • Cloudflare Zero Trust מנהרה מאובטחת עם אימות באמצעות Service Tokens (הכותרות CF-Access-Client-Id ו-CF-Access-Client-Secret), בלי צורך בכתובת IP ציבורית

אם אתה צריך עזרה בהגדרת גישה מאובטחת מבחוץ, פנה לצוות התמיכה שלנו.

התקנת ה-API של TeslaMate

2

שימוש בשירות MyTeslamate

MyTeslamate מציע חיבור מנוהל ל-API של TeslaMate, בלי שתצטרך להתקין דבר. פתח חשבון MyTeslamate אם עוד אין לך.

חשוב: מאז העדכון האחרון של MyTeslamate, אימות נדרש תמיד. השתמש ב-image ‎tobiasehlert/teslamateapi:latest‎ ובחר Basic Auth.

  1. ב-MyTeslamate, עבור למקטע Add-on
  2. הפעל את Connectivity: TeslaMate API & MQTT ובחר את ה-image ‎tobiasehlert/teslamateapi:latest
  3. לאימות, בחר Basic Auth
  4. העתק את כתובת ה-Endpoint, את שם המשתמש ואת הסיסמה או הטוקן
  5. ב-HedgieMate, הדבק את ה-Endpoint ככתובת ה-API, את שם המשתמש של MyTeslamate בשדה שם משתמש ואת הסיסמה או הטוקן בשדה סיסמה
  6. נתקעת? שלח לנו מייל ל-[email protected] ונעזור לך.

שמור על כתובת ה-Endpoint, שם המשתמש והסיסמה או הטוקן. אל תשתף אותם בפומבי, הם נותנים גישה מלאה לנתוני ה-TeslaMate שלך.

הגדרת HedgieMate

4

הורדת HedgieMate

התקן את HedgieMate מ-App Store במכשיר ה-iOS שלך.

להורדה מ- App Store
5

הגדרת כתובת ה-API של TeslaMate

ב-HedgieMate, הזן את כתובת ה-API של TeslaMate שלך:

  • גישה מבחוץ https://your-domain.co.il (אם אתה משתמש ב-Cloudflare Zero Trust)
  • כתובת IP עם פורט https://your-ip:8080
  • רשת מקומית http://192.168.1.xxx:8080

הכתובת צריכה להצביע על שירות ה-API של TeslaMate שפועל בפורט 8080.

6

בדיקת החיבור

בדוק את החיבור, טען את הרכבים שלך והתחל לחקור את נתוני ה-Tesla שלך עם הניתוח המורחב והתובנות ש-HedgieMate מספקת.

צריך עזרה?

ההתקנה לא מתקדמת כמצופה? נשמח לעזור לך להתחיל.