أدر إنترنت المقهى
باستخدام EveryCafe.

جهّز المعلومات التالية قبل تعديل إعدادات الشبكة:

• الوصول إلى إدارة pfSense Community Edition (CE) ومعرفة رقم الإصدار.
• اتصال جهاز EveryCafe الرئيسي بعنوان إدارة pfSense.
• معرفة أي خطوط الإنترنت مخصص للألعاب وأيها للاستخدام العام.
• نسخة احتياطية حديثة من إعدادات pfSense ووقت مناسب لإجراء التغييرات.
• بالنسبة إلى Wi-Fi: عنوان IP للجهاز الرئيسي وواجهة شبكة العملاء اللاسلكيين.

يختار EveryCafe سياسة كل جهاز، ويطبّق pfSense خط الإنترنت وحدود السرعة وقواعد الوصول. لذا يجب أن تمر حركة الأجهزة الخاضعة للإدارة عبر pfSense.

إذا كنت تدير أجهزة الكمبيوتر فقط، فأنجز الخطوات 03–07 ثم انتقل إلى اختبارات الخطوة 12.

افتح System → REST API في pfSense. إذا ظهرت القائمة، فانتقل إلى الخطوة 04.

1. تحقق من إصدار pfSense CE.
2. ابحث عن حزمة pfrest المطابقة له وتأكد من توافقها مع إصدار EveryCafe لديك.
3. إذا لزم الأمر، افتح 8 · Shell في وحدة تحكم pfSense ونفّذ أمر التثبيت الخاص بالإصدار الصحيح.
4. حدّث صفحة الإدارة وتحقق من ظهور REST API.

من System → REST API → Settings فعّل API، وحدد في Allowed Interfaces الواجهة المحلية التي يتصل من خلالها الجهاز الرئيسي (مثل LAN). اترك Read Only غير مفعّل، وفعّل المصادقة بطريقة Key. لا تفتح API على واجهة WAN إطلاقًا.

1. احفظ الإعدادات وافتح تبويب Keys.
2. أدخل وصفًا مفهومًا مثل EveryCafe Integration.
3. احفظ المفتاح الجديد وانسخه في مكان آمن.

افتح EveryCafe → الإعدادات → التكاملات → تكامل pfSense.

1. فعّل التكامل.
2. أدخل عنوان الإدارة، مثل https://192.168.10.1 مع البروتوكول والمنفذ الصحيحين.
3. الصق مفتاح API من الخطوة 04.
4. اضغط اختبار الاتصال، وبعد النجاح احفظ الإعدادات.

عند فشل الاختبار افحص العنوان والمنفذ وشهادة TLS والمفتاح والواجهة المسموح بها.

شغّل معالج الإعداد من صفحة التكامل نفسها. ينشئ المعالج مجموعات عناوين EC ومحددات السرعة وإدخالات الجدار الناري اللازمة لـ EveryCafe.

1. التحقق: راجع URL والمفتاح واختبر الاتصال.
2. تسمية الخطوط: اختر البوابات وسمّها مثل EC_OYUN وEC_INTERNET، وتحقق من مطابقة WAN الفعلية لكل خط، ثم حدد الخط الافتراضي.
3. خط الألعاب: راجع شبكات الألعاب والمنافذ، ولا تخمّن عناوين IP أو منافذ غير معروفة.
4. التطبيق: راجع الملخص، وأكمل المعالج وانتظر تطبيق التغييرات في pfSense.

اضبط خيار حظر الإنترنت عند انتهاء الجلسة وفق سياسة عملك، ثم اختبر النتيجة على جهاز تجريبي.

افتح EveryCafe → الإعدادات → التعرفات وعدّل التعرفة المطلوبة.

1. اختر خط الإنترنت، مثل EC_INTERNET.
2. فعّل تطبيق الخط تلقائيًا عند بدء الجلسة أو تغيير التعرفة.
3. احفظ وكرّر العملية للتعرفات الأخرى.
4. من الشاشة الرئيسية اختر جهازًا وطبّق أحد اختصارات السرعة أو أزل الحد.
5. تحقق من خط الإنترنت وحد السرعة في ملخص الجلسة.

«بلا حدود» يعني إزالة الحد الذي يطبّقه EveryCafe، وليس زيادة سعة خط الإنترنت الفعلية.

لدخول Wi-Fi الاختياري عبر العضوية، افتح pfSense → System → User Manager → Authentication Servers → Add.

• الاسم: EveryCafe؛ النوع والبروتوكول: RADIUS / PAP.
• عنوان الخادم: IP جهاز EveryCafe الرئيسي، مثل 192.168.10.10، وليس IP الخاص بـ pfSense.
• حدّد كلمة مرور مشتركة قوية Shared Secret، واكتب القيمة نفسها في EveryCafe في الخطوة 10. ليست هي مفتاح API.
• فعّل Authentication and Accounting على منفذي UDP 1812 و1813.

احفظ واستخدم IP ثابتًا أو حجز DHCP للجهاز الرئيسي، واسمح بالاتصال الوارد من pfSense عبر جدار حماية Windows.

من pfSense → Services → Captive Portal أنشئ منطقة، مثل everycafe_wifi.

1. فعّل البوابة على الواجهة المحلية لعملاء Wi-Fi، وليس WAN.
2. فعّل صفحة بوابة مخصصة وارفع ملفات حزمة EveryCafe: portal-giris.html (الدخول)، portal-hata.html (الخطأ)، portal-cikis.html (الخروج).
3. اختر التحقق عبر Authentication backend وحدد EveryCafe خادمًا للمصادقة.
4. فعّل Use RADIUS Session-Timeout attributes لإنهاء الوصول عند انتهاء المدة.
5. في Accounting، فعّل Send RADIUS accounting packets، واختر EveryCafe وتحديثات Interim، واترك خياري عكس البايتات واحتساب وقت الخمول غير مفعّلين.

احفظ وطبّق التغييرات. ملف HTML الخاص بهذا الدليل ليس صفحة بوابة؛ احصل على الملفات الثلاثة من حزمة تثبيت EveryCafe أو الدعم.

افتح EveryCafe → الإعدادات → التكاملات → pfSense → الشبكة اللاسلكية وفعّل استقبال طلبات دخول Wi-Fi.

• Shared Secret: كلمة المرور نفسها من الخطوة 08.
• الرسوم: المبلغ المخصوم من رصيد العضو؛ استخدم 0 للوصول المجاني.
• المدة: عدد الدقائق المسموح بها.
• عنوان الاستماع: IP الجهاز الرئيسي المحلي الذي يستطيع pfSense الوصول إليه.
• رمز الأمان: رمز منفصل للوصول المجاني المصرح به.

مثال: 30 ليرة تركية لمدة 60 دقيقة، وهو توضيح وليس سعرًا مقترحًا. تحقّق من تشغيل مستمع RADIUS دون تعارض منافذ.

يمكن لـ pfSense إرسال أحداث استعلام DNS إلى جهاز EveryCafe الرئيسي. هذه الطريقة لا تسجل عناوين URL الكاملة أو محتوى HTTPS، وقد تتجاوزها الأجهزة التي تستخدم DNS آخر أو DNS مشفرًا أو VPN.

1. من Services → DNS Resolver → General Settings فعّل DNS Resolver وأضف log-queries: yes داخل كتلة server: في الخيارات المخصصة.
2. احفظ وطبّق وأعد تشغيل خدمة unbound. قد يتأثر حل أسماء النطاقات مؤقتًا.
3. من Status → System Logs → Settings فعّل Remote Logging إلى عنوان الجهاز الرئيسي مثل 192.168.10.10:514 عبر IPv4 وحدد DNS Events.
4. اسمح بحركة UDP 514 من عنوان pfSense في جدار حماية الجهاز الرئيسي. لا تعطّل الجدار بالكامل؛ أبقِ السجلات داخل الشبكة المحلية.

نفّذ استعلام DNS تجريبيًا ثم افحص سجلات EveryCafe IPLog.

تحقق من كل وظيفة قبل إتاحتها للعملاء.

فحص الكمبيوتر

• نجاح اختبار اتصال EveryCafe بـ pfSense.
• اختيار البوابة المناسبة لتعرفة الإنترنت والألعاب.
• إمكانية تطبيق حد السرعة وإزالته.
• توقف الإنترنت بعد الجلسة إذا كان الخيار مفعّلًا.

فحص Wi-Fi

• أوقف بيانات الهاتف المحمول واتصل بشبكة المقهى وافتح بوابة الدخول.
• سجّل الدخول بحساب اختبار وتحقق من أي خصم للرصيد.
• اختبر عمل الإنترنت ثم توقفه عند نهاية المدة.
• إذا فُعّلت السجلات، تحقق من ظهور حدث DNS في IPLog.

قائمة REST API غير موجودة

تحقق من تثبيت الحزمة وتوافقها مع إصدار pfSense.

فشل اختبار الاتصال

افحص URL والمنفذ وشهادة TLS وتفعيل API وطريقة Key وAllowed Interfaces.

تغيّرت التعرفة دون تغيير خط الإنترنت

افحص ربط التعرفة والتطبيق التلقائي وIP الجهاز وإتمام المعالج.

الهاتف يتجاوز بوابة الدخول

تحقق من بيانات الهاتف وDHCP لنقطة الوصول وواجهة pfSense الصحيحة.

رفض دخول العضو

تحقق من مستمع RADIUS وبروتوكول PAP وShared Secret وIP الجهاز الرئيسي وUDP 1812/1813 وحالة العضو ورصيده.

مدة الجلسة غير صحيحة

راجع Session-Timeout وAccounting وInterim وUDP 1813.

لا توجد سجلات DNS

تحقق من DNS Resolver وإعادة تشغيل unbound وDNS Events وعنوان الخادم وUDP 514.

عند طلب الدعم جهّز إصدارات البرامج ورسالة الخطأ وصورًا تُخفى منها المفاتيح وكلمات المرور.

WAN / Gateway

خط الخروج إلى الإنترنت والبوابة المرتبطة به.

LAN / Interface

الشبكة المحلية وواجهة pfSense.

Alias

قائمة مسماة من عناوين IP أو الشبكات.

Limiter

قاعدة لتحديد سرعة الاتصال.

مفتاح API

مفتاح سري لوصول EveryCafe إلى إعدادات pfSense.

RADIUS / PAP

خدمة التحقق من عضوية المستخدم وبروتوكولها.

Accounting / Interim

تقارير الجلسات والتحديثات المرحلية المنتظمة.

Shared Secret

كلمة مرور مشتركة بين طرفي اتصال RADIUS.

Captive Portal

صفحة تسجيل الدخول عند الاتصال بشبكة Wi-Fi.

DHCP / DNS / Syslog

توزيع عناوين IP وتحويل أسماء النطاقات وإرسال السجلات.