كيفية تشغيل Caddy كخادم ويب على نظام التشغيل Windows Server

لتشغيل Caddy على نظام Windows Server، ثبّت ملف التشغيل الأصلي الخاص به، ووجّه ملف Caddyfile إلى مجلد موقعك الإلكتروني، وسجّل Caddy كخدمة Windows. يُتيح هذا الإعداد عرض الملفات الثابتة، كما يُمكنه الحصول على شهادات HTTPS وتجديدها تلقائيًا للنطاق العام. استخدام Docker اختياري؛ فالخطوات التالية لا تتطلب بيئة تشغيل حاويات.

تستخدم الأوامر C:\Caddyنطاقًا افتراضيًا. شغّل PowerShell كمسؤول عند إنشاء قواعد جدار الحماية أو تثبيت الخدمة.

1. قم بتنزيل برنامج Caddy لنظام التشغيل Windows

افتح صفحة تنزيل Caddy الرسمية واختر إصدار Windows المناسب لبنية خادمك. إذا كنت تستخدم إصدار GitHub، فاختر ملف Windows المطابق. استخرج الملفات أو انسخها caddy.exeإلى المجلد المطلوب C:\Caddy. يشرح دليل تثبيت Caddy أيضًا كيفية التعامل مع الملفات الثنائية الثابتة والتحقق من التوقيع.

2. أنشئ مجلدًا للموقع الإلكتروني

في PowerShell، أنشئ مجلدًا رئيسيًا وصفحة اختبار صغيرة. استبدل ملف الاختبار هذا بملفات موقعك عندما تكون جاهزًا:

New-Item -ItemType Directory -Force C:\Caddy\site | Out-Null
Set-Content -Path C:\Caddy\site\index.html -Value '<h1>Hello from Caddy</h1>' -Encoding utf8

3. أنشئ ملف Caddyfile محليًا

افتح برنامج المفكرة notepad C:\Caddy\Caddyfile. إذا طُلب منك إنشاء ملف، فاختر "نعم". أدخل هذا التكوين، ثم احفظه باسم Caddyfileبدون .txtامتداد:

:8080 {
    root * C:/Caddy/site
    file_server
}

يُحدد هذا rootالتوجيه الدليل ويُقدم file_serverملفاته. يُسهّل استخدام منفذ محلي عالي المستوى عملية الاختبار قبل التبديل إلى منافذ HTTP وHTTPS العامة. راجع المراجع الرسمية لـ root و file_server .

4. التحقق من صحة الموقع واختباره

في PowerShell، انتقل إلى مجلد Caddy، وتحقق من صحة التكوين، ثم ابدأ تشغيل Caddy في المقدمة:

Set-Location C:\Caddy
.\caddy.exe validate --config .\Caddyfile
.\caddy.exe run --config .\Caddyfile

أثناء بقاء تلك النافذة مفتوحة، انتقل إلى http://localhost:8080الخادم. يجب أن ترى عنوان الاختبار. يستخدم هذا الفحص المحلي بروتوكول HTTP عمدًا؛ أوقف العملية الأمامية Ctrl+Cقبل تغيير الملف الخاص بنطاقك العام.

5. قم بتهيئة نطاقك الحقيقي

قم بتعديل C:\Caddy\Caddyfileواستبدال إعدادات الاختبار بنطاقك الخاص ومجلد المستندات الرئيسي:

www.example.com {
    root * C:/Caddy/site
    file_server
}

استبدل www.example.comهذا النطاق بنطاق تتحكم به. باستخدام اسم المضيف في عنوان الموقع، يستطيع Caddy إدارة شهادات TLS العامة وإعادة توجيه HTTP إلى HTTPS. يتطلب الإصدار التلقائي أن يُشير اسم المضيف إلى هذا الخادم وأن تصل إليه حركة مرور التحدي ذات الصلة. راجع متطلبات HTTPS التلقائية لـ Caddy قبل بدء التشغيل.

6. السماح بحركة مرور الويب العامة

أنشئ سجل DNS من النوع A، وإذا كان خادمك يدعم IPv6، فأنشئ سجلات AAAA التي تشير إلى عنوان الخادم العام. في نافذة PowerShell بصلاحيات المسؤول، أضف قاعدة جدار حماية Windows واردة لمنفذي TCP 80 و443.

New-NetFirewallRule -DisplayName "Caddy HTTP and HTTPS" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 80,443

اسمح أيضًا بمرور هذه المنافذ عبر أي جدار حماية سحابي أو جهاز توجيه أو مجموعة أمان شبكة أمام الخادم. يستخدم Caddy المنفذ 80 لمعالجة HTTP والتحقق من صحة ACME الشائعة، والمنفذ 443 لـ HTTPS. يُعدّ UDP 443 اختياريًا لـ HTTP/3. توثّق مايكروسوفت الأمر cmdlet New-NetFirewallRule .

7. تشغيل Caddy كخدمة Windows

احتفظ بإعدادات النطاق كما هي، ثم افتح نافذة PowerShell بصلاحيات المسؤول. يدعم دليل خدمة Caddy الرسمي نظامي التشغيل sc.exeWindows وWindows Server. لتشغيل الخدمة مباشرةً، سجّل الملف التنفيذي باستخدام مسار التكوين المحدد، ثم ابدأ تشغيله.

sc.exe create caddy start= auto binPath= '"C:\Caddy\caddy.exe" run --config C:\Caddy\Caddyfile'
sc.exe start caddy

تعمل خدمات ويندوز تحت حساب خدمة. تأكد من أن هذا الحساب لديه صلاحية قراءة ملفات الموقع والتكوين، وصلاحية الكتابة إلى دليل بيانات Caddy الدائم، الذي يخزن مواد الشهادات المُدارة. لا تتعامل مع هذا الدليل على أنه قابل للحذف؛ راجع اصطلاحات دليل Caddy وتعليمات خدمة ويندوز .

8. التحقق من بروتوكول HTTPS وحل المشكلات

تحقق من حالة الخدمة باستخدام الأمر المناسب sc.exe query caddy، ثم افتح الموقع https://www.example.comباستخدام اسم المضيف الفعلي. إذا لم يتم تحميل الموقع، فتحقق من سجلات نظام أسماء النطاقات (DNS)، وجدران الحماية في نظام التشغيل Windows والشبكة، وما إذا كان برنامج آخر يستخدم المنفذين 80 أو 443. يمكنك فحص المستمعين باستخدام الأمر التالي:

Get-NetTCPConnection -State Listen -LocalPort 80,443

إذا أبلغ Caddy عن خطأ في الشهادة أو التحدي، فتأكد من أن نظام أسماء النطاقات العام يشير إلى هذا الخادم وأن اتصالات TCP الواردة على المنفذين 80 و443 تصل إليه. لإجراء تعديلات على الإعدادات، تحقق من صحة الملف مرة أخرى، ثم أعد تحميل Caddy C:\Caddy\caddy.exe reload --config C:\Caddy\Caddyfile. يغطي دليل بدء استخدام Caddy ودليل استكشاف الأخطاء وإصلاحها إعدادات وأخطاء إضافية.