⚡ تثبيت TeslaMate — تسجيل بيانات وتحليلات سيارات تسلا ولوحات Grafana على Docker

نشر منصة TeslaMate على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لتسجيل بيانات سيارات تسلا وتحليل كفاءة الشحن وتدهور البطارية عبر لوحات Grafana على المنفذ 4321.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر TeslaMate على المنفذ 4321 مع قاعدة بيانات PostgreSQL ووسيط Mosquitto MQTT ولوحات Grafana جاهزاً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/teslamate/teslamate-ubuntu.sh
chmod +x teslamate-ubuntu.sh
sudo bash teslamate-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/teslamate/teslamate-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x teslamate-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات قاعدة البيانات وMQTT (`./teslamate-db` و`./mosquitto-data`) وتوليد مفاتيح التشفير وتشغيل TeslaMate على المنفذ 4321 (المحول من 4000 الداخلي).

sudo bash teslamate-ubuntu.sh

4 تسجيل الدخول بتوكنات حساب تسلا

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:4321. سجل الدخول بتوكنات API الخاصة بحساب تسلا، وتأكد من اتصال السيارة، واستعرض أكثر من 30 لوحة تحكم Grafana لتتبع الرحلات والشحن وصحة البطارية.

http://<your-server-ip>:4321

المنافذ المستخدمة

المنفذالغرض
4321Web UI (host → container 4000) — sign in with Tesla on first visit
PostgreSQL + MQTTInternal — your data, plus a bundled Mosquitto broker
encryption keyGenerated — protects your Tesla tokens; back it up

نظرة عامة

تعد TeslaMate المنصة مفتوحة المصدر الرائدة عالمياً لتسجيل وتحليل وتتبع بيانات سيارات تسلا الكهربائية (Model S و3 وX وY وCybertruck). تعمل المنصة عبر المنفذ 4321 (المحول من 4000 الداخلي) بالاعتماد على قاعدة بيانات PostgreSQL ووسيط Mosquitto MQTT ولوحات Grafana الجاهزة، لتسجل كافة تفاصيل السيارة دون منعها من الدخول في وضع السكون الموفر للطاقة. وتوفر تحليلات عميقة لكفاءة القيادة، ومنحنيات سرعة الشحن، والاستهلاك أثناء الوقوف (Phantom Drain)، وصحة وسعة البطارية مع التكامل مع Home Assistant.

لماذا تستخدمه

تفرض خدمات تتبع تسلا السحابية التجارية (مثل TeslaFi وTessie) اشتراكات شهرية متكررة، وتخزن سجلات مواقعك الجغرافية الحساسة على خوادمها، وقد تتسبب في استنزاف بطارية السيارة بالاستعلام المتكرر. تمنحك TeslaMate تتبعاً خاصاً ومحمياً بنسبة 100%: سجل كافة مشاويرك وجلسات الشحن وصحة البطارية بدون أي اشتراكات، مع ميزة السكون الذكي لمنع استنزاف البطارية، وسيادة كاملة لبياناتك على سيرفرك الخاص.

متى تحتاجه

  • تمتلك سيارة تسلا وتريد تسجيلاً تلقائياً وتفصيلياً لكافة الرحلات وجلسات الشحن وفترات التوقف
  • تريد خصوصية رقمية تامة لبيانات تنقلاتك ومواقعك الجغرافية دون مشاركتها مع شركات التتبع السحابية
  • تحتاج إلى تحليلات عميقة لصحة البطارية: قياس معدل تدهور السعة، وكفاءة الشحن، ودرجات حرارة الخلايا
  • تريد حساب تكلفة الشحن الحقيقية في المنزل ومحطات Supercharger بدقة وفقاً لتعريفات الكهرباء المنزلية
  • تريد بث حالة السيارة اللحظية إلى Home Assistant عبر بروتوكول MQTT لتشغيل أتمتة المنزل الذكي

من يحتاجه

  • مالكو سيارات تسلا الراغبون في رؤية تفصيلية لأداء سياراتهم، وصحة البطارية، وكفاءة الاستهلاك مدى الحياة
  • عشاق السيارات الكهربائية لتحليل تأثير الطقس والسرعة والارتفاع وضغط الإطارات على المدى الحقيقي
  • مستخدمو المنازل الذكية لأتمتة شحن السيارة تلقائياً عند وجود فائض طاقة من الألواح الشمسية عبر MQTT
  • مديرو أساطيل السيارات لتتبع سيارات تسلا التابعة للشركة، وحساب الكيلومترات، ومستحقات تكاليف الشحن
  • أصحاب السيرفرات المنزلية لدمج بيانات سياراتهم داخل منظومة لوحات Grafana الموحدة على Ubuntu

حالات الاستخدام الشائعة

  • تتبع منحنى تدهور بطارية السيارة عبر 100,000 كم للتحقق من شروط ضمان البطارية
  • تسجيل رحلة سفر بطول 2,000 كم بخريطة تفاعلية توضح تغيرات الارتفاع ومنحنيات سرعة شواحن Supercharger
  • تشغيل أتمتة في Home Assistant لفتح باب الكراج وتشغيل إضاءة الممر فور وصول السيارة للمنزل
  • حساب تكلفة الشحن الشهرية الدقيقة مع فصل شحن المنزل البطيء AC عن شواحن الطرق السريعة DC
  • مراقبة الفقد في طاقة البطارية أثناء السفر وترك السيارة بالمطار لضمان بقائها في وضع السكون العميق

الميزات الرئيسية

  • أكثر من 30 لوحة Grafana مجهزة مسبقاً: الرحلات، والشحن، والإحصائيات الشاملة، والبطارية، والمواقع المزارة
  • اكتشاف السكون الذكي: احترام وضع سكون السيارة لمنع استنزاف بطارية الـ 12V وبطارية الجهد العالي
  • خرائط GPS عالية الدقة: تسجيل مسار المشاوير مع التضاريس وخريطة حرارية للسرعة واستهلاك الطاقة
  • تحليلات شحن متقدمة: قياس قدرة الشحن (كيلوواط)، والفولت، والأمبير، ودرجة حرارة البطارية، وكفاءة التحويل
  • تكامل مع وسيط MQTT: بث البيانات الحية إلى Home Assistant وNode-RED وأنظمة إنترنت الأشياء
  • دعم سيارات متعددة: مراقبة أكثر من سيارة تسلا في نفس الوقت بحساب واحد داخل TeslaMate
  • تشفير التوكنات بمفاتيح قوية: حماية توكنات حساب تسلا بتشفير AES عالي الأمان
  • معمارية Docker Compose تجمع TeslaMate مع قاعدة بيانات PostgreSQL وMQTT ولوحات Grafana

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:4321 لعرض واجهة TeslaMate
  • استخرج توكنات حساب تسلا عبر تطبيق توليد توكنات موثوق (مثل Auth app for Tesla) وسجل الدخول
  • تأكد من ظهور حالة سيارتك كـ 'Online' أو 'Asleep'
  • افتح رابط لوحات Grafana لاستعراض التقارير الجاهزة (الرحلات، والشحن، وصحة البطارية)
  • اضبط أسعار الكهرباء لموقع منزلك ومكان عملك في إعدادات المناطق الجغرافية (Geo-fences)
  • ضع TeslaMate وGrafana خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع حمايتهما بكلمة مرور
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./teslamate-db`

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: لا تكشف المنفذ 4321 أو لوحات Grafana للإنترنت العام مباشرة دون تشفير وكلمة مرور؛ حيث يمكن كشف موقع سيارتك اللحظي للعامة
  • احتفظ بنسخة آمنة من مفتاح التشفير `ENCRYPTION_KEY` في مدير كلمات المرور؛ فبدونه لا يمكن فك تشفير التوكنات بالنسخ الاحتياطية
  • استخدم توكنات للقراءة فقط إن أمكن، وألغِ التوكنات فوراً إذا شككت في اختراق سيرفرك
  • لا تشارك ملفات النسخ الاحتياطي لقاعدة البيانات علناً، لأنها تحتوي على إحداثيات منزلك ومشاويرك بالتفصيل
  • احمِ مجلد البيانات `./teslamate-db` بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وتوافقية الـ API مع تسلا

المنافذ وإعدادات جدار الحماية

يقدم TeslaMate واجهة الويب عبر منفذ TCP 4321 (المحول من 4000 الداخلي) ولوحات Grafana على المنفذ 3000. اسمح بالمنفذ 4321 للشبكة المحلية (`ufw allow 4321/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع مصادقة بكلمة مرور وأبقِ منافذ قاعدة البيانات وMQTT مغلقة خارجياً.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./teslamate-db` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL وسجلات المشاوير والشحن
  • احتفظ بنسخة من قيمة `ENCRYPTION_KEY` الموجودة في ملف المتغيرات `.env`
  • استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec teslamate-db pg_dump -U teslamate teslamate > teslamate_backup.sql`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync

الأخطاء الشائعة

  • كشف المنفذ 4321 للإنترنت العام بدون كلمة مرور، مما يتيح لأي شخص بالإنترنت تتبع موقع سيارتك بالـ GPS
  • فقدان مفتاح التشفير `ENCRYPTION_KEY`، مما يجعل استرجاع أو نقل قاعدة البيانات إلى سيرفر آخر مستحيلاً
  • عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب فقدان سجلات المشاوير التاريخية عند تحديث الحاوية
  • ضبط فترات استعلام عدوانية تمنع السيارة من الدخول في وضع السكون مما يسبب استنزاف البطارية (Vampire Drain)
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر عند الوصول عن بُعد

استكشاف الأخطاء وإصلاحها

  • السيارة تظهر كـ 'Offline' أو لا تدخل في وضع السكون — راجع إعدادات السكون (Time to Fall Asleep = 21 دقيقة) وتأكد من عدم وجود تطبيقات أخرى تستعلم من الـ API
  • التوكن منتهي الصلاحية أو غير صالح — أعد توليد التوكنات عبر تطبيق توليد توكنات تسلا وحدثها بالواجهة
  • لوحات Grafana لا تعرض بيانات — تأكد من عمل حاوية PostgreSQL واستقرارها بالأمر `docker compose ps`
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs teslamate -f`
  • رسائل MQTT لا تصل لـ Home Assistant — راجع منفذ حاوية Mosquitto وبيانات الدخول في Home Assistant

البدائل

تطبيق Tessie السحابي التجاري. موقع TeslaFi الكلاسيكي. إضافة Tesla الرسمية لـ Home Assistant. تطبيق EEVEE لمتابعة شحن السيارات. منصة Tronity لإدارة أساطيل السيارات الكهربائية.

متى لا تستخدمه

تجنب استخدام TeslaMate إذا كنت لا تمتلك سيارة تسلا (حيث صُمم خصيصاً لواجهات تسلا البرمجية). وإذا كنت تفضل تطبيق هاتف جاهزاً ومداراً بالكامل مع إشعارات سحابية بدون الحاجة لإدارة سيرفر Ubuntu أو Docker، فإن التطبيقات التجارية مثل Tessie توفر استضافة مدارة جاهزة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

هل يتسبب TeslaMate في استنزاف بطارية سيارتي (Phantom Drain)؟

لا! صُمم TeslaMate بنظام ذكي لاكتشاف سكون السيارة، فعند توقف السيارة يوقف البرنامج الاستعلام مؤقتاً ليتيح لكمبيوتر السيارة الدخول في وضع السكون العميق (Deep Sleep) وتجنب استنزاف البطارية.

كيف أقوم بتوليد توكنات حساب تسلا لـ TeslaMate؟

نظراً لاعتماد تسلا على المصادقة الثنائية وOAuth2، استخدم تطبيقاً موثوقاً ومفتوح المصدر (مثل 'Auth app for Tesla' على iOS/Mac أو 'Tesla Tokens' على أندرويد) لتوليد التوكنات، ثم الصقها في صفحة تسجيل الدخول بـ TeslaMate.

ما هي البيانات التي يسجلها TeslaMate؟

يسجل TeslaMate كل مشوار (مسار الـ GPS، والسرعة، والارتفاع، واستهلاك الطاقة)، وكل جلسة شحن (منحنى الشحن، والقدرة بالكيلوواط، والفولت، والتكلفة)، وتدهور البطارية عبر الزمن، وتحديثات النظام، وحالات السكون.

هل يمكن ربط TeslaMate بنظام Home Assistant؟

نعم! يتضمن TeslaMate وسيط Mosquitto MQTT مدمجاً يبث بيانات السيارة الحية (نسبة الشحن، وحالة القيادة، والموقع، والتكييف) مباشرة إلى Home Assistant لتشغيل سيناريوهات المنزل الذكي.

كم يستهلك TeslaMate من الذاكرة العشوائية (RAM)؟

تستهلك حزمة TeslaMate بالكامل (تطبيق Elixir وقاعدة PostgreSQL ووسيط MQTT ولوحات Grafana) ما بين 250 إلى 500 ميجابايت من الذاكرة العشوائية داخل Docker.