ngrok: اجعل الـ API المحلي متاحاً للعالم
By هشام النحاس · نُشر في December 31, 2025
أداة ngrok هي وكيل عكسي (Reverse Proxy) يقوم بإنشاء نفق آمن بين جهازك المحلي وشبكة الإنترنت. تتيح لك جعل السيرفر المحلي (مثل localhost:8000) متاحاً عبر رابط عام (مثل https://xyz.ngrok-free.app) دون الحاجة لإعدادات معقدة في جدار الحماية أو الراوتر.
🌍
وصول عالمي
شارك تقدمك في المشروع فوراً مع العملاء أو زملائك في أي مكان.
🛡️
تشفير HTTPS
توليد شهادة SSL تلقائياً للرابط العام المؤقت الخاص بك.
🔌
اختبار الويب هوكس
مثالي لاختبار الربط مع Stripe أو GitHub أو Twilio محلياً.
خطوات الإعداد
- التسجيل: أنشئ حساباً مجانياً على ngrok.com واحصل على الـ
Authtokenالخاص بك. - التثبيت: قم بتحميل الأداة لنظام تشغيلك.
- التحقق: نفذ الأمر
ngrok config add-authtoken YOUR_TOKENفي التيرمينال. - بدء التشغيل: إذا كان الـ API الخاص بك يعمل على بورت 8000، نفذ:
ngrok http 8000
التحديات
- إتاحة السيرفر المحلي تتطلب عادةً "Port Forwarding" في الراوتر، وهو أمر غالباً ما تحجبه شركات الاتصالات.
- صعوبة اختبار تطبيقات الجوال مع API محلي إذا لم تكن الأجهزة على نفس شبكة الواي فاي.
- الخدمات الخارجية (Webhooks) لا يمكنها إرسال بيانات إلى عنوان
localhost.
الحلول
تتجاوز ngrok جدران الحماية تماماً. فهي توفر نفقاً آمناً بالإضافة إلى لوحة تحكم (على الرابط http://127.0.0.1:4040) تسمح لك بمراقبة كل الطلبات القادمة وإعادة إرسالها لتسريع عملية تصحيح الأخطاء (Debugging).