أتمتة تحديثات DNS الديناميكي في Cloudflare باستخدام GhostlyDDns
أداة سطر أوامر .NET 10 تركز على الخصوصية لمزامنة سجلات DNS في Cloudflare مع عنوان IP الديناميكي الخاص بك. بدون تتبع، تكوين YAML، ودعم متعدد الأنظمة.
GhostlyDDns هو وكيل سطر أوامر dotnet 8 يركز على الخصوصية، يحافظ على مزامنة سجلات A و AAAA الموجودة في Cloudflare مع عنوان IP العام لشبكتك. جزء من مجموعة Ghostly Tools ويوفر للمطورين والمبدعين والمستضيفين ذاتياً مسار أتمتة موثوق لتحديث DNS الديناميكي في Cloudflare دون الحاجة لخدمات مُدارة.
يراقب البرنامج عنوان WAN الخاص بك، يكتشف تغييرات IPv4 و IPv6 عبر نقاط نهاية متعددة، ويتصل بواجهة Cloudflare API فقط عند الحاجة لتحديث. يوفر Serilog تشخيصات منظمة، وتأخير تصاعدي منضبط، ورموز خروج ثابتة تمنح الفرق القدرة على المراقبة اللازمة للتشغيل بدون إشراف.
GhostlyDDns من Ghostly Tools، برنامج يركز على الخصوصية من GhostlyInc، يقدم طبقة أتمتة خفيفة للشبكات المستضافة ذاتياً التي تحتاج إلى دقة مستمرة في Cloudflare دون تعريض بيانات الاعتماد لخدمات SaaS خارجية.

فهرس المحتويات
الإصدارات والترخيص
اختر إصدار GhostlyDDns المتوافق مع نظام التشغيل الخاص بك. كل ترخيص من Gumroad يشمل تحديثات مدى الحياة لجميع إصدارات GhostlyDDns 1.x، ونفس ملف تكوين YAML يعمل عبر جميع الإصدارات.
تتضمن كل رخصة تحديثات دائمة لجميع إصدارات GhostlyDDns 1.x.
أبرز الميزات
تشغيل يركز على الخصوصية
شغّل GhostlyDDns بالكامل على بنيتك التحتية دون تتبع، أو ربط حساب، أو تحكم خارجي.
تحديثات مدركة للتغييرات
اكتشاف IP من عدة نقاط نهاية، تخزين مؤقت في الذاكرة، وتأخير تصاعدي منضبط لإلغاء المكالمات المكررة لواجهة Cloudflare API.
نشر عبر منصات متعددة
يتم نشر ملفات ثنائية .NET 8 كملف واحد لأنظمة ويندوز، لينكس، وARM64 لتتمكن من استخدام نفس ملف التكوين في كل مكان.
أمثلة على حالات الاستخدام
يساعد GhostlyDDns الفرق المستضيفة ذاتياً والوكالات والموظفين عن بُعد على الحفاظ على استمرارية الخدمة من خلال إلغاء التحديثات اليدوية لسجلات DNS عند تغيير عناوين WAN.
- حافظ على بوابات VPN في المختبر المنزلي متاحة بعد كل تجديد عقد مزود الإنترنت دون تعريض أجهزة التوجيه للإدارة عن بُعد.
- حافظ على بوابات العملاء ذات العلامة البيضاء على Cloudflare أثناء تشغيل تطبيقاتك من اتصالات مكتبية ديناميكية.
- احمِ معدات البث أو الاستوديوهات الإبداعية من خلال تحديث نطاقات البث المستقبلة حتى عند تفعيل التحويل إلى الشبكات المحمولة.
- دعم مزودي الخدمات المدارة الذين يديرون عدة مناطق عملاء باستخدام وكيل أتمتة خفيف واحد.
أوامر سطر الأوامر
يوفر CLI الخاص بـ GhostlyDDns أوامر مركزة لإنشاء التكوين، التجارب الجافة، التنفيذ الفردي، والمراقبة المستمرة. المساعدة مدمجة ومتاحة عبر عدة خيارات.
ghostly-ddns init-config [--path|--p|-p <path>]
ghostly-ddns dry --config|--c|-c <path>
ghostly-ddns once --config|--c|-c <path>
ghostly-ddns run --config|--c|-c <path>
ghostly-ddns --help | --h | -h
ghostly-ddns --version | --v | -vمخطط التكوين
تُخزن جميع إعدادات التشغيل في ملف YAML واحد. قدم رمز API الخاص بـ Cloudflare، فترة الاستطلاع، تفضيلات اكتشاف IP، مدة الاحتفاظ بالسجلات، والسجلات التي يجب الحفاظ عليها. يتحقق GhostlyDDns من صحة المخطط عند بدء التشغيل وينتج تحذيرات قابلة للتنفيذ عند نقص القيم.
cloudflare:
api_token: CF_API_TOKEN
update:
interval_seconds: 120
ip_detection:
detect_ipv4: true
detect_ipv6: false
v4_endpoints:
- https://api.ipify.org
- https://ipv4.icanhazip.com
v6_endpoints:
- https://api6.ipify.org
logging:
retention_days: 30
records:
- name: home.example.com
type: A
proxied: true
ttl: autoتضمن قواعد التحقق وجود رمز API، تعريف سجل واحد على الأقل، قيم TTL إما تلقائية أو أكبر من ستين، وكل كاشف مفعل يحتوي على نقطة نهاية واحدة على الأقل.
التسجيل والتشخيص
يستخدم Serilog لإخراج منظم على وحدة التحكم مع سجلات ملفات متجددة مخزنة في مجلد logs. مدة الاحتفاظ الافتراضية 30 ملف يومي ويمكن تخصيصها حسب النشر عبر تكوين YAML.
توثق سجلات التشغيل عناوين IP المكتشفة، التحديثات المتخطاة عند عدم وجود تغييرات، رموز حالة Cloudflare، ونشاط إعادة المحاولة الناتج عن سياسة التأخير التصاعدي. هذه التشخيصات تجعل GhostlyDDns جاهزاً للإنتاج والتشغيل بدون إشراف.
أدلة النشر
يأتي GhostlyDDns مع إرشادات لمؤقتات systemd في لينكس وقوالب جدولة مهام ويندوز لتمكين الفرق من توحيد الأتمتة خلال دقائق.
خدمة systemd في لينكس
ثبت الملف التنفيذي في usr/local/bin، وضع التكوين في etc/GhostlyDDns، وشغّل الوكيل بحساب خدمة مخصص.
[Unit]
Description=GhostlyDDns updater
After=network-online.target
[Service]
Type=simple
ExecStart=/usr/local/bin/ghostly-ddns run --config /etc/GhostlyDDns/config.yaml
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetمؤقت systemd في لينكس
اربط المؤقت بالخدمة لجدولة تنفيذ متكرر واعتمد على التأخير التصاعدي عند انقطاع الاتصال بـ Cloudflare.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetجدولة مهام ويندوز
استورد القالب الرسمي XML أو أنشئ مهمة بأعلى الصلاحيات لتشغيل الأمر run كل بضع دقائق وإعادة التشغيل عند الفشل.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
/RL HIGHEST ^
/F- مسار البرنامج C GhostlyDDns ghostly-ddns.exe
- الوسائط run --config C GhostlyDDns config.yaml
- تُكتب السجلات بجانب الملف التنفيذي داخل مجلد logs
الأسئلة المتكررة
استكشف إجابات سريعة حول قدرات GhostlyDDns ومتطلبات Cloudflare والممارسات التشغيلية قبل النشر في بيئة الإنتاج.
معلومات دعم GhostlyDDns
الخطوات التالية
اختر إصدار GhostlyDDns المفضل لديك، حمّل الملف التنفيذي من Gumroad، وابدأ استخدامه مع أدوات Ghostly الأخرى التي تركز على الخصوصية من GhostlyInc.
الموارد ذات الصلة
استعرض هذه الأدلة لتعزيز بنيتك التحتية التي تركز على الخصوصية وإدارة DNS