מדריך התקנה

התקנת TeslaMate API

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

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

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

... 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 הקיימת שלך.

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

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

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

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

• Tailscale VPN בלי הגדרות, הקל ביותר להתקנה, בלי צורך בכתובת IP ציבורית
  מדריך התחלה מהירה
• ZeroTier רשת מוגדרת בתוכנה, בלי צורך בכתובת IP ציבורית
  מדריך התקנה
• WireGuard פרוטוקול VPN מודרני ומהיר
  התחלה מהירה
• OpenVPN VPN מנוסה עם תמיכה רחבה

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

• Caddy Server עם Basic Auth HTTPS אוטומטי, הגדרה פשוטה
  תיעוד Basic Auth
• Nginx עם Basic Auth תקן התעשייה לפרוקסי הפוך
  מדריך התקנה
• Traefik עם Middleware לאימות מודרני ומתאים ל-Docker
  Middleware לאימות

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

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

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