🗺️ تثبيت Nominatim — خادم البحث الجغرافي والترميز العكسي لبيانات OpenStreetMap على Docker

نشر خادم Nominatim 5 على Ubuntu باستخدام Docker — محرك البحث الجغرافي والترميز العكسي مفتوح المصدر المعتمد على بيانات OpenStreetMap لتحويل العناوين والإحداثيات دون قيود وبشكل مستقل تماماً.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Nominatim مع PostgreSQL 16 وإضافة PostGIS على المنفذ 8318 مع تخزين دائم للبيانات وواجهة REST API.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/maps/nominatim/nominatim-ubuntu.sh
chmod +x nominatim-ubuntu.sh
./nominatim-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/maps/nominatim/nominatim-ubuntu.sh

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

chmod +x nominatim-ubuntu.sh

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

./nominatim-ubuntu.sh

4 استيراد ملفات الخرائط واختبار API

http://your-server-ip:8318/search?q=an+address&format=json

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

المنفذالغرض
8318Nominatim geocoding API — /search and /reverse (mapped from container port 8080)

نظرة عامة

يعد Nominatim محرك البحث والترميز الجغرافي (Geocoding) الرسمي والمفتوح المصدر لمشروع خرائط الشارع المفتوحة OpenStreetMap (OSM). يعمل الخادم على المنفذ 8318 (المحول من منفذ 8080 الداخلي) ومدعوماً بقاعدة بيانات PostgreSQL 16 مع ملحق الفهارس المكانية PostGIS. يقدم Nominatim وظيفتين حيويتين لأنظمة الخرائط: الترميز الجغرافي المباشر (تحويل أسماء الشوارع والعناوين إلى إحداثيات خطوط الطول والعرض عبر مسار `/search`)، والترميز الجغرافي العكسي (تحويل إحداثيات GPS إلى عناوين نصية واضحة عبر مسار `/reverse`). وتمنحك استضافته ذاتياً واجهة جغرافية مجانية وغير محدودة لتطبيقاتك وأنظمة التتبع الجغرافي.

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

تفرض واجهات البحث الجغرافي التجارية (مثل Google Maps وMapbox) تكاليف باهظة تُحسب لكل طلب، مما يكلف آلاف الدولارات شهرياً للتطبيقات ذات الاستخدام الكثيف مثل تتبع أساطيل السيارات وشركات التوصيل. إضافة إلى ذلك، تفرض الخوادم العامة لـ OpenStreetMap قيوداً صارمة تمنع الفحص المكثف. تمنحك الاستضافة الذاتية لـ Nominatim عدداً غير محدود من الطلبات، وتضمن خصوصية مواقع عملائك بمعالجة البيانات محلياً داخل سيرفرك، وتوفر سرعة استجابة فائقة للغاية.

متى تحتاجه

  • تحتاج تطبيقاتك إلى عمليات تحويل عناوين وإحداثيات مكثفة دون دفع رسوم لكل طلب لـ Google Maps أو Mapbox
  • تدير نظام تتبع أساطيل مركبات (مثل Traccar) وتحتاج لتحويل إحداثيات السيارات لحظياً إلى أسماء شوارع
  • تلتزم بقوانين حماية البيانات والخصوصية الصارمة (GDPR) وتمنع إرسال إحداثيات العملاء لخوادم خارجية
  • تحتاج إلى خادم خرائط وبحث جغرافي يعمل محلياً في شبكات معزولة تماماً عن الإنترنت (Air-Gapped)
  • ترغب في تنقيح وفحص قواعد بيانات العناوين الضخمة ومطابقتها مع السجلات الجغرافية العالمية

من يحتاجه

  • مطورو نظم المعلومات الجغرافية (GIS) وتطبيقات الهواتف المعتمدة على الخرائط والمواقع
  • أصحاب ومديرو أنظمة تتبع المركبات وأجهزة GPS عبر منصة Traccar والأنظمة المخصصة
  • شركات الشحن والتوصيل والمتاجر الإلكترونية للتحقق التلقائي من عناوين التوصيل وحساب النطاقات
  • محللو البيانات والباحثون الذين يعالجون ملايين السجلات الجغرافية في الدراسات المكانية
  • مديرو الأنظمة لتوفير واجهات بحث جغرافي داخلية سريعة ومجانية لشبكات الشركات

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

  • الترميز العكسي اللحظي لإحداثيات GPS القادمة من أجهزة التتبع وعرض أسماء الشوارع داخل Traccar
  • الإكمال التلقائي لعناوين الشحن في المتاجر الإلكترونية وتحديد النطاق الجغرافي الدقيق للتوصيل
  • تحويل ملايين سجلات العملاء النصية إلى نقاط إحداثيات لرسم الخرائط الديموغرافية والتحليلية
  • تزويد تطبيقات الملاحة الداخلية بالبحث عن الوجهات وأسماء الأماكن العامة
  • توفير محرك بحث جغرافي محلي لغرف العمليات والطوارئ في حالات انقطاع الإنترنت العام

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

  • نقطة نهاية للترميز المباشر (/search) تدعم البحث عن العناوين المهيكلة وغير المهيكلة
  • نقطة نهاية للترميز العكسي فائقة السرعة (/reverse) لتحويل إحداثيات lat/lon إلى أسماء شوارع ومدن
  • نقطة استعلام متقدمة (/lookup) لفحص تفاصيل العقد والمسارات الجغرافية في OpenStreetMap
  • دعم صيغ إخراج متعددة تشمل JSON وJSONv2 وGeoJSON وXML مع تفاصيل الحدود الجغرافية
  • دعم استيراد ملفات PBF الخاصة بدول محددة (عبر Geofabrik) لتوفير الذاكرة ومساحة القرص
  • قاعدة بيانات PostgreSQL 16 مدمجة مع فهارس PostGIS المكانية لتنفيذ الاستعلامات في أجزاء من الثانية
  • إمكانية التحديث التلقائي المستمر للخرائط عبر ملفات الفروقات الدورية (OSM Diffs)
  • نشر معزول عبر Docker مع ربط مجلد التخزين الدائم لضمان استقرار وسرعة الصيانة

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

  • تأكد من عمل الخادم بتنفيذ استعلام بحث تجريبي: curl 'http://localhost:8318/search?q=Cairo&format=json'
  • اختبر الترميز العكسي بإحداثيات تجريبية: curl 'http://localhost:8318/reverse?lat=30.0444&lon=31.2357&format=json'
  • إذا كنت بحاجة لدول إضافية، حمل ملفات PBF للدول المطلوبة من Geofabrik واستوردها للنظام
  • اربط الخادم بنظام Traccar بالانتقال إلى Settings ← Server وتعيين Geocoder URL إلى: 'http://ip-سيرفرك:8318/reverse?format=json&lat=%LAT&lon=%LON'
  • اضبط وكيلاً عكسياً مشفراً بـ HTTPS (مثل Nginx) لإتاحة واجهة البحث الجغرافي بأمان لتطبيقاتك
  • فعل التحديث التلقائي للخرائط دورياً إذا كان تطبيقك يتطلب أحدث التعديلات الجغرافية للشبكة

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

  • لا تفتح واجهة API للإنترنت العام مباشرة دون بوابة مصادقة أو مفاتيح API إذا كان السيرفر متاحاً للعامة
  • استخدم تشفير HTTPS عبر وكيل عكسي لحماية إحداثيات وعناوين المستخدمين أثناء نقلها من الهواتف
  • قيد الوصول لمنفذ السيرفر وقصره على خوادم التطبيقات الداخلية (مثل Traccar) عبر جدار الحماية UFW
  • تأكد من حماية مجلد البيانات ./data بصلاحيات مناسبة على نظام الملفات
  • راقب معدل الطلبات لمنع هجمات حرمان الخدمة (DoS) الناتجة عن عمليات البحث النصي المعقدة
  • حدّث صورة الحاوية mediagis/nominatim دورياً للحصول على ترقيعات الأمان وتحسينات PostGIS

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

يستمع خادم Nominatim على منفذ TCP 8318 (المحول من منفذ 8080 الداخلي). إذا كان Nominatim مستخدماً حصرياً للخدمات الداخلية على نفس الخادم (مثل Traccar)، فاربط المنفذ محلياً بـ `127.0.0.1:8318:8080` لمنع الوصول الخارجي. وإذا كانت التطبيقات تتصل عبر الإنترنت، ضع المنفذ خلف وكيل عكسي مشفر بـ HTTPS على المنفذ 443.

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

  • انسخ مجلد ./data احتياطياً، والذي يحتوي على قاعدة بيانات PostgreSQL وفهارس PostGIS المكانية
  • احتفظ بنسخة من ملفات PBF الأولية المستخدمة في الاستيراد لإعادة البناء السريع عند الحاجة
  • أتمت النسخ الاحتياطي الدوري لمجلد البيانات إلى قرص ثانوي أو خادم NAS عبر restic أو rsync
  • ملاحظة: نظراً لإمكانية إعادة بناء قاعدة البيانات من ملفات OSM العامة، يمكنك الاكتفاء بنسخ الإعدادات وإعادة الاستيراد لتوفير مساحة التخزين
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من استجابة استعلامات /search بنجاح

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

  • محاولة استيراد خريطة كوكب الأرض بالكامل (Planet OSM 100GB+) على سيرفر بموارد ضعيفة (يتطلب الكوكب 64 جيجابايت RAM على الأقل وقرص 1TB NVMe؛ استورد ملفات الدول فقط)
  • تشغيل Nominatim على أقراص HDD ميكانيكية بطيئة بدلاً من أقراص NVMe/SSD السريعة، مما يسبب بطئاً شديداً في الاستعلامات
  • عدم ربط مجلد التخزين الدائم ./data، مما يجبر النظام على إعادة استيراد الخريطة لساعات عند إعادة تشغيل الحاوية
  • فتح المنفذ 8318 للعامة دون تحديد معدل للطلبات، مما يتيح للبرامج الآلية استنزاف موارد المعالج بالبحث العشوائي
  • نسيان كتابة format=json في روابط الاستعلام، مما يؤدي لإرجاع النتائج بتنسيق HTML بدلاً من JSON

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

  • الاستعلام يرجع مصفوفة فارغة — تأكد من أن العنوان المطلوب يقع داخل النطاق الجغرافي لملف PBF الذي تم استيراده
  • بطء شديد في الرد — تأكد من اكتمال بناء الفهارس وتخصيص ذاكرة كافية لـ PostgreSQL في إعدادات الحاوية
  • فشل بدء الحاوية أثناء الاستيراد — افحص مساحة القرص المتاحة (df -h) وتأكد من عدم استنزاف الذاكرة (OOM)
  • نظام Traccar لا يظهر العناوين — تأكد من صيغة الرابط في Traccar: 'http://localhost:8318/reverse?format=json&lat=%LAT&lon=%LON'
  • إعادة تشغيل مستمرة للحاوية — افحص سجلات الحاوية بالأمر: docker logs nominatim -f لمعرفة تفاصيل الخطأ

البدائل

محرك Photon خيار خفيف مبني على Elasticsearch يتميز بالسرعة الفائقة في الإكمال التلقائي وتصحيح الأخطاء الإملائية. محرك Pelias خيار تركيبي مفتوح المصدر يدعم مصادر بيانات متعددة. خدمات Google Maps وMapbox خيارات سحابية بتغطية عالمية ولكن برسوم تجارية مرتفعة. نظام Gisgraphy محرك بحث جغرافي مبني بلغة جافا.

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

تجنب استخدام Nominatim إذا كان هدفك الأساسي هو الإكمال التلقائي اللحظي أثناء كتابة الحروف مع معالجة الأخطاء الإملائية الشديدة (محرك Photon أفضل وأسرع لهذه الحالات). وإذا كان تطبيقك ينفذ بضع عشرات من الطلبات فقط يومياً، فإن استخدام المستويات المجانية لخدمات البحث السحابية يوفر عليك استهلاك موارد السيرفر.

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

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

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

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

ما الفرق بين الترميز الجغرافي المباشر (Geocoding) والترميز العكسي (Reverse Geocoding)؟

الترميز المباشر يحول العنوان النصي المقروء (مثل 'برج القاهرة، مصر') إلى إحداثيات جغرافية (lat/lon). بينما يحول الترميز العكسي إحداثيات GPS (مثل 30.0444, 31.2357) إلى عنوان نصي واضح يوضح الشارع والمدينة.

كم يحتاج خادم Nominatim من الذاكرة ومساحة القرص الصلب؟

لاستيراد دولة واحدة (مثل مصر أو ألمانيا أو المملكة المتحدة)، يعمل Nominatim بكفاءة بذاكرة 4 إلى 8 جيجابايت ومساحة 20 إلى 50 جيجابايت SSD. أما لخريطة العالم بالكامل، فيلزم خادم قوي بمواصفات 64 إلى 128 جيجابايت RAM وقرص 1.2 تيرابايت NVMe SSD.

هل يمكن ربط Nominatim بنظام تتبع المركبات Traccar؟

نعم، Nominatim هو الخيار الأكثر استخداماً مع Traccar للاستضافة الذاتية. اضبط رابط Geocoder في إعدادات Traccar على 'http://ip-سيرفرك:8318/reverse?format=json&lat=%LAT&lon=%LON' لعرض أسماء الشوارع للسيارات مجاناً.

كيف أقوم بتحديث بيانات الخرائط في Nominatim؟

يدعم Nominatim التحديث التلقائي المستمر من خوادم OpenStreetMap عبر تشغيل أمر التحديث داخل الحاوية (`nominatim replication --project-dir /app`) لتطبيق التعديلات اليومية على الخريطة.

هل توجد قيود على عدد الطلبات في هذا السيرفر المستضاف ذاتياً؟

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