caddy

مشروع

---

كل موقع على HTTPS

Caddy هو منصة خادم قابلة للتوسيع تستخدم TLS افتراضيًا.

الإصدارات · التوثيق · احصل على المساعدة

       
 

مدعوم بواسطة

---

القائمة

• الميزات
• التثبيت
• البناء من المصدر
  • للتطوير
  • مع معلومات الإصدار و/أو الإضافات
• البدء السريع
• نظرة عامة
• التوثيق الكامل
• الحصول على المساعدة
• حول

الميزات

• إعداد سهل باستخدام Caddyfile
• إعداد قوي باستخدام إعداد JSON الأصلي
• إعداد ديناميكي باستخدام واجهة JSON API
• محولات الإعداد إذا كنت لا تحب JSON
• HTTPS تلقائي افتراضيًا
  • ZeroSSL وLet's Encrypt للأسماء العامة
  • CA محلي مُدار بالكامل للأسماء الداخلية وعناوين IP
  • يمكنه التنسيق مع نسخ Caddy الأخرى في مجموعة
  • احتياطي متعدد المُصدرين
  • دعم Encrypted ClientHello (ECH)
• يبقى يعمل عندما تتعطل الخوادم الأخرى بسبب مشكلات TLS/OCSP/الشهادات
• جاهز للإنتاج بعد خدمة تريليونات الطلبات وإدارة ملايين شهادات TLS
• يتوسع لمئات الآلاف من المواقع كما ثبت في الإنتاج
• HTTP/1.1 وHTTP/2 وHTTP/3 جميعها مدعومة افتراضيًا
• قابل للتوسيع بدرجة عالية بنية معيارية تتيح لـ Caddy فعل أي شيء دون تضخم
• يعمل في أي مكان مع عدم وجود تبعيات خارجية (ولا حتى libc)
• مكتوب بلغة Go، وهي لغة ذات ضمانات أمان ذاكرة أعلى من الخوادم الأخرى
• ممتع فعلاً في الاستخدام
• هناك الكثير لاكتشافه

التثبيت

أبسط طريقة متعددة المنصات للبدء هي تنزيل Caddy من إصدارات GitHub ووضع الملف التنفيذي في PATH الخاص بك.

راجع توثيقنا عبر الإنترنت للحصول على تعليمات تثبيت أخرى.

البناء من المصدر

المتطلبات:

• Go 1.26.0 أو أحدث

للتطوير

ملاحظة: هذه الخطوات لن تُضمّن معلومات الإصدار الصحيحة. لذلك، يرجى اتباع التعليمات في القسم التالي.

$ git clone "https://github.com/caddyserver/caddy.git"
$ cd caddy/cmd/caddy/
$ go build

عند تشغيل Caddy، قد يحاول الارتباط بالمنافذ المنخفضة ما لم يُحدد خلاف ذلك في إعدادك. إذا كان نظام التشغيل الخاص بك يتطلب صلاحيات مرتفعة لذلك، فستحتاج إلى منح الملف التنفيذي الجديد الإذن للقيام بذلك. على Linux، يمكن القيام بذلك بسهولة باستخدام: sudo setcap cap_net_bind_service=+ep ./caddy

إذا كنت تفضل استخدام go run الذي ينشئ ملفات تنفيذية مؤقتة فقط، فلا يزال بإمكانك القيام بذلك باستخدام setcap.sh المضمّن هكذا:

$ go run -exec ./setcap.sh main.go

إذا كنت لا تريد كتابة كلمة المرور الخاصة بك لـ setcap، فاستخدم sudo visudo لتحرير ملف sudoers والسماح لحساب المستخدم الخاص بك بتشغيل هذا الأمر دون كلمة مرور، على سبيل المثال:

username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap

مع استبدال username باسم المستخدم الفعلي الخاص بك. يرجى توخي الحذر والقيام بذلك فقط إذا كنت تعرف ما تفعله! نحن مؤهلون فقط لتوثيق كيفية استخدام Caddy، وليس أدوات Go أو جهاز الكمبيوتر الخاص بك، ونحن نقدم هذه التعليمات للراحة فقط؛ يرجى تعلم كيفية استخدام جهاز الكمبيوتر الخاص بك على مسؤوليتك الخاصة وإجراء أي تعديلات ضرورية.

ثم يمكنك تشغيل الاختبارات في جميع الوحدات أو في وحدة محددة:

$ go test ./...
$ go test ./modules/caddyhttp/tracing/

مع معلومات الإصدار و/أو الإضافات

باستخدام أداة البناء الخاصة بنا، xcaddy...

$ xcaddy build

...يتم أتمتة الخطوات التالية:

1. إنشاء مجلد جديد: mkdir caddy
2. الانتقال إليه: cd caddy
3. نسخ ملف main.go الخاص بـ Caddy إلى المجلد الفارغ. أضف عمليات استيراد لأي إضافات مخصصة تريد إضافتها.
4. تهيئة وحدة Go: go mod init caddy
5. (اختياري) تثبيت إصدار Caddy: go get github.com/caddyserver/caddy/v2@version مع استبدال version بوسم git أو commit أو اسم فرع.
6. (اختياري) إضافة الإضافات بإضافة استيرادها: _ "import/path/here"
7. الترجمة: go build -tags=nobadger,nomysql,nopgx

البدء السريع

يحتوي موقع Caddy على توثيق يتضمن دروسًا وأدلة بدء سريع ومراجع والمزيد.

نوصي جميع المستخدمين -- بغض النظر عن مستوى الخبرة -- باتباع دليل البدء للتعرف على استخدام Caddy.

إذا كان لديك دقيقة واحدة فقط، فالموقع يحتوي على عدة دروس بدء سريع للاختيار من بينها! ومع ذلك، بعد إكمال درس بدء سريع، يرجى قراءة المزيد من التوثيق لفهم كيفية عمل البرنامج. 🙂

نظرة عامة