🛰️ تثبيت Traccar — خادم تتبع المواقع بالـ GPS وإدارة أساطيل السيارات على Docker
نشر خادم Traccar على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لتتبع المركبات والهواتف بالـ GPS، وتحديد النطاقات الجغرافية (Geofencing)، والتقارير الحية على المنفذ 8217.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/traccar/traccar-ubuntu.sh
chmod +x traccar-ubuntu.sh
sudo bash traccar-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/traccar/traccar-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x traccar-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين الدائم للبيانات (`./data`) والسجلات (`./logs`) وملف الإعدادات (`./traccar.xml`) وتشغيل Traccar على منفذ الويب 8217 ومنفذ التتبع 5155.
sudo bash traccar-ubuntu.sh
4 تسجيل أول مستخدم وربط الهاتف كجهاز تتبع
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8217. يصبح أول مستخدم يسجل حسابه مديراً للنظام تلقائياً. ثبت تطبيق Traccar Client على هاتفك، ووجهه لمنفذ 5155، وشاهد تحركاتك اللحظية على الخريطة.
http://<your-server-ip>:8217
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8217 | Web UI (host → container 8082) |
| 5155 | Device reporting port (host → container 5055) — for trackers and apps |
| first user | The first user to register becomes the admin |
نظرة عامة
تعد Traccar المنصة مفتوحة المصدر الرائدة والأكثر انتشاراً عالمياً لتتبع المواقع الجغرافية بالـ GPS وإدارة أساطيل المركبات. تعمل المنصة عبر المنفذ 8217 (لوحة الويب العصرية والواجهة البرمجية API) ومنفذ استقبال بيانات الهواتف 5155 (المحول من 5055 الداخلي)، وتدعم أكثر من 2,000 طراز من أجهزة التتبع العتادية وأجهزة الـ OBD-II والهواتف الذكية (iOS وأندرويد). وتوفر تتبعاً حياً على الخرائط، وإعادة تشغيل المسارات السابقة، وتنبيهات الخروج من النطاقات الجغرافية (Geofences)، ومراقبة السرعة الزائدة واستهلاك الوقود.
لماذا تستخدمه
تفرض منصات تتبع السيارات التجارية السحابية اشتراكات شهرية متكررة عن كل سيارة، وتخزن بيانات تحركاتك ومواقعك الحساسة على خوادم خارجية. تمنحك Traccar نظام تتبع GPS احترافياً ومحمياً بنسبة 100% بدون أي رسوم اشتراك: أدر عدداً غير محدود من السيارات، وتتبع أفراد العائلة أو سيارات التوصيل في الوقت الفعلي، مع سيادة كاملة لبياناتك على سيرفرك الخاص.
متى تحتاجه
- تدير أسطول مركبات تجارية (سيارات، شاحنات، دراجات توصيل) وتحتاج لمراقبة حية للمسارات وسرعات السائقين
- تريد تتبعاً آمناً وخاصاً بنسبة 100% لسيارتك أو أفراد عائلتك دون دفع اشتراكات شهرية لشركات التتبع
- تريد رسم نطاقات جغرافية آمنة (Geofences) مثل المنزل أو مقر الشركة واستقبال تنبيهات فورية عند الدخول أو الخروج
- تحتاج إلى تقارير تفصيلية لسلوك القيادة: السرعة الزائدة، والتوقفات الطويلة، وساعات عمل المحرك
- تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً لمنصات تتبع الأساطيل السحابية باهظة الثمن
من يحتاجه
- مديرو أساطيل النقل وشركات الشحن والخدمات اللوجستية لمتابعة سيارات التوصيل والمشاوير اللحظية
- أصحاب الأعمال والشركات لمراقبة سيارات المندوبين وحساب استهلاك الوقود وبدلات الانتقال بدقة
- العائلات لمتابعة حركة السائقين والأبناء والاطمئنان على سلامتهم على الطرق
- مسؤولو أمان الأصول لحماية السيارات والقوارب من السرقة عبر أجهزة تتبع GPS مخفية
- أصحاب المنازل الذكية لربط إحداثيات السيارات مع Home Assistant لتشغيل سيناريوهات الاقتراب تلقائياً
حالات الاستخدام الشائعة
- متابعة 20 سيارة توزيع على خريطة OpenStreetMap حية مع عرض السرعة وحالة تشغيل المحرك في كل لحظة
- تثبيت تطبيق Traccar Client المجاني على هاتف آيفون أو أندرويد وتحويله فورياً لجهاز تتبع شخصي على المنفذ 5155
- استقبال إشعار فوري على تيليجرام أو البريد عند خروج سيارة من مستودع الشركة بعد انتهاء ساعات العمل
- تصدير تقرير شهري بصيغة Excel يوضح إجمالي الكيلومترات المقطوعة لكل سيارة لحساب استهلاك البنزين
- تشغيل أتمتة في Home Assistant لفتح بوابة الكراج وتشغيل الإنارة فور دخول السيارة للنطاق الجغرافي للمنزل
الميزات الرئيسية
- دعم أكثر من 2,000 طراز لجهاز GPS عتادي: أجهزة Teltonika وCoban وConcox وQueclink وأجهزة منفذ OBD
- واجهة ويب عصرية ومتجاوبة على المنفذ 8217: خريطة تفاعلية سريعة مع لوحات معلومات حية ومظهر ليلي
- تطبيقات هاتف مجانية: تطبيق Traccar Client متاح رسمياً على متجر App Store ومتجر Google Play
- نطاقات جغرافية مخصصة (Geofencing): رسم مناطق دائرية أو مضلعة على الخريطة مع تنبيهات الدخول والخروج
- إعادة تشغيل المسارات التاريخية: شريط زمني لإعادة استعراض خط سير الرحلات السابقة والسرعات والتوقفات
- تنبيهات فورية متعددة القنوات: إرسال الإشعارات عبر إشعارات الويب وتيليجرام ورسائل SMS والبريد والـ Webhooks
- نظام مستخدمين ومؤسسات متعددة: إنشاء حسابات عملاء بصلاحيات مقتصرة على سيارات محددة فقط
- معمارية Docker Compose تجمع Traccar مع ربط مجلدات `./data` و`./logs` و`./traccar.xml`
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8217 لعرض شاشة تسجيل دخول Traccar
- اضغط على 'Register' لإنشاء الحساب الأول (والذي يمنح رتبة مدير النظام Administrator تلقائياً)
- من Settings ← Server، عطّل خيار التسجيل المفتوح (Registration) لمنع الغرباء من إنشاء حسابات
- اضغط '+ Add Device' واكتب اسم الجهاز (مثل `My-Phone`) وأدخل معرّف الجهاز (مثل `123456`)
- ثبت تطبيق 'Traccar Client' على هاتفك، واضبط رابط السيرفر على `http://ip-سيرفرك:5155` وأدخل معرّف الجهاز `123456` وفعل الخدمة
- ضع واجهة Traccar خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد البيانات `./data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: سجل حساب المشرف فور اكتمال التثبيت؛ حيث يحصل أول حساب يسجل على كامل صلاحيات إدارة السيرفر
- عطّل ميزة تسجيل المستخدمين الجدد من إعدادات السيرفر فور إنشاء حسابك لمنع استغلال السيرفر
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي لتأمين جلسات المشاهدة وإحداثيات الـ GPS المنقولة بالشبكة
- افتح منافذ بروتوكولات الأجهزة المستخدمة فقط (مثل منفذ 5155 للهواتف أو منفذ جهاز التتبع العتادي)
- احمِ مجلد البيانات `./data` الذي يحتوي على سجلات المشاوير والمواقع بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات بروتوكولات التتبع
المنافذ وإعدادات جدار الحماية
يقدم Traccar لوحة الويب عبر منفذ TCP 8217 (المحول من 8082 الداخلي) ويستقبل بيانات الهواتف عبر منفذ TCP 5155 (المحول من 5055 الداخلي). اسمح بالمنفذ 8217 محلياً (`ufw allow 8217/tcp`). وافتح منفذ استقبال البيانات 5155 في جدار الحماية الخارجي (`ufw allow 5155/tcp`) لتتمكن الهواتف وأجهزة التتبع من إرسال مواقعها. وفي الإنتاج، وجه حركة الويب عبر وكيل عكسي مشفر بـ SSL على المنفذ 443.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات Traccar بالأجهزة والنطاقات الجغرافية والمواقع
- انسخ ملف `./traccar.xml` الذي يحتوي على إعدادات المنافذ والربط وقوالب التنبيهات
- احتفظ بنسخة من ملف `docker-compose.yml`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع كافة الأجهزة والمسارات بنجاح
الأخطاء الشائعة
- التأخر في تسجيل حساب المشرف الأول على سيرفر متصل بالإنترنت مما يسمح للمتنصتين بالاستيلاء على السيرفر
- إدخال منفذ لوحة الويب 8217 في تطبيق الهاتف بدلاً من منفذ استقبال بيانات التتبع 5155
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان الأجهزة وسجلات المواقع عند تحديث الحاوية
- نسيان فتح منفذ التتبع 5155 في جدار الحماية مما يمنع الهواتف من إرسال إحداثياتها للسيرفر
- الاعتماد على قاعدة H2 الافتراضية لأساطيل كبرى تضم أكثر من 50 سيارة (استخدم PostgreSQL للأساطيل الكبيرة)
استكشاف الأخطاء وإصلاحها
- موقع الهاتف لا يظهر على الخريطة — تأكد من ضبط المنفذ 5155 بالتطبيق، وتطابق معرّف الجهاز (Device ID)، ومنح صلاحية الـ GPS بالهاتف
- ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs traccar -f`
- جهاز الـ GPS العتادي لا يرسل — تأكد من فتح المنفذ المخصص لطراز الجهاز في Docker Compose (مثل منفذ 5027 لأجهزة Coban)
- استهلاك مرتفع للمعالج — قلل معدل إرسال الإحداثيات بالتطبيق (مثل الإرسال كل 15-30 ثانية بدلاً من ثانية واحدة)
- خطأ في صلاحيات مجلد البيانات — اضبط ملكية المجلد بالأمر: `chown -R 1000:1000 ./data`
البدائل
منصة OwnTracks الخفيفة عبر MQTT. تطبيق Home Assistant لتتبع الأجهزة السكنية. إضافة PhoneTrack لسحابة Nextcloud. منصات Samsara وVerizon Connect السحابية التجارية. منصة GPSWOX التجارية المستضافة ذاتياً.
متى لا تستخدمه
تجنب استخدام Traccar إذا كنت تبحث فقط عن معرفة وجود أفراد العائلة بالمنزل لتشغيل أتمتة Home Assistant (حيث يقوم تطبيق Home Assistant الرسمي بذلك أصلياً). وإذا كنت تبحث عن مسجل مواقع لا مركزي وبسيط لمستخدم واحد عبر وسيط MQTT، فإن OwnTracks أخف.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو نظام Traccar وكيف يعمل؟
Traccar منصة تتبع مواقع بالـ GPS مفتوحة المصدر، تستقبل إحداثيات الموقع الحية من الهواتف الذكية وأجهزة التتبع العتادية المثبتة بالسيارات، وتخزنها بقاعدة بيانات، وتعرض حركة المركبات المباشرة والمسارات السابقة على خرائط تفاعلية.
هل يمكن استخدام هاتفي الذكي كجهاز تتبع GPS؟
نعم! ثبت تطبيق 'Traccar Client' المجاني على آيفون أو أندرويد، واكتب رابط سيرفرك مع المنفذ 5155 (مثل `http://ip-سيرفرك:5155`)، وأدخل معرّف جهازك، وسيبدأ هاتفك ببث موقعه تلقائياً في الخلفية.
ما هي أنواع أجهزة التتبع العتادية المدعومة في Traccar؟
يدعم Traccar عملياً كافة أجهزة التتبع العتادية المتوفرة في السوق العالمي (أكثر من 2,000 طراز)، بما في ذلك أجهزة Teltonika وCoban وConcox وQueclink وأجهزة الـ OBD-II التي تركب بمقبس فحص السيارات.
كيف يتم تعيين حساب مدير النظام (Administrator)؟
عند تشغيل Traccar لأول مرة، لا يحتوي على أي حسابات مسبقة. ويحصل أول شخص يقوم بإنشاء حساب وتسجيل الدخول عبر المتصفح على رتبة مدير النظام تلقائياً. لذلك يجب التسجيل فورياً وتعطيل التسجيل المفتوح.
كم يستهلك Traccar من الذاكرة العشوائية (RAM)؟
تمت برمجة Traccar بلغة Java بكفاءة عالية، ويستهلك عادة ما بين 180 إلى 400 ميجابايت فقط من الذاكرة العشوائية داخل Docker لإدارة عشرات الأجهزة النشطة.