caddy

<p align="center">
	<a href="https://caddyserver.com">
		<picture>
			<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/1d6be89c-df8a-438c-b01d-cef6bf56440a">
			<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/3a5b7419-6925-48f6-ae75-d231f4a4f0c2">
			<img src="https://github.com/user-attachments/assets/3a5b7419-6925-48f6-ae75-d231f4a4f0c2" alt="Caddy" width="550">
		</picture>
	</a>
	<br>
	<h3 align="center">مشروع <a href="https://zerossl.com"><img src="https://user-images.githubusercontent.com/55066419/208327323-2770dc16-ec09-43a0-9035-c5b872c2ad7f.svg" height="28" style="vertical-align: -7.7px" valign="middle"></a></h3>
</p>
<hr>
<h3 align="center">كل موقع على HTTPS</h3>
<p align="center">Caddy هو منصة خادم قابلة للتوسيع تستخدم TLS افتراضيًا.</p>
<p align="center">
	<a href="https://github.com/caddyserver/caddy/releases">الإصدارات</a> ·
	<a href="https://caddyserver.com/docs/">التوثيق</a> ·
	<a href="https://caddy.community">احصل على المساعدة</a>
</p>
<p align="center">
	<a href="https://github.com/caddyserver/caddy/actions/workflows/ci.yml"><img src="https://github.com/caddyserver/caddy/actions/workflows/ci.yml/badge.svg"></a>
	&nbsp;
	<a href="https://www.bestpractices.dev/projects/7141"><img src="https://www.bestpractices.dev/projects/7141/badge"></a>
	&nbsp;
	<a href="https://pkg.go.dev/github.com/caddyserver/caddy/v2"><img src="https://img.shields.io/badge/godoc-reference-%23007d9c.svg"></a>
	&nbsp;
	<a href="https://x.com/caddyserver" title="@caddyserver on Twitter"><img src="https://img.shields.io/twitter/follow/caddyserver" alt="@caddyserver on Twitter"></a>
	&nbsp;
	<a href="https://caddy.community" title="Caddy Forum"><img src="https://img.shields.io/badge/community-forum-ff69b4.svg" alt="Caddy Forum"></a>
	<br>
	<a href="https://sourcegraph.com/github.com/caddyserver/caddy?badge" title="Caddy on Sourcegraph"><img src="https://sourcegraph.com/github.com/caddyserver/caddy/-/badge.svg" alt="Caddy on Sourcegraph"></a>
	&nbsp;
	<a href="https://cloudsmith.io/~caddy/repos/"><img src="https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith" alt="Cloudsmith"></a>
</p>
<p align="center">
	<b>مدعوم بواسطة</b>
	<br>
	<a href="https://github.com/caddyserver/certmagic">
		<picture>
			<source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/55066419/206946718-740b6371-3df3-4d72-a822-47e4c48af999.png">
			<source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png">
			<img src="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png" alt="CertMagic" width="250">
		</picture>
	</a>
</p>

<!-- Warp sponsorship requests this section -->
<div align="center" markdown="1">
	<hr>
	<sup>شكر خاص إلى:</sup>
	<br>
	<a href="https://go.warp.dev/caddy">
		<img alt="Warp sponsorship" width="400" src="https://github.com/user-attachments/assets/c8efffde-18c7-4af4-83ed-b1aba2dda394">
	</a>

### [Warp، مصمم للبرمجة مع عدة وكلاء ذكاء اصطناعي](https://go.warp.dev/caddy)
[متاح لنظام MacOS وLinux وWindows](https://go.warp.dev/caddy)<br>
</div>

<hr>

### القائمة

- [الميزات](#features)
- [التثبيت](#install)
- [البناء من المصدر](#build-from-source)
	- [للتطوير](#for-development)
	- [مع معلومات الإصدار و/أو الإضافات](#with-version-information-andor-plugins)
- [البدء السريع](#quick-start)
- [نظرة عامة](#overview)
- [التوثيق الكامل](#full-documentation)
- [الحصول على المساعدة](#getting-help)
- [حول](#about)


## [الميزات](https://caddyserver.com/features)

- **إعداد سهل** باستخدام [Caddyfile](https://caddyserver.com/docs/caddyfile)
- **إعداد قوي** باستخدام [إعداد JSON الأصلي](https://caddyserver.com/docs/json/)
- **إعداد ديناميكي** باستخدام [واجهة JSON API](https://caddyserver.com/docs/api)
- [**محولات الإعداد**](https://caddyserver.com/docs/config-adapters) إذا كنت لا تحب JSON
- **HTTPS تلقائي** افتراضيًا
	- [ZeroSSL](https://zerossl.com) و[Let's Encrypt](https://letsencrypt.org) للأسماء العامة
	- CA محلي مُدار بالكامل للأسماء الداخلية وعناوين IP
	- يمكنه التنسيق مع نسخ Caddy الأخرى في مجموعة
	- احتياطي متعدد المُصدرين
	- دعم Encrypted ClientHello (ECH)
- **يبقى يعمل عندما تتعطل الخوادم الأخرى** بسبب مشكلات TLS/OCSP/الشهادات
- **جاهز للإنتاج** بعد خدمة تريليونات الطلبات وإدارة ملايين شهادات TLS
- **يتوسع لمئات الآلاف من المواقع** كما ثبت في الإنتاج
- **HTTP/1.1 وHTTP/2 وHTTP/3** جميعها مدعومة افتراضيًا
- **قابل للتوسيع بدرجة عالية** [بنية معيارية](https://caddyserver.com/docs/architecture) تتيح لـ Caddy فعل أي شيء دون تضخم
- **يعمل في أي مكان** مع **عدم وجود تبعيات خارجية** (ولا حتى libc)
- مكتوب بلغة Go، وهي لغة ذات **ضمانات أمان ذاكرة أعلى** من الخوادم الأخرى
- **ممتع فعلاً في الاستخدام**
- هناك الكثير [لاكتشافه](https://caddyserver.com/features)

## التثبيت

أبسط طريقة متعددة المنصات للبدء هي تنزيل Caddy من [إصدارات GitHub](https://github.com/caddyserver/caddy/releases) ووضع الملف التنفيذي في PATH الخاص بك.

راجع [توثيقنا عبر الإنترنت](https://caddyserver.com/docs/install) للحصول على تعليمات تثبيت أخرى.

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

المتطلبات:

- [Go 1.26.0 أو أحدث](https://golang.org/dl/)

### للتطوير

_**ملاحظة:** هذه الخطوات [لن تُضمّن معلومات الإصدار الصحيحة](https://github.com/golang/go/issues/29228). لذلك، يرجى اتباع التعليمات في القسم التالي._

```bash
$ 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` المضمّن هكذا:

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

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

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

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

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

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

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

باستخدام [أداة البناء الخاصة بنا، `xcaddy`](https://github.com/caddyserver/xcaddy)...

```bash
$ xcaddy build
```

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

1. إنشاء مجلد جديد: `mkdir caddy`
2. الانتقال إليه: `cd caddy`
3. نسخ [ملف main.go الخاص بـ Caddy](https://github.com/caddyserver/caddy/blob/master/cmd/caddy/main.go) إلى المجلد الفارغ. أضف عمليات استيراد لأي إضافات مخصصة تريد إضافتها.
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](https://caddyserver.com/docs/) على توثيق يتضمن دروسًا وأدلة بدء سريع ومراجع والمزيد.

**نوصي جميع المستخدمين -- بغض النظر عن مستوى الخبرة -- باتباع دليل [البدء](https://caddyserver.com/docs/getting-started) للتعرف على استخدام Caddy.**

إذا كان لديك دقيقة واحدة فقط، [فالموقع يحتوي على عدة دروس بدء سريع](https://caddyserver.com/docs/quick-starts) للاختيار من بينها! ومع ذلك، بعد إكمال درس بدء سريع، يرجى قراءة المزيد من التوثيق لفهم كيفية عمل البرنامج. 🙂




## نظرة عامة

غالبًا ما يُستخدم Caddy كخادم HTTPS، لكنه مناسب لأي برنامج Go طويل التشغيل. أولاً وقبل كل شيء، هو منصة لتشغيل تطبيقات Go. "تطبيقات" Caddy هي مجرد برامج Go يتم تنفيذها كوحدات Caddy. تطبيقان -- `tls` و`http` -- يُشحنان بشكل قياسي مع Caddy.

تستفيد تطبيقات Caddy فورًا من [التوثيق التلقائي](https://caddyserver.com/docs/json/)، و[تغييرات الإعداد السلسة عبر الإنترنت عبر API](https://caddyserver.com/docs/api)، والتوحيد مع تطبيقات Caddy الأخرى.

على الرغم من أن [JSON](https://caddyserver.com/docs/json/) هي لغة الإعداد الأصلية لـ Caddy، يمكن لـ Caddy قبول المدخلات من [محولات الإعداد](https://caddyserver.com/docs/config-adapters) التي يمكنها أساسًا تحويل أي تنسيق إعداد تختاره إلى JSON: Caddyfile وJSON 5 وYAML وTOML وإعداد NGINX والمزيد.

الطريقة الأساسية لإعداد Caddy هي عبر [واجهة API الخاصة به](https://caddyserver.com/docs/api)، ولكن إذا كنت تفضل ملفات الإعداد، فإن [واجهة سطر الأوامر](https://caddyserver.com/docs/command-line) تدعمها أيضًا.

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

للاستفادة من قوة هذا التصميم، تحتاج إلى معرفة كيفية هيكلة مستند الإعداد. يرجى الاطلاع على [موقع التوثيق الخاص بنا](https://caddyserver.com/docs/) للحصول على تفاصيل حول [هيكل إعداد Caddy](https://caddyserver.com/docs/json/).

يحتوي تقريبًا كل إعداد Caddy في مستند إعداد واحد، بدلاً من أن يكون مبعثرًا عبر أعلام CLI ومتغيرات البيئة وملف إعداد كما هو الحال مع خوادم الويب الأخرى. هذا يجعل إدارة إعداد الخادم الخاص بك أكثر وضوحًا ويقلل من المتغيرات/العوامل الخفية.


## التوثيق الكامل

موقعنا يحتوي على توثيق كامل:

**https://caddyserver.com/docs/**

التوثيق مفتوح المصدر أيضًا. يمكنك المساهمة فيه هنا: https://github.com/caddyserver/website



## الحصول على المساعدة

- ننصح الشركات التي تستخدم Caddy بتأمين عقد دعم عبر [Ardan Labs](https://www.ardanlabs.com) قبل الحاجة إلى المساعدة.

- [الرعاية](https://github.com/sponsors/mholt) تساعد كثيرًا! يمكننا تقديم مساعدة خاصة للرعاة. إذا كان Caddy يفيد شركتك، يرجى التفكير في الرعاية. هذا لا يساعد فقط في تمويل العمل بدوام كامل لضمان استمرارية المشروع، بل يوفر لشركتك الموارد والدعم والخصومات التي تحتاجها؛ إلى جانب كونه مظهرًا رائعًا لشركتك لدى عملائك والعملاء المحتملين!

- يمكن للأفراد تبادل المساعدة مجانًا على منتدى المجتمع الخاص بنا على https://caddy.community. تذكر أن الناس يقدمون المساعدة من وقتهم الحر وحسن نيتهم. أفضل طريقة للحصول على المساعدة هي تقديمها أولاً!

يرجى استخدام [متتبع المشكلات](https://github.com/caddyserver/caddy/issues) الخاص بنا فقط للإبلاغ عن الأخطاء وطلبات الميزات، أي عناصر التطوير القابلة للتنفيذ (عادةً ما تُحال أسئلة الدعم إلى المنتديات).



## حول

بدأ Matthew Holt تطوير Caddy في عام 2014 أثناء دراسته لعلوم الحاسوب في جامعة Brigham Young. (تم اختيار اسم "Caddy" لأن هذا البرنامج يساعد في المهام المملة والروتينية لخدمة الويب، وهو أيضًا مكان واحد لتنظيم أشياء متعددة معًا.) سرعان ما أصبح أول خادم ويب يستخدم HTTPS تلقائيًا وافتراضيًا، والآن لديه مئات المساهمين وقد خدم تريليونات طلبات HTTPS.

**اسم "Caddy" علامة تجارية مسجلة.** اسم البرنامج هو "Caddy"، وليس "Caddy Server" أو "CaddyServer". يرجى تسميته "Caddy" أو، إذا كنت ترغب في التوضيح، "خادم الويب Caddy". Caddy علامة تجارية مسجلة لشركة Stack Holdings GmbH.

- _المشروع على X: [@caddyserver](https://x.com/caddyserver)_
- _المؤلف على X: [@mholt6](https://x.com/mholt6)_

Caddy هو مشروع من [ZeroSSL](https://zerossl.com)، وهي شركة تابعة لـ HID Global.

استضافة مستودع حزم Debian مقدمة بكرم من [Cloudsmith](https://cloudsmith.com). Cloudsmith هو الحل الوحيد المُستضاف بالكامل، السحابي الأصلي، لإدارة الحزم الشاملة، الذي يمكّن مؤسستك من إنشاء وتخزين ومشاركة الحزم بأي تنسيق، إلى أي مكان، بثقة تامة.