🗺️ تثبيت خادم خرائط OpenStreetMap Tile Server — خادم خرائط تفاعلية مستقل على Docker
نشر خادم مربعات الخرائط OpenStreetMap Tile Server على Ubuntu باستخدام Docker — رندرة وتقديم مربعات الخرائط النقطية (PNG) محلياً باستخدام Mapnik وPostGIS وRenderd لتطبيقات Leaflet وMapLibre ونظم المعلومات الجغرافية.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/maps/osm-tile-server/osm-tile-server-ubuntu.sh
chmod +x osm-tile-server-ubuntu.sh
./osm-tile-server-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/maps/osm-tile-server/osm-tile-server-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x osm-tile-server-ubuntu.sh
3 تشغيل المثبت واستيراد بيانات PBF
./osm-tile-server-ubuntu.sh
4 التحقق من نقطة الخرائط وعرض الخريطة
http://your-server-ip:8317/tile/{z}/{x}/{y}.png
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8317 | Web view and tile endpoint at /tile/{z}/{x}/{y}.png (mapped from container port 80) |
نظرة عامة
يعد OpenStreetMap Tile Server خادم رندرة وتقديم بيانات جغرافية متكامل ومفتوح المصدر مبني على محرك Mapnik، وقاعدة بيانات PostgreSQL/PostGIS المكانية، وخادم Apache2، ومحرك Renderd (المعتمد على بنية `overv/openstreetmap-tile-server`). يعمل الخادم على المنفذ 8317 (المحول من 80 الداخلي)، ويقوم باستيراد ملفات الخرائط الإقليمية بصيغة `.osm.pbf` ورندرة مربعات الخرائط القياسية (Raster Tiles) وتقديمها فورياً عبر المسار `/tile/{z}/{x}/{y}.png`، مما يتيح لتطبيقات الويب والهواتف وأنظمة التتبع عرض خرائط تفاعلية مستقلة دون أي اعتماد على خدمات الخرائط السحابية المدفوعة.
لماذا تستخدمه
تفرض خدمات الخرائط التجارية (مثل Google Maps وMapbox) رسوماً باهظة لكل طلب استدعاء للمربعات ترتفع بشكل حاد مع نمو زوار موقعك أو أسطول سياراتك، كما تمنع سياسة الاستخدام العادل لخوادم OpenStreetMap العامة استخدامها في التطبيقات التجارية الكثيفة. يمنحك تشغيل خادم خرائط OSM خاص بك عدداً غير محدود من طلبات الخرائط، وسرعة استجابة مذهلة في أجزاء من الثانية داخل شبكتك، واستقلالية تامة تتيح عمل الخرائط بدون إنترنت.
متى تحتاجه
- تحتاج إلى مربعات خرائط نقطية غير محدودة لتطبيقات الويب أو بوابات تتبع الشحنات أو تطبيقات الهواتف دون تكاليف APIs
- تعمل في شبكات معزولة أو داخلية أو سرية لا تتوفر فيها إمكانية الاتصال بخدمات الخرائط التجارية الخارجية
- تدير أنظمة تتبع أساطيل المركبات وأجهزة إنترنت الأشياء (IoT) التي تولد ملايين طلبات الخرائط يومياً
- ترغب في استضافة خرائط جغرافية لدولة معينة (مثل مصر أو السعودية أو دول أوروبا) على سيرفراتك الخاصة
- تبني تطبيقات خرائط تفاعلية باستخدام مكتبات Leaflet أو OpenLayers أو MapLibre وتحتاج لنقطة `/tile/{z}/{x}/{y}.png` خاصة
من يحتاجه
- مهندسو ومطورو نظم المعلومات الجغرافية (GIS) لبناء لوحات الخرائط التفاعلية والتحليلات المكانية
- شركات الشحن والخدمات اللوجستية وإدارة أساطيل السيارات لتتبع المركبات وخطوط السير لحظياً
- الجهات الحكومية، وفرق الطوارئ، والمنشآت البحرية والصناعية التي تحتاج لخرائط تعمل دون إنترنت (Offline)
- مطور الويب الباحثون عن بديل مجاني وسريع ومستقل لعرض الخرائط في مواقعهم وتطبيقاتهم
- أصحاب السيرفرات المنزلية لتوفير خرائط مستقلة لأنظمة الأتمتة المنزلية والتتبع الشخصي
حالات الاستخدام الشائعة
- تقديم مربعات الخرائط للوحة تحكم مركزية تتابع مئات الشاحنات التجارية لحظياً
- توفير خرائط جغرافية تفاعلية تعمل محلياً للفرق الميدانية في المناطق النائية والمصانع المعزولة
- تضمين خرائط تفاعلية خفيفة في مواقع العقارات والمتاجر ومواقع التجارة الإلكترونية
- تخزين مربعات الخرائط الأكثر طلباً للمدن الكبرى في الذاكرة لتسريع استجابة المواقع لزوارها
- دمج الخادم مع خوادم البحث الجغرافي (Nominatim) وخوادم التوجيه الملاحي (OSRM) لإنشاء بديل ذاتي متكامل لـ Google Maps
الميزات الرئيسية
- منظومة رندرة خرائط متكاملة تعتمد على محرك Mapnik ونمط Carto المعتمد في موقع OpenStreetMap الرسمي
- صيغة مربعات قياسية `/tile/{z}/{x}/{y}.png` متوافقة مباشرة مع Leaflet وOpenLayers وMapLibre وQGIS
- صفحة عرض تجريبية تفاعلية مدمجة على المنفذ 8317 لاختبار الخرائط ومستويات التكبير فورياً داخل المتصفح
- رندرة لحظية ديناميكية للمربعات مع التخزين المؤقت التلقائي على القرص في مجلد `./tiles` لزيادة السرعة
- قاعدة بيانات مكانية فائقة الأداء مبنية بـ PostgreSQL وPostGIS ومفهرسة بأداة osm2pgsql
- دعم استيراد بيانات الدول والمناطق الإقليمية والعالم من منصة Geofabrik (ملفات `.osm.pbf`)
- استقلالية تامة عن السحابة: صفر قيود استخدام، صفر تكاليف اشتراكات، وخصوصية بيانات مطلقة
- نشر معزول عبر Docker مع ربط مجلدات `./db` لقاعدة البيانات و`./tiles` لذاكرة الكاش
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8317 لعرض الخريطة التفاعلية التجريبية المدمجة
- قم بتكبير وتصغير الخريطة وتحريكها فوق منطقتك للتأكد من رندرة الشوارع والمباني والأنهار بنجاح
- اختبر رابط مربع الخريطة المباشر في متصفحك: `http://ip-سيرفرك:8317/tile/0/0/0.png`
- اضبط كود مكتبة Leaflet في موقعك للإشارة إلى خادمك الجديد: `L.tileLayer('http://ip-سيرفرك:8317/tile/{z}/{x}/{y}.png')`
- ضع خادم الخرائط خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع تفعيل كاش الترويسات لتسريع الأداء في الإنتاج
- يمكنك اختيارياً رندرة مستويات التكبير الأولى مسبقاً (من زوم 0 إلى 12) عبر أمر `render_list` لإلغاء أي تأخير أولي
أفضل ممارسات الأمان
- ضع خادم الخرائط خلف وكيل عكسي مشفر بـ HTTPS — حيث تحظر المتصفحات الحديثة تحميل مربعات الخرائط غير المشفرة في المواقع المشفرة
- اضبط التخزين المؤقت في Nginx وحدد معدلات الطلبات (Rate Limiting) لحماية السيرفر من سحب المربعات العشوائي
- قيد الوصول لمنافذ الإدارة وقاعدة البيانات واحتفظ بمنفذ PostgreSQL معزولاً داخل شبكة Docker
- تأكد من تفعيل ترويسات CORS (Access-Control-Allow-Origin: *) في الوكيل العكسي لتتمكن مواقعك من سحب الخرائط
- احمِ مجلدي `./db` و`./tiles` بصلاحيات مناسبة على السيرفر
- حدّث حاوية overv/openstreetmap-tile-server دورياً للحصول على التحديثات الأمنية وإصلاحات الرندرة
المنافذ وإعدادات جدار الحماية
يستمع خادم OpenStreetMap Tile Server على منفذ TCP 8317 (المحول من منفذ 80 الداخلي). في بيئة الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8317، مع إبقاء المنفذ 8317 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 لاستقبال الزوار.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./db` (/data/database) احتياطياً، والذي يحتوي على قاعدة بيانات PostGIS المكانية وفهارس osm2pgsql
- احتفظ بنسخة من ملف الخريطة الأصلي الخام `.osm.pbf` الذي تم استيراده في البداية (من Geofabrik)
- ملاحظة: مجلد `./tiles` هو ذاكرة كاش مؤقتة للصور المرندرة ويمكن إعادة توليده في أي وقت، لكن نسخه يوفر استهلاك المعالج
- أتمت النسخ الاحتياطي الدوري لقاعدة البيانات وارفعها إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استمرار عمل الخريطة دون الحاجة لإعادة الاستيراد
الأخطاء الشائعة
- محاولة استيراد ملف خريطة العالم بالكامل (أكثر من 70 جيجابايت) على سيرفر بموارد ضعيفة (يتطلب كوكب الأرض 64 جيجابايت RAM وأقراص NVMe سريعة؛ استخدم خرائط الدول المحددة للسيرفرات العادية)
- نفاد مساحة القرص الصلب أثناء استيراد بيانات PBF (حيث تتمدد قاعدة بيانات PostGIS إلى 3 إلى 5 أضعاف حجم ملف PBF المضغوط)
- استدعاء روابط الخرائط ببروتوكول HTTP غير المشفر داخل موقع يعمل بـ HTTPS، مما يسبب حظر عرض الخريطة في المتصفح
- عدم ربط مجلدي التخزين الدائم `./db` و`./tiles`، مما يؤدي لمسح قاعدة البيانات بالكامل عند إعادة تشغيل الحاوية
- عدم رندرة مستويات التكبير الأولى مسبقاً، مما يسبب ضغطاً مفاجئاً على المعالج عند فتح الخريطة لأول مرة
استكشاف الأخطاء وإصلاحها
- مربعات الخريطة تظهر فارغة أو ترجع خطأ 404 — تأكد من أن الإحداثيات المطلوبة تقع داخل النطاق الجغرافي لملف الدولة المستوردة
- استهلاك معالج مرتفع جداً عند التكبير الأول — يقوم Mapnik برندرة الصور لحظياً؛ يمكنك رندرتها مسبقاً بالأمر `render_list -a -z 0 -Z 10` داخل الحاوية
- فشل الاستيراد بخطأ نفاد الذاكرة (Out of Memory) — زد رامات السيرفر، أو أنشئ ملف ذاكرة تبادل (Swap) بمساحة 4 جيجابايت على الأقل
- واجهة عرض الخريطة لا تفتح على 8317 — افحص سجلات الحاوية بالأمر: `docker logs osm-tile-server -f`
- انهيار محرك Renderd — تأكد من تشغيل PostgreSQL وصحة أذونات مجلد `/data/database`
البدائل
خوادم Martin وTegola خوادم مربعات متجهة (Vector Tiles) فائقة السرعة بلغة Rust وGo لتطبيقات MapLibre GL. خادم Tileserver GL خيار مفتوح المصدر لدعم أنماط Mapbox GL. منصات Mapbox وGoogle Maps حلول تجارية سحابية مدفوعة. نظام Protomaps نظام خرائط متجهية بدون خادم يعتمد على ملفات PMTiles.
متى لا تستخدمه
تجنب استخدام خادم الخرائط النقطية هذا إذا كان تطبيقك يتطلب خرائط متجهية (Vector Tiles) تدعم التدوير ثلاثي الأبعاد وإمالة المباني وتغيير الألوان ديناميكياً داخل المتصفح (استخدم خوادم مثل Martin أو Tileserver GL بدلاً منه). وإذا كنت تحتاج فقط لخريطة سريعة وبسيطة لموقع شخصي بزيارات قليلة، فإن استخدام كود Leaflet المباشر مع طبقات OpenStreetMap العامة أبسط بكثير.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين مربعات الخرائط النقطية (Raster) والمتجهية (Vector)؟
المربعات النقطية (التي يقدمها هذا الخادم) هي صور PNG جاهزة بمقاس 256×256 بكسل تتميز بسرعتها وتوافقها مع كافة الأجهزة القديمة. أما المربعات المتجهية فتحتوي على إحداثيات هندسية تتم رندرتها وتلوينها داخل متصفح المستخدم باستخدام كرت الشاشة، مما يتيح التدوير السلس وعرض المباني ثلاثية الأبعاد.
كيف يمكنني استيراد خريطة دولة أو منطقة معينة؟
يمكنك تحميل ملفات الخرائط بصيغة `.osm.pbf` لأي دولة أو قارة مجاناً من موقع Geofabrik (download.geofabrik.de)، وتمرير اسم الملف أثناء تشغيل سكريبت التثبيت ليتم استيراده تلقائياً إلى قاعدة بيانات PostGIS.
كيف أربط خادم الخرائط بمكتبة Leaflet في موقعي؟
في كود جافاسكريبت الخاص بـ Leaflet، أضف طبقة TileLayer تشير لرابط خادمك: `L.tileLayer('http://ip-سيرفرك:8317/tile/{z}/{x}/{y}.png', { maxZoom: 18 }).addTo(map);`.
هل يمكن تشغيل خادم الخرائط هذا في بيئة مغلقة تماماً بدون إنترنت؟
نعم! بمجرد اكتمال استيراد ملف بيانات `.osm.pbf` داخل قاعدة البيانات، يعمل خادم الخرائط محلياً 100% (Offline)، ولا يتطلب أي اتصال بالإنترنت الخارجي لتقديم ورندرة الخرائط.
كم يستهلك خادم الخرائط من الذاكرة العشوائية والمساحة التخزينية؟
لخريطة دولة واحدة (مثل مصر أو ألمانيا)، تكفي 2 إلى 4 جيجابايت من الذاكرة العشوائية و20 إلى 40 جيجابايت من مساحة القرص SSD. أما لخريطة قارة كاملة أو كوكب الأرض بالكامل، فيتطلب الأمر 32 إلى 64 جيجابايت فأكثر من الذاكرة العشوائية وأقراص NVMe فائقة السرعة.