📡 تثبيت evcc — تحكم شحن مركبات كهربائية واعٍ بالطاقة الشمسية

انشر evcc على Ubuntu بـ Docker — أداة تحكم شحن مركبات كهربائية مفتوحة المصدر تُحسّن الشحن حسب إنتاجك الشمسي وأسعار الكهرباء، على المنفذ 7070. تبدأ في وضع تجريبي.

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

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

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

سكريبت تثبيت آلي — ينشر evcc على المنفذ 7070 في وضع تجريبي حتى تستطيع استكشاف الواجهة. للتحكم بعتاد حقيقي، استبدل علامة demo بملف evcc.yaml يصف نقطة الشحن والألواح الشمسية والمركبة لديك.
عرض على GitHub

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

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

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

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

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

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

chmod +x evcc-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم الأمر ويشغّل evcc على المنفذ 7070 مع علامة --demo، فيعمل ببيانات محاكاة وتستطيع استكشاف الواجهة. بياناته موجودة في وحدة تخزين مرتبطة. للاستخدام الحقيقي توفّر ملف evcc.yaml.

sudo bash evcc-ubuntu.sh

4 فتح واجهة الويب (تجريبية) وتخطيط إعداداتك

افتح evcc لاستكشاف لوحة المعلومات التجريبية، ثم استبدل علامة --demo بإعدادات evcc.yaml تصف نقطة الشحن ونظام الطاقة الشمسية والمركبة للتحكم بشحن حقيقي:

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

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

المنفذالغرض
7070Web UI (host = container)
--demoStarts in demo mode with simulated data
evcc.yamlReplace the demo flag with your own config for real hardware

نظرة عامة

evcc (أداة تحكم شحن مركبات كهربائية) منصة مفتوحة المصدر مكتوبة بلغة Go لشحن ذكي للمركبات الكهربائية. بدلاً من الشحن بأقصى طاقة فور توصيل السيارة، ينسّق evcc الشحن حسب ما هو منطقي فعلاً — يُعطي أولوية لفائض طاقتك الشمسية، ويتبع الساعات الرخيصة في تعرفة كهرباء ديناميكية، ويوازن مع ميزانية الطاقة الكلية لمنزلك حتى لا يُسبب الشحن قطع دائرة أو زيادة في فاتورتك. إنه محايد تجاه المُصنّعين، يتواصل مع نطاق واسع جداً من نقاط الشحن والعواكس وعدادات الطاقة الذكية والمركبات عبر ملف إعدادات YAML واحد.

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

يحوّل evcc شحن المركبات الكهربائية من عملية غبية بأقصى طاقة دائماً إلى شيء يستجيب فعلاً لوضعك الطاقي. إذا كان لديك ألواح شمسية، يستطيع تحويل الشحن لاستيعاب فائض إنتاج PV الذي كان سيُصدَّر بقيمة قليلة. إذا كنت على تعرفة كهرباء ديناميكية، يستطيع جدولة الشحن تلقائياً في أرخص الساعات. ولأنه محايد تجاه المُصنّعين بدلاً من الارتباط بتطبيق علامة تجارية واحدة، يعمل عبر نطاق ضخم من العتاد ويمنحك لوحة معلومات وواجهة برمجة واحدة بدلاً من التنقل بين تطبيقات مُصنّعين منفصلة لنقطة الشحن والعاكس والعداد لديك.

متى تحتاجه

  • لديك ألواح شمسية منزلية وتريد شحن مركبتك الكهربائية تفضيلياً من الفائض الإنتاجي بدلاً من الشبكة
  • أنت على تعرفة كهرباء ديناميكية أو حسب وقت الاستخدام وتريد جدولة الشحن تلقائياً في أرخص الساعات
  • تملك عتاد شحن مركبات كهربائية من مُصنّع لا يتكامل تطبيقه مع عاكسك الشمسي أو عدادك الذكي
  • تريد لوحة معلومات وواجهة برمجة واحدة للشحن بدلاً من التنقل بين تطبيقات منفصلة لنقطة الشحن والعاكس والمركبة
  • تحتاج موازنة شحن المركبة الكهربائية مع القدرة الكهربائية الكلية لمنزلك لتجنب قطع الدوائر أو تجاوز حد اتصال الشبكة

من يحتاجه

  • أصحاب المنازل ذوو الألواح الشمسية الذين يريدون تعظيم الاستهلاك الذاتي بشحن مركبتهم من فائض PV
  • مالكو المركبات الكهربائية على تعرفات كهرباء ديناميكية الذين يريدون شحناً تلقائياً خلال أرخص نوافذ الأسعار
  • مستخدمو Home Assistant والمنزل الذكي الذين يريدون دمج شحن المركبة الكهربائية ضمن أتمتة طاقتهم الأوسع
  • مالكو مركبات أو نقاط شحن متعددة يريدون إدارة شحن مركزية ومنسّقة بدلاً من تطبيقات لكل جهاز
  • مالكو المركبات الكهربائية المهتمون بالخصوصية الذين يفضلون أداة تحكم ذاتية الاستضافة ومحايدة تجاه المُصنّعين على تطبيق سحابي من مُصنّع
  • الكهربائيون والمُركّبون الذين يُعدّون أنظمة شحن ذكية لعملاء يحتاجون دعم عتاد محايد تجاه المُصنّعين

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

  • شحن مركبة كهربائية تلقائياً من فائض شمسي أثناء النهار بدلاً من السحب من الشبكة ليلاً
  • جدولة بدء الشحن فقط خلال أرخص ساعات تعرفة كهرباء بسعر لحظي ديناميكي
  • ضبط نسبة شحن مستهدفة ووقت مغادرة حتى تكون السيارة جاهزة بالضبط عند الحاجة وبأقل تكلفة
  • تنسيق شحن عدة مركبات كهربائية من اتصال منزلي واحد دون تجاوز سعة الشبكة المتاحة
  • دمج حالة والتحكم بشحن المركبة الكهربائية في لوحة معلومات Home Assistant أو Grafana لمراقبة الطاقة
  • استبدال تطبيق شحن أحادي المُصنّع بواجهة موحّدة تدير أيضاً تخزين البطارية ومضخات الحرارة

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

  • شحن من الفائض الشمسي يتبع تلقائياً إنتاج PV المتاح بدلاً من سحب طاقة كاملة من الشبكة
  • دعم تعرفة ديناميكية — يشحن خلال أرخص الساعات المتاحة عند الاتصال بخطة كهرباء بسعر لحظي
  • تكامل محايد تجاه المُصنّعين مع نطاق واسع جداً من نقاط الشحن والعواكس والعدادات الذكية والمركبات
  • دعم Modbus وHTTP وMQTT والبرمجة النصية المخصصة حتى يمكن عادة دمج العتاد غير المعتاد أو المصنوع يدوياً
  • تخطيط وقت المغادرة والنسبة المستهدفة حتى تُشحن المركبة بالضبط متى وبكم تحتاج
  • لوحة معلومات ويب وواجهة برمجة REST/MQTT للمراقبة والتحكم، بالإضافة لتكامل مع Home Assistant وGrafana
  • دعم مركبات ونقاط شحن متعددة مع إدارة أحمال للبقاء ضمن القدرة الكهربائية لمنزلك
  • مجتمع مفتوح المصدر نشط يصون تكاملات الأجهزة لشواحن وعواكس جديدة كلما صدرت

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

  • استكشف لوحة المعلومات التجريبية على المنفذ 7070 للتعرف على الواجهة قبل التعامل مع عتاد حقيقي
  • راجع قائمة الأجهزة المدعومة في evcc للتأكد من كيفية ضبط نقطة الشحن والعاكس والعداد والمركبة الخاصة بك
  • اكتب ملف evcc.yaml يصف عتادك — الشواحن، عاكس PV، البطارية، العدادات، والمركبة — لتستبدل علامة --demo
  • أعد تشغيل الحاوية مع ربط evcc.yaml بدلاً من الوضع التجريبي، وتحقق من ظهور قيم الأجهزة الحقيقية في لوحة المعلومات
  • اضبط استراتيجية الشحن — شمسي فقط، أو الحد الأدنى بالإضافة للشمسي، أو شحن سريع — لكل مركبة أو نقطة شحن
  • اضبط مزوّد تعرفة ديناميكية في الإعدادات إذا كانت خطة كهربائك بأسعار متغيرة، حتى يستطيع evcc الشحن خلال الساعات الرخيصة
  • اضبط أوقات المغادرة ومستويات الشحن المستهدفة لكل مركبة حتى تكون جاهزة عند الحاجة دون شحن زائد غير ضروري
  • اربط evcc بـ Home Assistant أو MQTT أو Grafana إذا أردت بيانات الشحن جنباً إلى جنب مع مراقبة طاقة منزلك الأوسع

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

  • لا تكشف المنفذ 7070 مباشرة للإنترنت أبداً — بمجرد ضبطه بعتاد حقيقي، فهو يتحكم بمعدات شحن فعلية
  • قيّد الوصول على شبكتك المحلية عبر ufw أو جدار حماية جهاز التوجيه، أو ضعه خلف VPN للوصول عن بُعد
  • إذا احتجت وصولاً عن بُعد لفحص أو التحكم بالشحن بعيداً عن المنزل، استخدم وكيلاً عكسياً مع TLS بدلاً من تمرير منفذ مباشر
  • احمِ ملف evcc.yaml بعناية لأنه يحتوي بيانات اعتماد واجهات برمجة عاكسك أو عدادك أو شاحنك
  • أبقِ evcc محدّثاً للحصول على إصلاحات أمنية وتحديثات توافق لتكاملات العتاد المدعوم
  • راجع أي التكاملات تكشف وصول كتابة (بدء/إيقاف الشحن) مقابل مراقبة للقراءة فقط، وقيّد وفقاً لذلك

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

يستمع evcc على المنفذ 7070 للوحة معلوماته الويب وواجهة برمجته، مع ربط منافذ المضيف والحاوية واحداً لواحد. في الوضع التجريبي يكشف هذا فقط بيانات محاكاة، لكن بمجرد ضبط عتاد حقيقي عبر evcc.yaml، يمنح نفس المنفذ تحكماً بمعدات شحن مركبتك الكهربائية الفعلية وعاكسك الشمسي وعداداتك — لذا يجب ألا يُكشف أبداً مباشرة للإنترنت العام. أبقِ المنفذ 7070 مقيداً على شبكتك المحلية عبر ufw أو جدار حماية جهاز التوجيه، وإذا احتجت فحص حالة الشحن أو تعديل الإعدادات بعيداً عن المنزل، ضع وكيلاً عكسياً مع TLS ومصادقة أمامه، أو اتصل عبر VPN مثل WireGuard بدلاً من تمرير المنفذ مباشرة.

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

  • انسخ ملف إعدادات evcc.yaml احتياطياً — يحتوي إعداد عتادك الكامل وبيانات الاعتماد واستراتيجية الشحن
  • انسخ وحدة التخزين المرتبطة احتياطياً، التي تخزّن تاريخ الشحن والإحصائيات وأي حالة محلية يحتفظ بها evcc
  • وثّق عناوين IP أو اتصالات تسلسلية لنقطة الشحن والعاكس والعداد لديك خارج الإعدادات لاستعادة أسرع
  • خزّن نسخة من مفاتيح واجهة برمجة مزوّد التعرفة أو بيانات الاعتماد بأمان وبشكل منفصل عن نسخة الإعدادات الرئيسية
  • تحكّم بإصدارات ملف evcc.yaml (باستثناء الأسرار) حتى تتمكن من تتبع تغييرات الإعدادات والتراجع عن الأخطاء
  • اختبر الاستعادة بتشغيل حاوية evcc جديدة بنسخة من evcc.yaml والتأكد من إعادة اتصال كل الأجهزة بشكل صحيح

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

  • إبقاء evcc يعمل في وضع --demo وافتراض أنه يتحكم بشحن حقيقي — الوضع التجريبي لا يلمس عتاداً فعلياً أبداً
  • كشف المنفذ 7070 للإنترنت بمجرد ضبط عتاد حقيقي، مما يمنح أي شخص يجده تحكماً بشحنك
  • تخطي قائمة الأجهزة المدعومة وتخمين سجلات Modbus أو نقاط نهاية واجهة البرمجة بدلاً من استخدام إعدادات موثقة
  • عدم ضبط مزوّد تعرفة ديناميكية بينما أنت فعلياً على خطة بسعر متغير، ففاتك معظم فائدة توفير التكلفة
  • تجاهل إعدادات إدارة الأحمال عند تشغيل عدة أجهزة عالية السحب، مما يُخاطر بقطع دوائر أو تجاوز حدود الشبكة
  • عدم نسخ evcc.yaml احتياطياً، وفقدان إعداد عتاد واستراتيجية شحن ضُبطا بعناية إذا أُعيد بناء الحاوية
  • افتراض أن الشحن من الطاقة الشمسية فقط يعمل جيداً دون التحقق أولاً من قراءة بيانات إنتاج عاكسك الشمسي اللحظية بشكل صحيح

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

  • لوحة المعلومات لا تُظهر بيانات حية بعد مغادرة الوضع التجريبي — تحقق أن evcc.yaml مرتبط بشكل صحيح وأن الحاوية أُعيد تشغيلها، وليس فقط أُعيد ضبطها حياً
  • نقطة الشحن غير مكتشفة أو لا تبدأ الشحن — تحقق مرة أخرى من عنوان Modbus/HTTP وإعدادات البروتوكول مقابل توثيق الأجهزة المدعومة في evcc لطرازك
  • قيم الإنتاج الشمسي تبدو خاطئة — تأكد أن تكامل العاكس أو العداد يقرأ السجل أو نقطة نهاية واجهة البرمجة الصحيحة، وليس قيمة مخزنة مؤقتاً أو تجريبية
  • أسعار التعرفة الديناميكية لا تُحدَّث — تحقق أن مفتاح واجهة برمجة مزوّد التعرفة صالح وأن المزوّد مضبوط بشكل صحيح في evcc.yaml
  • الشحن لا يتوقف عند النسبة المستهدفة — تحقق أن تكامل المركبة يُبلّغ حالة الشحن بشكل صحيح؛ بعض المركبات تُحدّث SoC دورياً فقط
  • إدارة الأحمال لا تحدّ السحب الكلي كما هو متوقع — راجع حدود طاقة الموقع المضبوطة وتأكد أن كل العدادات ذات الصلة موصولة بشكل صحيح في الإعدادات
  • واجهة الويب غير قابلة للوصول بعد إعادة التشغيل — تحقق من سجلات الحاوية بحثاً عن أخطاء صيغة YAML في evcc.yaml، التي تمنع evcc من البدء

البدائل

openWB هو المشروع الذي استوحى منه evcc أصلاً — حل ألماني أكثر تكاملاً وغالباً مرفق بعتاد خاص ببرمجيات مدمجة، رغم أن evcc يستطيع فعلياً العمل أصلياً على عتاد OpenWB Series 2 كبديل برمجي. تطبيقات المُصنّعين (Tesla وWallbox وgo-e وKEBA وغيرها) تعمل جيداً داخل منظومتها الخاصة لكنها نادراً ما تتكامل مع عاكس أو عداد من مُصنّع مختلف، مما يحصرك بعلامة تجارية واحدة. لدى Home Assistant تكاملات شحن مركبات كهربائية ويستطيع بناء أتمتة مشابهة بمحرك الأتمتة الخاص به، لكنه يفتقر لمنطق تحسين الفائض الشمسي والتعرفة المصمم خصيصاً في evcc جاهزاً. لأداة تحكم ذاتية الاستضافة ومحايدة تجاه المُصنّعين تركّز تحديداً على شحن ذكي ومُحسّن التكلفة عبر نطاق ضخم من العتاد، يبقى evcc الخيار مفتوح المصدر الأنضج.

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

evcc ليس الأداة المناسبة إذا لم يكن لديك ألواح شمسية أو تعرفة كهرباء ديناميكية وتريد فقط شاحناً يعمل بجدول ثابت أو أقصى طاقة — تطبيق شاحنك الخاص أو مقبس مؤقت بسيط قد يكون أبسط من ضبط تكاملات أجهزة evcc. إذا لم يكن عتاد الشحن لديك في قائمة الأجهزة المدعومة من evcc ولا يملك واجهة Modbus أو HTTP أو MQTT للاتصال بها، فقد لا يكون التكامل ممكناً دون عمل إضافي كبير. وإذا لم تكن مرتاحاً لتحرير ملف إعدادات YAML واستكشاف أخطاء تكاملات الأجهزة بنفسك، فإن تطبيق مُصنّع مصقولاً وأحادي الغرض سيكون على الأرجح تجربة أسلس من إعداد evcc الأكثر تقنية وموجّه نحو الفعل الذاتي.

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

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

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

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

ما هو evcc؟

evcc (أداة تحكم شحن مركبات كهربائية) منصة مفتوحة المصدر لشحن ذكي للمركبات الكهربائية. بدلاً من الشحن بأقصى طاقة عند كل توصيل، يُحسّن الشحن حسب إنتاجك الشمسي وأسعار الكهرباء — يُعطي أولوية لفائض طاقة PV، ويتبع التعرفات الديناميكية، ويوازن مع ميزانية الطاقة الكلية لمنزلك.

لماذا يبدأ في وضع تجريبي؟

هذا النشر يُشغّل evcc بعلامة --demo فيعمل ببيانات محاكاة وتستطيع استكشاف الواجهة فوراً، قبل ربط عتاد حقيقي. الوضع التجريبي لا يتحكم بأي شيء فعلي. لإدارة شحن حقيقي تستبدل علامة --demo بملف evcc.yaml.

ما المنفذ الذي يستخدمه؟

يعمل evcc على المنفذ 7070 في المضيف. تصفّح هناك للوصول للوحة المعلومات. أبقه على شبكتك المحلية أو خلف VPN بدلاً من كشفه للإنترنت، لأنه بمجرد ضبطه يتحكم بعتاد شحن حقيقي ويقرأ بيانات طاقتك الحية. استخدم وكيلاً عكسياً مع TLS لأي وصول عن بُعد.

هل أحتاج طاقة شمسية لاستخدامه؟

الطاقة الشمسية هي حيث يتألق evcc، لكنها ليست مطلوبة بشكل صارم. أكبر فوائده تأتي من الشحن بفائض طاقة PV ومن توقيت الشحن من الشبكة في الساعات الرخيصة على تعرفة ديناميكية.

ما الشواحن والسيارات التي يدعمها؟

نطاق واسع جداً — evcc محايد تجاه المُصنّعين عن قصد ويدعم قائمة كبيرة ومتنامية من نقاط الشحن والعواكس والعدادات الذكية والمركبات من مُصنّعين عديدين. قبل الضبط، راجع قائمة الأجهزة المدعومة في evcc لعتادك المحدد لمعرفة كيفية إعداده في evcc.yaml.