يُعدّ ملف Compose المصدر مفيدًا كمثال على مسار ZimaOS، لكنه لم يُؤكَّد قط من قِبل صاحب المنشور الأصلي، ولا ينبغي اعتماده بوصفه حزمة TeslaMate الحالية. ولا تزال وثائق Docker المُصانة الخاصة بـ TeslaMate تستخدم نشرًا متعدد الحاويات عبر Compose، وتوصي صراحةً بتشغيل الخدمة على جهاز يعمل دائمًا مع الاحتفاظ الدائم بحالة قاعدة البيانات وGrafana.
كما تؤكد إرشادات المنبع الحالية أهمية الأمان، لأن TeslaMate يخزّن رموز Tesla المميزة لواجهة API. أبقِ الخدمة على شبكة منزلية موثوقة، أو ضع الوصول عن بُعد خلف VPN أو Tailscale أو Cloudflare Tunnel أو وكيل عكسي مُحصَّن، بدلًا من نشر واجهة الويب الخام مباشرةً.
تحقّق من متطلبات TeslaMate الحالية
تسرد وثائق TeslaMate الحالية ما يلي:
- Docker/Compose؛
- مضيف يعمل دائمًا؛
- ذاكرة وصول عشوائي لا تقل عن 1 غيغابايت للتثبيت، مع التوصية بـ 2 غيغابايت؛
- وصول إلى الإنترنت لخدمات Tesla؛
- أجهزة بمعمارية amd64 أو arm64.
راجع تثبيت TeslaMate الحالي عبر Docker.
نقل المصدر البيانات الدائمة بشكل صحيح إلى /DATA/AppData
كان ملف Compose المجتمعي يخزّن بيانات Postgres وGrafana وبيانات الاستيراد ضمن مجلدات AppData مخصصة في ZimaOS. ويُعد ذلك تكييفًا سليمًا مع المنصة، إذ ينبغي أن تستمر حالة الحاوية خارج نظام ملفات الحاوية القابل للاستبدال.
احمِ قاعدة بيانات PostgreSQL
تحتوي قاعدة بيانات TeslaMate على بيانات المركبة التاريخية وحالة التطبيق. أنشئ نسخة احتياطية منها قبل ترقية الصور أو إجراء تغييرات كبيرة على Compose.
لا تضع دليل بيانات Postgres الحي على مشاركة شبكة غير موثوقة، ولا تحذفه عند تنظيف الحاويات.
استخدم ENCRYPTION_KEY قويًا
يستخدم TeslaMate مفتاح التشفير لحماية رموز Tesla المميزة المخزّنة لواجهة API. وتقول قيمة العنصر النائب في المصدر «بعض الملح للتشفير»؛ استبدلها بسر عشوائي قوي، واحتفظ به بعيدًا عن لقطات الشاشة العامة أو منشورات المنتديات.
استخدم كلمة مرور قوية ومتسقة لقاعدة البيانات
يشير المصدر بشكل صحيح إلى ضرورة تطابق كلمة مرور قاعدة البيانات بين إعدادات Postgres وTeslaMate وGrafana. وقد يبدو عدم التطابق مشكلة في بدء تشغيل التطبيق، رغم أن الحاويات نفسها تعمل.
عطّل المصدر MQTT؛ لكن المنبع الحالي يضمّنه في الحزمة القياسية
عيّن ملف Compose المجتمعي DISABLE_MQTT=true. أما إرشادات Docker الحالية الخاصة بـ TeslaMate فتضم Mosquitto في المثال القياسي. يظل MQTT اختياريًا بحسب عمليات التكامل، لكن ينبغي للمستخدمين الحاليين اتباع حزمة المنبع التي يحتاجون إليها فعليًا، بدلًا من اعتماد تبسيط عام 2025 تلقائيًا.
أمّن Grafana أيضًا
عيّن المصدر الوصول المجهول إلى Grafana على القيمة true. قد يكون ذلك مريحًا على شبكة محلية خاصة، لكنه يعرّض لوحات المركبات لأي شخص يستطيع الوصول إلى المنفذ. وللوصول عن بُعد، استخدم المصادقة ومسار شبكة محميًا.
حدّث الحزمة كاملةً بعناية
قبل الترقية، أنشئ نسخة احتياطية من قاعدة البيانات، وراجع ملاحظات إصدار TeslaMate، واسحب الصور الجديدة، وأعد إنشاء الحزمة، ثم تحقّق من جمع بيانات Tesla ومن لوحات Grafana بعد ذلك.
الأسئلة الشائعة حول TeslaMate على ZimaOS
هل أكد صاحب المنشور الأصلي نجاح Compose المجتمعي؟
لا. قال إنه سيجرّبه، لكن الموضوع لا يتضمن أي نتيجة.
ما البيانات التي يجب أن تستمر؟
يجب على الأقل الحفاظ على قاعدة بيانات TeslaMate/Postgres وحالة Grafana، إضافةً إلى حماية أي بيانات مستوردة أو مُهيّأة أخرى.
هل ينبغي تعريض TeslaMate مباشرةً للإنترنت العام؟
توصي إرشادات TeslaMate الحالية باتصال آمن مثل VPN أو Cloudflare Tunnel أو Tailscale أو ZeroTier أو وكيل عكسي مُحصَّن.
