أتمتة DNS الديناميكي لـ Cloudflare باستخدام GhostlyDDns
أداة CLI من .NET 10 تركز على الخصوصية لمزامنة سجلات DNS في Cloudflare مع عنوان IP الديناميكي الخاص بك. بدون تتبع، تكوين YAML، ودعم متعدد الأنظمة.
GhostlyDDns هو وكيل سطر أوامر من dotnet 8 يركز على الخصوصية، يحافظ على مزامنة سجلات A و AAAA الموجودة في Cloudflare مع عنوان IP العام لشبكتك الطرفية. هو جزء من مجموعة Ghostly Tools ويوفر للمطورين والمبدعين والمستضيفين ذاتياً مسار أتمتة موثوق لـ DNS الديناميكي في Cloudflare دون الحاجة لخدمات مُدارة.
يراقب وقت التشغيل عنوان WAN الخاص بك، يكتشف تغييرات IPv4 و IPv6 عبر نقاط نهاية متعددة، ويتصل بواجهة برمجة تطبيقات Cloudflare فقط عند الحاجة لتحديث. يوفر التشخيص المعتمد على 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 في المختبر المنزلي متاحة بعد كل تجديد عقد ISP دون تعريض أجهزة التوجيه للإدارة عن بُعد.
- حافظ على بوابات العملاء ذات العلامة البيضاء على Cloudflare أثناء تشغيل تطبيقاتك من اتصالات مكتبية ديناميكية.
- احمِ معدات البث أو الاستوديوهات الإبداعية من خلال تحديث نطاقات البث المستقبلة حتى عند تفعيل التحويل إلى الشبكات المحمولة.
- دعم مزودي الخدمات المدارة الذين يديرون عدة مناطق عملاء باستخدام وكيل أتمتة خفيف واحد.
أوامر CLI
يوفر 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 dash ddns.exe
- الوسائط run double dash config C GhostlyDDns config.yaml
- تُكتب السجلات بجانب الملف التنفيذي ضمن مجلد logs
الأسئلة المتكررة
استكشف إجابات سريعة حول قدرات GhostlyDDns ومتطلبات Cloudflare والممارسات التشغيلية قبل النشر في بيئة الإنتاج.
رؤى دعم GhostlyDDns
الخطوات التالية
اختر إصدار GhostlyDDns المفضل لديك، حمّل الملف الثنائي من Gumroad، وابدأ استخدامه مع أدوات Ghostly الأخرى التي تركز على الخصوصية من GhostlyInc.
الموارد ذات الصلة
استعرض هذه الأدلة لتعزيز بنيتك التحتية التي تركز على الخصوصية وإدارة DNS