تفاصيل تسجيل الدخول إلى VPN الخاصة بك سيتم إنشاؤها عشوائيًا. راجع [استرداد تفاصيل تسجيل الدخول إلى VPN](#retrieve-vpn-login-details).

بدلاً من ذلك، يمكنك [إعداد IPsec VPN بدون Docker](https://github.com/hwdsl2/setup-ipsec-vpn). لمعرفة المزيد حول كيفية استخدام هذه الصورة، اقرأ الأقسام أدناه.

## المجتمع

- 📬 [اشترك للحصول على تحديثات المشروع](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1–2 رسائل بريد إلكتروني شهريًا) — احصل على أدلة مجانية لنشر VPN والذكاء الاصطناعي (PDF)
- 💬 انضم إلى مجتمع [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) للمناقشات
- ⭐ امنح المستودع نجمة إذا وجدته مفيدًا — فهو يساعد الآخرين على اكتشافه

## المتطلبات

- خادم Linux بعنوان IP عام أو اسم DNS
- تثبيت Docker
- فتح منافذ VPN في جدار الحماية الخاص بك (UDP 500 و4500)
- يمكنك أيضًا استخدام [Podman](https://docs.podman.io) لتشغيل هذه الصورة، بعد إنشاء اسم مستعار لـ `docker`

**ملاحظة:** يمكن للمستخدمين المتقدمين استخدام هذه الصورة على macOS مع [Docker for Mac](https://docs.docker.com/desktop/setup/install/mac-install/). قبل استخدام وضع IPsec/L2TP، قد تحتاج إلى إعادة تشغيل الحاوية مرة واحدة باستخدام `docker restart ipsec-vpn-server`. هذه الصورة لا تدعم Docker for Windows.

## التنزيل

احصل على البنية الموثوقة من [سجل Docker Hub](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/):```bash
docker pull hwdsl2/ipsec-vpn-server

المنصات المدعومة: `linux/amd64` و `linux/arm64` و `linux/arm/v7`.

يمكن للمستخدمين المتقدمين [البناء من الكود المصدري](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#build-from-source-code) على GitHub.

### مقارنة الصور

تتوفر صورتان مبنيتان مسبقًا. الصورة الافتراضية المبنية على Alpine يبلغ حجمها حوالي 19 ميجابايت فقط.

|                   | المبنية على Alpine             | المبنية على Debian                   |
| ----------------- | ------------------------ | ------------------------------ |
| اسم الصورة        | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian |
| الحجم المضغوط   | ~ 19 ميجابايت                  | ~ 62 ميجابايت                        |
| الصورة الأساسية        | Alpine Linux 3.23        | Debian Linux 12                |
| المنصات         | amd64, arm64, arm/v7     | amd64, arm64, arm/v7           |
| إصدار Libreswan | 5.4                      | 5.4                            |
| IPsec/L2TP        | ✅                       | ✅                              |
| Cisco IPsec       | ✅                       | ✅                              |
| IKEv2             | ✅                       | ✅                              |

**ملاحظة:** لاستخدام الصورة المبنية على Debian، استبدل كل `hwdsl2/ipsec-vpn-server` بـ `hwdsl2/ipsec-vpn-server:debian` في هذا README. هذه الصور غير متوافقة حاليًا مع أنظمة Synology NAS.

<details>
<summary>
أريد استخدام إصدار Libreswan الأقدم 4.
</summary>

يُنصح عمومًا باستخدام أحدث إصدار من [Libreswan](https://libreswan.org/) 5، وهو الإصدار الافتراضي في هذا المشروع. ومع ذلك، إذا كنت تريد استخدام إصدار Libreswan الأقدم 4، يمكنك بناء صورة Docker من الكود المصدري:```bash
git clone https://github.com/hwdsl2/docker-ipsec-vpn-server
cd docker-ipsec-vpn-server
# Specify Libreswan version 4
sed -i 's/SWAN_VER=5\..*/SWAN_VER=4.15/' Dockerfile Dockerfile.debian
# To build Alpine-based image
docker build -t hwdsl2/ipsec-vpn-server .
# To build Debian-based image
docker build -f Dockerfile.debian -t hwdsl2/ipsec-vpn-server:debian .

سيؤدي هذا إلى إنشاء حساب مستخدم لتسجيل الدخول إلى VPN، ويمكن استخدامه من قِبل أجهزتك المتعددة[\*](#important-notes). يتم تحديد مفتاح IPsec المشترك مسبقًا (PSK) عبر متغير البيئة `VPN_IPSEC_PSK`. يتم تعريف اسم مستخدم VPN في `VPN_USER`، ويتم تحديد كلمة مرور VPN عبر `VPN_PASSWORD`.

يتم دعم مستخدمي VPN إضافيين، ويمكن تعريفهم اختياريًا في ملف `env` الخاص بك بهذا الشكل. يجب فصل أسماء المستخدمين وكلمات المرور بمسافات، ولا يمكن أن تحتوي أسماء المستخدمين على تكرارات. سيتشارك جميع مستخدمي VPN نفس مفتاح IPsec المشترك مسبقًا.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

في هذا الأمر، نستخدم الخيار `-v` من `docker run` لإنشاء [وحدة تخزين Docker](https://docs.docker.com/storage/volumes/) جديدة باسم `ikev2-vpn-data`، وتركيبها في المسار `/etc/ipsec.d` داخل الحاوية. سيتم حفظ البيانات المتعلقة بـ IKEv2 مثل الشهادات والمفاتيح في وحدة التخزين، وعندما تحتاج لاحقًا إلى إعادة إنشاء حاوية Docker، ما عليك سوى تحديد نفس وحدة التخزين مرة أخرى.

يُوصى بتمكين IKEv2 عند استخدام هذه الصورة. ومع ذلك، إذا كنت تفضل عدم تمكين IKEv2 واستخدام وضعي IPsec/L2TP وIPsec/XAuth ("Cisco IPsec") فقط للاتصال بـ VPN، فقم بإزالة الخيار `-v` الأول من أمر `docker run` أعلاه.

**ملاحظة:** يمكن للمستخدمين المتقدمين أيضًا [التشغيل بدون وضع الامتياز](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#run-without-privileged-mode).

### استرجاع تفاصيل تسجيل الدخول إلى VPN

إذا لم تحدد ملف `env` في أمر `docker run` أعلاه، فسيتم تعيين `VPN_USER` افتراضيًا إلى `vpnuser` وسيتم إنشاء كل من `VPN_IPSEC_PSK` و`VPN_PASSWORD` بشكل عشوائي. لاسترجاعها، اعرض سجلات الحاوية:```bash
docker logs ipsec-vpn-server

سيشمل الإخراج أيضًا تفاصيل وضع IKEv2، إذا كان مفعّلاً.

(اختياري) قم بعمل نسخة احتياطية من تفاصيل تسجيل الدخول إلى VPN المُنشأة (إن وُجدت) إلى الدليل الحالي:```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

مثال `docker-compose.yml` (مضمّن بالفعل):```yaml
volumes:
  ikev2-vpn-data:

services:
  vpn:
    image: hwdsl2/ipsec-vpn-server
    restart: always
    env_file:
      - ./vpn.env
    ports:
      - "500:500/udp"
      - "4500:4500/udp"
    privileged: true
    hostname: ipsec-vpn-server
    container_name: ipsec-vpn-server
    volumes:
      - ikev2-vpn-data:/etc/ipsec.d
      - /lib/modules:/lib/modules:ro

إذا كانت صورة Docker محدّثة بالفعل، يجب أن ترى:```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**ملاحظة:** إذا لم تتمكن من العثور على تفاصيل IKEv2، فقد لا يكون IKEv2 مفعّلاً في الحاوية. جرّب تحديث صورة Docker والحاوية باستخدام التعليمات الواردة في قسم [تحديث صورة Docker](#update-docker-image).

أثناء إعداد IKEv2، يتم إنشاء عميل IKEv2 (باسم افتراضي `vpnclient`)، مع تصدير إعداداته إلى `/etc/ipsec.d` **داخل الحاوية**. لنسخ ملف (ملفات) الإعداد إلى مضيف Docker:```bash
# Check contents of /etc/ipsec.d in the container
docker exec -it ipsec-vpn-server ls -l /etc/ipsec.d
# Example: Copy a client config file from the container
# to the current directory on the Docker host
docker cp ipsec-vpn-server:/etc/ipsec.d/vpnclient.p12 ./