🌐 تثبيت Cloudflare DDNS — أبقِ نطاقك مرتبطاً بـ IP متغيّر
انشر Cloudflare DDNS على Ubuntu بـ Docker — وكيل صغير وآمن يُحدّث تلقائياً سجلات DNS الخاصة بك في Cloudflare كلما تغيّر IP منزلك. بلا واجهة ويب، ومُعدّ بالكامل عبر متغيرات البيئة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/cloudflare-ddns/cloudflare-ddns-ubuntu.sh
chmod +x cloudflare-ddns-ubuntu.sh
sudo bash cloudflare-ddns-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/cloudflare-ddns/cloudflare-ddns-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x cloudflare-ddns-ubuntu.sh
3 تشغيل المُثبّت
يثبّت السكريبت Docker إن لزم ويُشغّل وكيل favonia/cloudflare-ddns. تُزوّده برمز Cloudflare API محدود النطاق وقائمة نطاقاتك عبر متغيرات البيئة؛ يُبقي الوكيل بعدها سجلاتها مرتبطة بـ IP العام الحالي.
sudo bash cloudflare-ddns-ubuntu.sh
4 التحقق من التحديث عبر السجلات
لا توجد واجهة ويب — تتأكد من عمله بقراءة سجلات الحاوية، التي تعرض IP المكتشف وكل سجل حدّثه:
docker logs cloudflare-ddns
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| No ports | Outbound-only agent — no web UI, nothing to firewall inbound |
| CLOUDFLARE_API_TOKEN | A scoped token with DNS edit on your zone (never the Global Key) |
| DOMAINS | Comma-separated records to keep pointed at your public IP |
نظرة عامة
Cloudflare DDNS وكيل صغير مخصص (الأشهر هو صورة favonia/cloudflare-ddns مفتوحة المصدر) يُبقي سجلات DNS في منطقتك المُدارة عبر Cloudflare مرتبطة بعنوان IP العام الحالي لديك. معظم اتصالات الإنترنت المنزلية والعديد من اتصالات الأعمال لديها IP ديناميكي يمكن لمزود الخدمة تغييره في أي وقت دون إشعار، مما يُعطّل بصمت أي اسم نطاق مرتبط بشبكتك المنزلية أو المكتبية. يعمل الوكيل باستمرار في الخلفية، يتحقق من IP العام على فترات، ويدفع تحديثاً لواجهة برمجة Cloudflare فقط عندما يتغيّر IP فعلياً.
لماذا تستخدمه
يحل DNS الديناميكي مشكلة محددة وشائعة: تريد اسم نطاق ثابتاً (مثل home.example.com) يشير لاتصال عنوان IP الخاص به غير ثابت. بدلاً من التحقق يدوياً وتحديث سجلات DNS كل مرة يُعيد فيها مزود الخدمة تخصيص IP لك، يقوم هذا الوكيل بذلك تلقائياً وشبه فورياً، مكتشفاً التغيير عادةً خلال دقائق. تشغيله ضد Cloudflare تحديداً يمنحك DNS العالمي السريع لـ Cloudflare، ووكيل/CDN مجاني إن أردت، وواجهة برمجية موثّقة جيداً — كل هذا عبر حاوية خفيفة واحدة لا تحتاج واجهة ويب أو صيانة يدوية مستمرة.
متى تحتاجه
- تستضيف خدماتك ذاتياً في المنزل أو مكتب صغير على اتصال بعنوان IP عام ديناميكي (غير ثابت)
- تريد اسم نطاق ثابت يستمر بالعمل بعد تغيير مزود الخدمة لـ IP العام دون تحديث DNS يدوياً
- تُشغّل خدمات خلف راوتر منزلي دون إضافة IP ثابت من مزود خدمتك ولا تريد الدفع مقابل ذلك
- تدير نطاقاً مُستضافاً على Cloudflare وتحتاج أن تعكس سجلاته A/AAAA دائماً IP العام الحالي
- تحتاج وكيلاً خفيفاً بلا واجهة يعمل دون إشراف بدلاً من عملية تحديث DDNS يدوية أو عبر المتصفح
من يحتاجه
- عشاق المختبرات المنزلية والاستضافة الذاتية الذين يُشغّلون خدمات مثل Nextcloud أو Jellyfin أو سيرفر Minecraft خلف اتصال إنترنت منزلي
- الشركات الصغيرة التي لا تملك خطة IP ثابت من مزود خدمتها لكنها لا تزال تحتاج اسم نطاق موثوق يشير لشبكة مكتبها
- مديرو الأنظمة الذين يديرون وصولاً عن بُعد لشبكة منزل أو فرع عبر نطاق سهل التذكر بدلاً من IP متغيّر خام
- المستخدمون الذين يجمعون بين خدمات ذاتية الاستضافة وCloudflare Tunnel أو وكيل عكسي ولا يزالون يحتاجون DNS دقيقاً كأساس
- أي شخص لا يوفر مزود خدمته (أو يفرض رسوماً إضافية) عنوان IP ثابتاً لكنه يريد وصولاً واردا موثوقاً
- هواة تقنية المعلومات والطلاب المتعلمون لأتمتة DNS وDocker والبنية التحتية المدفوعة بواجهات برمجية
- الفرق التي تستخدم Cloudflare بالفعل لإدارة النطاقات وتريد أن يتكامل DDNS مباشرة مع ذلك الإعداد الموجود
حالات الاستخدام الشائعة
- إبقاء اسم نطاق سيرفر منزلي دقيقاً بعد تغييرات IP المُخصَّصة من مزود الخدمة، لضمان عمل الوصول عن بُعد دائماً
- صيانة DNS لتطبيقات ذاتية الاستضافة (Nextcloud، Jellyfin، Home Assistant) يمكن الوصول إليها من خارج الشبكة المنزلية
- دعم نقطة نهاية VPN أو وصول عن بُعد لمكتب صغير على اتصال إنترنت أعمال ديناميكي
- تزويد أتمتة أخرى تعتمد على معرفة IP العام الحالي عبر بحث DNS ببيانات IP دقيقة
- توفير اسم مضيف ثابت لأنظمة IoT أو الكاميرات التي تحتاج الوصول إليها عن بُعد دون IP ثابت
الميزات الرئيسية
- ملف Go تنفيذي خفيف يُقدَّم كصورة Docker صغيرة باستهلاك منخفض جداً للمعالج والذاكرة
- يُحدّث سجلات IPv4 (A) وIPv6 (AAAA) على حد سواء، مع سلوك قابل للضبط لكل بروتوكول عبر IP4_PROVIDER وIP6_PROVIDER
- مُعدّ بالكامل عبر متغيرات البيئة — بلا واجهة ويب أو تعديل ملف إعداد أو تدخل يدوي بعد الإعداد الأولي
- يدعم رموز Cloudflare API محدودة النطاق بدلاً من طلب مفتاح Global API الخاص بالحساب بأكمله
- إعداد PROXIED اختياري لتوجيه الحركة عبر وكيل/CDN الخاص بـ Cloudflare بدلاً من كشف IP الخاص بك مباشرة في DNS
- سجلات واضحة وسهلة القراءة تعرض تغييرات IP المكتشفة وكل تحديث سجل DNS للتحقق السهل واستكشاف الأخطاء
كيفية الاستخدام بعد التثبيت
- اقرأ سجلات الحاوية بـ docker logs cloudflare-ddns للتأكد أنه اكتشف IP العام الخاص بك وحدّث سجلات DNS بنجاح
- تحقق من سجل A/AAAA المُحدَّث في لوحة تحكم Cloudflare تحت DNS للتأكد أن IP يطابق ما أبلغ عنه الوكيل
- أضف أو عدّل متغير البيئة DOMAINS إذا احتجت إدارة نطاقات فرعية إضافية بعد الإعداد الأولي
- قرّر ما إذا كنت ستفعّل PROXIED لكل نطاق — السجلات المُمرَّرة عبر الوكيل تُخفي IP الحقيقي خلف Cloudflare، والسجلات غير المُمرَّرة تكشفه مباشرة
- اضبط IP6_PROVIDER=none صراحة إذا كانت شبكتك لا تدعم IPv6، لتفادي محاولات بحث غير ضرورية وضوضاء في السجلات
- اترك الحاوية تعمل باستمرار (restart: unless-stopped) لأنها يجب أن تستمر بالتحقق من IP بشكل مستمر، لا مرة واحدة فقط
أفضل ممارسات الأمان
- أنشئ رمز Cloudflare API محدود النطاق بصلاحية تعديل DNS على المنطقة المحددة التي تُحدّثها فقط — لا تستخدم أبداً مفتاح Global API الخاص بالحساب
- خزّن رمز API كمتغير بيئة أو سر Docker، ولا تضمّنه أبداً في سكريبت أو نظام تحكم بالإصدارات
- بما أن هذا الوكيل لا يملك واجهة ويب ولا يفتح أي منافذ واردة، لا يوجد سطح هجوم مكشوف يحتاج جداراً نارياً — الخطر الأساسي هو تسرّب الرمز
- دوّر رمز Cloudflare API دورياً وفوراً إذا اشتبهت أنه قد تسرّب
- إذا فعّلت PROXIED، افهم أن وكيل Cloudflare يُخفي IP الحقيقي عن عمليات بحث DNS لكن SSH وخدمات أخرى غير HTTP عادةً ما تزال تحتاج اتصالات مباشرة غير مُمرَّرة
- قيّد رمز API على النطاقات/المناطق التي يحتاج تحديثها فقط، بدلاً من منحه وصول DNS أوسع على مستوى الحساب
المنافذ وإعدادات جدار الحماية
لا يحتاج هذا الوكيل أي منافذ واردة إطلاقاً — فهو فقط يُرسل طلبات HTTPS صادرة لواجهة برمجة Cloudflare للتحقق من IP العام ودفع تحديثات DNS، لذا لا يوجد شيء لفتحه في جدارك الناري كي يعمل. متطلبه الشبكي الوحيد هو وصول إنترنت صادر من المضيف أو الحاوية. الحد الأمني الحقيقي هنا هو رمز CLOUDFLARE_API_TOKEN نفسه: أبقه محدوداً بصلاحية تعديل DNS على المنطقة المعنية فقط، ولا تكشفه أبداً في السجلات أو السكريبتات المرفوعة لنظام تحكم بالإصدارات أو ملفات إعداد مشتركة.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً متغيرات البيئة أو ملف .env الذي يحمل إعداد CLOUDFLARE_API_TOKEN وDOMAINS، لأن إعادة إنشاء الحاوية من الصفر يتطلبها
- سجّل أي منطقة Cloudflare ونطاق رمز API يستخدمه كل نشر إذا كنت تُشغّل عدة نسخ لنطاقات أو حسابات مختلفة
- لا توجد بيانات تطبيق أو قاعدة بيانات لنسخها احتياطياً غير الإعدادات — مصدر الحقيقة لسجلات DNS نفسها يعيش في Cloudflare، لا في الحاوية
- إذا دوّرت رمز API، حدّث إعداداتك/نسختك الاحتياطية المحفوظة فوراً حتى لا تستخدم إعادة نشر لاحقة رمزاً مُلغى
الأخطاء الشائعة
- استخدام مفتاح Global API الخاص بالحساب بدلاً من رمز محدود النطاق بصلاحية تعديل DNS على منطقة واحدة — هذا يمنح وصولاً أوسع بكثير مما يحتاجه الوكيل
- نسيان أن 'DOMAINS' يُحدّث فقط النطاقات المُدرجة فيه — إضافة نطاق فرعي جديد لاحقاً يتطلب تحديث هذا المتغير وإعادة تشغيل الحاوية
- عدم ضبط IP6_PROVIDER=none على شبكات IPv4 فقط، مما يؤدي لإدخالات سجل مربكة حول فشل عمليات بحث IPv6
- افتراض أن هذه الأداة تحل محل Cloudflare Tunnel أو وكيل عكسي — DDNS فقط يُبقي DNS دقيقاً، لا يتعامل مع إعادة توجيه المنافذ أو إنهاء TLS أو إخفاء سيرفرك خلف نفق
- عدم التحقق من أول تحديث ناجح في السجلات، وافتراض أنه يعمل بينما الحاوية تفشل بصمت فعلياً بسبب رمز غير صالح
- تشغيل الحاوية دون restart: unless-stopped، فتتوقف عن تحديث DNS بعد إعادة تشغيل المضيف حتى إعادة تشغيلها يدوياً
استكشاف الأخطاء وإصلاحها
- لا تظهر تحديثات في السجلات — راجع docker logs cloudflare-ddns لأخطاء مصادقة، والتي تعني عادةً أن رمز API غير صالح أو يفتقر صلاحية تعديل DNS
- سجل DNS لا يتغيّر رغم أن السجل يُظهر تحديثاً — امنح وقتاً لانتشار DNS، وتأكد أنك تتحقق من نوع السجل الصحيح (A مقابل AAAA) والمنطقة الصحيحة
- أخطاء IPv6 في السجلات على شبكة لا تدعم IPv6 — اضبط IP6_PROVIDER=none لتعطيل فحوصات IPv6 تماماً
- أخطاء فشل المصادقة — أعد توليد رمز Cloudflare API، تأكد أن له صلاحية Zone:DNS:Edit على المنطقة الصحيحة، وحدّث متغير البيئة CLOUDFLARE_API_TOKEN
- الحاوية تُعيد التشغيل بشكل متكرر — تحقق من قيمة DOMAINS غير صحيحة الصياغة (فواصل مفقودة، أخطاء إملائية في أسماء النطاقات) قد تُسبّب خروج الوكيل عند البدء
- التحديثات تعمل لكن الخدمات خلف النطاق غير قابلة للوصول — هذه عادةً ليست مشكلة DDNS؛ تحقق من إعادة توجيه منافذ الراوتر أو قواعد الجدار الناري أو إعداد الوكيل العكسي بشكل منفصل
البدائل
ddclient عميل DDNS عام الغرض قائم منذ زمن طويل بلغة Perl يدعم عشرات مزودي DNS بجانب Cloudflare، على حساب واجهة أقدم وملف إعداد أثقل. DDNS-Go (jeessy2/ddns-go) يقدّم واجهة ويب ودعماً لعدة مزودين إذا كنت تفضّل إدارة DDNS بصرياً بدلاً من متغيرات البيئة. Cloudflare Tunnel يحل مشكلة ذات صلة لكن مختلفة — بدلاً من إبقاء IP دقيقاً في DNS كي تُعيد توجيه المنافذ مباشرة، يُنشئ نفقاً صادراً فقط بحيث لا تحتاج أبداً فتح منافذ واردة أو حتى معرفة IP العام الخاص بك إطلاقاً. إضافة IP ثابت من الراوتر أو مزود الخدمة تُزيل الحاجة لـ DDNS تماماً لكنها عادةً تكلّف إضافياً وليست متاحة في كل مكان. لوكيل بسيط ومخصص يركّز تحديداً على DNS المُدار عبر Cloudflare دون ميزات غير ضرورية، يبقى هذا النشر القائم على favonia/cloudflare-ddns الخيار الأبسط.
متى لا تستخدمه
تجاوز هذه الأداة إذا كان مزود خدمتك يوفر بالفعل عنوان IP ثابتاً — لا شيء يفعله وكيل DNS ديناميكي إذا كان IP الخاص بك لا يتغيّر أبداً، فمجموعة سجلات A/AAAA بسيطة تُضبط مرة واحدة في Cloudflare كافية. إذا أردت تجنّب إعادة توجيه المنافذ وقواعد الجدار الناري الواردة تماماً، فإن Cloudflare Tunnel أو نفقاً عكسياً مشابهاً خيار أفضل من DDNS، لأنه يُزيل الحاجة لكشف IP الخاص بك أصلاً بدلاً من مجرد إبقائه دقيقاً. إذا كنت تدير DNS لعدة مزودين بجانب Cloudflare وتريد أداة واحدة تغطيهم جميعاً، قد يناسبك عميل عام الغرض مثل ddclient أكثر من وكيل مخصص لـ Cloudflare. وإذا كنت تفضّل بشدة لوحة تحكم ويب بدلاً من قراءة سجلات الحاوية للتأكد من التحديثات، فقد يناسب نهج DDNS-Go المبني على واجهة سير عملك بشكل أفضل.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Cloudflare DDNS؟
إنه وكيل صغير يُبقي سجلات Cloudflare DNS الخاصة بك مرتبطة بـ IP العام الحالي لديك. معظم الاتصالات المنزلية لديها IP ديناميكي يُغيّره مزود الخدمة دون إشعار، مما يُعطّل أي نطاق موجّه لمنزلك.
كيف أُعدّه — هل توجد واجهة ويب؟
لا توجد واجهة ويب. يُعدّ بالكامل عبر متغيرات البيئة: رمز Cloudflare API محدود النطاق، وDOMAINS المطلوب تحديثها، وبضعة خيارات مثل PROXIED وIP6_PROVIDER. تضبط هذه في البيئة، تُشغّل الحاوية، وتتأكد أنها تعمل بقراءة السجلات.
كيف أتحقق أنه يعمل؟
اقرأ سجلات الحاوية بأمر 'docker logs cloudflare-ddns'. تعرض IP العام الذي اكتشفه وكل سجل DNS حدّثه، فيمكنك رؤية نجاحه. حتى المُثبّت يراقب السجلات بحثاً عن كلمات النجاح مباشرة بعد بدء التشغيل.
أي رمز API يجب أن أستخدمه؟
أنشئ رمز API محدود النطاق في Cloudflare بصلاحية تعديل DNS على المنطقة المحددة التي تُحدّثها — وليس مفتاح Global API الخاص بحسابك.
ما الفرق بينه وبين Cloudflare Tunnel؟
يحلان مشكلتين مرتبطتين لكن مختلفتين. DDNS يُبقي سجل DNS دقيقاً كي يشير نطاقك لـ IP منزلك المتغيّر — لا تزال تفتح منافذ على راوترك وتصل للخدمات مباشرة عبر ذلك النطاق. أما Cloudflare Tunnel فيُنشئ اتصالاً صادراً فقط من سيرفرك لحافة Cloudflare، بحيث لا تحتاج أبداً فتح منافذ واردة أو كشف IP العام الخاص بك إطلاقاً. يستخدم كثير من مستضيفي الخدمات الذاتيين كليهما معاً: DDNS للوصول المباشر لبعض الخدمات، وTunnel لأخرى لا ينبغي كشفها مباشرة.