esp_wifi_repeater

موجه NAT WiFi كامل الوظائف (وأيضًا مكرر WiFi المعروف بـ L2 bridge)

جديد 2026: بعد 10 سنوات من الإصدار الأول، أصبح أخيرًا ما كان يدّعي دائمًا أنه: مكرر WiFi حقيقي. من أجل عدم كسر أي مستندات أو روابط موجودة، لا تزال النسخة القياسية هي النسخة المعروفة لموجه NAT بجميع الميزات المتقدمة. ولكن إذا كنت مهتمًا بـ L2 bridge حقيقي مبسط، فانظر أدناه في القسم ESP8266 WiFi Repeater - L2 bridge.

هذا تنفيذ لموجه NAT WiFi على esp8266 و esp8285. يتضمن أيضًا دعمًا لجدار حماية لتصفية الحزم مع قوائم التحكم في الوصول (ACLs)، وتوجيه المنافذ، وتشكيل حركة المرور، وخطافات للمراقبة عن بُعد (أو التقاط الحزم)، وواجهة إدارة MQTT، وتفاعل GPIO بسيط، وإدارة الطاقة. للإعداد مع أجهزة توجيه متعددة في شبكة لتغطية منطقة أكبر، تم تضمين وضع جديد "أوتوميش".

إذا كنت تبحث عن طريقة لدمج ميزة NAT في مشروع Arduino الخاص بك - انظر هنا.

موجه NAT EPS32 هو المشروع المتقدم لـ ESP32.

تتضمن سيناريوهات الاستخدام النموذجية:

• موسّع نطاق بسيط لشبكة WiFi موجودة
• شبكات (متشابكة) خارجية تعمل بالبطارية
• إعداد شبكة WiFi إضافية باسم مستخدم/كلمة مرور مختلفة للضيوف
• إعداد شبكة آمنة ومقيدة لأجهزة إنترنت الأشياء
• ترجمة شبكات WPA2 Enterprise إلى WPA-PSK
• مراقب تجسس لتحليل حركة مرور WiFi
• تجارب شبكات مع المسارات، وقوائم التحكم في الوصول، وتشكيل حركة المرور
• جهاز إنترنت الأشياء متشابك مع قدرات إدخال/إخراج أساسية وتحكم MQTT

بشكل افتراضي، يعمل ESP كمحطة (STA) وكنقطة وصول ناعمة (soft-AP) ويقوم بإعادة توجيه أي حركة مرور IP من خلاله بشفافية. نظرًا لاستخدام NAT، لا يلزم وجود إدخالات توجيه لا على جانب الشبكة ولا على المحطات المتصلة. يتم تكوين المحطات عبر DHCP بشكل افتراضي في شبكة 192.168.4.0/24 ويتلقون عنوان خادم DNS من شبكة WiFi الموجودة.

تظهر القياسات أنه يمكنه تحقيق حوالي 5 ميجابت في الثانية في كلا الاتجاهين، لذا حتى البث ممكن.

يتم شرح بعض التفاصيل في هذا الفيديو.

مثبّت الويب

للوميض مباشرة على الجهاز، استخدم مثبّت الويب.

التشغيل الأول

يبدأ esp_wifi_repeater بالتكوين الافتراضي التالي:

• ap_ssid: MyAP, ap_password: none, ap_on: 1, ap_open: 1
• network: 192.168.4.0/24

بعد التشغيل الأول (أو إعادة ضبط المصنع)، سيوفر شبكة WiFi بنقطة وصول مفتوحة واسم SSID "MyAP". لا يحاول بعد إعادة الاتصال تلقائيًا بنقطة وصول الصاعدة (لأنه لا يعرف اسم SSID أو كلمة مرور صالحة).

اتصل بشبكة WiFi هذه وقم بالتكوين الأساسي إما عبر واجهة ويب بسيطة أو التكوين الكامل مع جميع الخيارات عبر وحدة التحكم.

واجهة تكوين الويب الأساسية

تسمح واجهة الويب بتكوين جميع المعلمات المطلوبة لوظيفة إعادة التوجيه الأساسية. شكرًا لـ rubfi على العمل الكبير في ذلك: https://github.com/rubfi/esp_wifi_repeater/ . وجّه متصفحك إلى "http://192.168.4.1". يجب أن تظهر هذه الصفحة:

أولاً، أدخل القيم المناسبة لشبكة WiFi الصاعدة، "إعدادات STA". استخدم كلمة المرور "none" للشبكات المفتوحة. حدد مربع "Automesh" فقط إذا كنت تريد حقًا استخدام وضع الأوتوميش. انقر على "Connect". يعاد تشغيل ESP ويتصل بموجه WiFi الخاص بك. يجب أن يومض مؤشر LED الخاص بالحالة بعد بضع ثوانٍ.

إذا قمت بتحديد الأوتوميش، فقد انتهيت من التكوين. تكوين "إعدادات نقطة الوصول الناعمة" غير مطلوب لأنه في وضع الأوتوميش تكون هذه الإعدادات مطابقة لـ "إعدادات STA". سيتم تقديم نفس SSID من قبل جميع مكررات ESP المتصلة.

إذا كنت لا تستخدم الأوتوميش، يمكنك الآن إعادة تحميل الصفحة وتغيير "إعدادات نقطة الوصول الناعمة". انقر على "Set" وسيعاد تشغيل ESP مرة أخرى. الآن أصبح جاهزًا لإعادة توجيه حركة المرور عبر نقطة الوصول الناعمة المكونة حديثًا. كن على علم أن هذه التغييرات تؤثر أيضًا على واجهة التكوين، أي للقيام بمزيد من التكوين، اتصل بـ ESP عبر إحدى شبكات WiFi المكونة حديثًا. للوصول عبر نقطة الوصول الناعمة، تذكر عنوان شبكة نقاط الوصول الناعمة إذا قمت بتغييره (ESP دائمًا لديه العنوان x.x.x.1 في هذه الشبكة).

إذا أردت، يمكنك تحديد مربع "lock" والنقر على "Lock". الآن لا يمكن تغيير التكوين دون إلغاء قفله أولاً بكلمة مرور شبكة WiFi الصاعدة (حدد واحدة حتى لو كانت الشبكة مفتوحة).

إذا كنت تريد إدخال أحرف غير ASCII أو أحرف خاصة في واجهة الويب، يجب عليك استخدام ترميز سداسي عشري بنمط HTTP مثل "My%20AccessPoint". سيؤدي هذا إلى سلسلة "My AccessPoint". باستخدام هذا الترميز السداسي العشري يمكنك إدخال أي قيمة بايت تريدها، باستثناء 0 (لأسباب داخلية في C).

إذا أخطأت وفقدت كل اتصال بـ ESP، فلا يزال بإمكانك استخدام وحدة التحكم التسلسلية لاستعادته ("إعادة ضبط المصنع"، انظر أدناه).

واجهة سطر الأوامر

يجب إجراء التكوين المتقدم عبر سطر الأوامر في واجهة وحدة التحكم. هذه الوحدة متاحة إما عبر المنفذ التسلسلي بسرعة 115200 باود أو عبر منفذ TCP 7777 (مثل "telnet 192.168.4.1 7777" من محطة متصلة).

استخدم الأوامر التالية للإعداد الأولي:

• set ssid your_home_router's_SSID
• set password your_home_router's_password
• set ap_ssid ESP's_ssid
• set ap_password ESP's_password
• show (للتحقق من المعلمات)
• save
• reset

مرة أخرى، إذا كنت تريد إدخال أحرف غير ASCII أو أحرف خاصة، يمكنك استخدام ترميز سداسي عشري بنمط HTTP (مثل "My%20AccessPoint") أو، فقط في CLI، كاختصار استخدام علامات الاقتباس بنمط C مع شرطة مائلة للخلف (مثل "My\ AccessPoint"). كلتا الطريقتين ستؤديان إلى سلسلة "My AccessPoint".

يفهم سطر الأوامر أوامر أكثر بكثير:

الأوامر الأساسية

كافية لجعلها تعمل في جميع البيئات تقريبًا.

• help: طباعة رسالة مساعدة قصيرة
• set [ssid|password] value: تغيير إعدادات نقطة الوصول الصاعدة (تكوين WiFi لموجه منزلك)، استخدم كلمة المرور "none" للشبكات المفتوحة.
• set [ap_ssid|ap_password] value: تغيير إعدادات نقطة الوصول الناعمة لـ ESP (لمحطاتك)
• show [config|stats]: طباعة التكوين الحالي أو بعض معلومات الحالة والإحصائيات
• save [dhcp]: حفظ معلمات التكوين الحالية، وقوائم ACL، وإدخالات التوجيه [+ إيجارات DHCP الحالية] إلى الفلاش
• lock [password]: حفظ وقفل التكوين الحالي، لا يُسمح بإجراء تغييرات. يمكن ترك كلمة المرور مفتوحة إذا تم تعيينها مسبقًا (الافتراضي هو كلمة مرور شبكة WiFi الصاعدة)
• unlock password: إلغاء قفل التكوين، يتطلب كلمة مرور من أمر lock
• reset [factory]: إعادة تعيين esp، 'factory' يعيد تعيين معلمات WiFi إلى القيم الافتراضية اختياريًا (يعمل على جهاز مقفل فقط من وحدة التحكم التسلسلية)
• quit: إنهاء جلسة عن بُعد

الأوامر المتقدمة

معظم أوامر set تكون فعالة فقط بعد الحفظ وإعادة التعيين.

أي جزء من إدخال سطر الأوامر بعد "#" واحد حتى نهاية السطر سيتم التعامل معه كتعليق وسيتم تجاهله.

تكوين الأوتوميش

• set automesh [0|1]: تحديد ما إذا كان وضع الأوتوميش قيد التشغيل أم لا (افتراضي)، راجع التفاصيل هنا https://github.com/martin-ger/esp_wifi_repeater#automesh-mode
• set am_threshold dB: تعيين العتبة لاتصال "سيء" (بالديسيبل السالب، افتراضي 85، أي -85 ديسيبل)
• set am_scan_time secs: تعيين الفاصل الزمني بالثواني الذي يحاول ESP في وضع الأوتوميش العثور على نقطة وصول صاعدة قبل الدخول في وضع السكون (0 معطل، افتراضي)
• set am_sleep_time secs: تعيين الفاصل الزمني بالثواني الذي ينام فيه ESP في وضع الأوتوميش إذا لم يتم العثور على نقطة وصول صاعدة (0 معطل، افتراضي)