openvpn-install

مثبّت OpenVPN لأنظمة Debian وUbuntu وFedora وopenSUSE وCentOS وAmazon Linux وArch Linux وOracle Linux وRocky Linux وAlmaLinux.

سيمكّنك هذا السكربت من إعداد وإدارة خادم VPN آمن خاص بك في ثوانٍ معدودة.

ما هذا؟

صُمم هذا السكربت ليعمل على خادمك الخاص، سواء كان VPS أو خادمًا مخصصًا، أو حتى جهاز كمبيوتر في المنزل.

بعد الإعداد، ستتمكن من إنشاء ملفات إعدادات العميل لكل جهاز تريد توصيله.

سيتمكن كل عميل من توجيه حركة مرور الإنترنت الخاصة به عبر الخادم، مع تشفير كامل.```mermaid graph LR A[Phone] -->|Encrypted| VPN B[Laptop] -->|Encrypted| VPN C[Computer] -->|Encrypted| VPN

VPN[OpenVPN Server]

VPN --> I[Internet]

## لماذا OpenVPN؟

كان OpenVPN المعيار الفعلي لشبكات VPN مفتوحة المصدر عند إنشاء هذا السكربت. جاء WireGuard لاحقًا وهو أبسط وأسرع لمعظم حالات الاستخدام. اطّلع على [wireguard-install](https://github.com/angristan/wireguard-install).

ومع ذلك، لا يزال OpenVPN خيارًا منطقيًا عندما تحتاج إلى:

- **دعم TCP**: يعمل في البيئات التقييدية التي يُحظر فيها UDP (شبكات الشركات، المطارات، الفنادق، إلخ.)
- **مفاتيح خاصة محمية بكلمة مرور**: تخزّن إعدادات WireGuard المفتاح الخاص كنص عادي
- **التوافق مع الأنظمة القديمة**: يتوفر عملاء لكل المنصات تقريبًا، بما في ذلك الأنظمة الأقدم

## الميزات

- تثبيت وإعداد خادم OpenVPN جاهز للاستخدام
- واجهة سطر أوامر للأتمتة والبرمجة النصية (وضع غير تفاعلي مع مخرجات JSON)
- تجديد الشهادات لكل من شهادات العميل والخادم
- عرض ومراقبة العملاء المتصلين
- فصل فوري للعميل عند إبطال الشهادة (عبر واجهة الإدارة)
- استخدام [مستودعات OpenVPN الرسمية](https://community.openvpn.net/openvpn/wiki/OpenvpnSoftwareRepos) عندما يكون ذلك ممكنًا للحصول على أحدث الإصدارات المستقرة
- إدارة قواعد جدار الحماية وإعادة التوجيه بسلاسة (دعم أصلي لـ firewalld و nftables، مع ارتداد إلى iptables)
- شبكات فرعية قابلة للتهيئة لـ VPN (IPv4: الافتراضي `10.8.0.0/24`، IPv6: الافتراضي `fd42:42:42:42::/112`)
- MTU نفق قابل للتهيئة (الافتراضي: `1500`)
- عند الحاجة، يمكن للسكربت إزالة OpenVPN بشكل نظيف، بما في ذلك الإعدادات وقواعد جدار الحماية
- إعدادات تشفير قابلة للتخصيص، مع إعدادات افتراضية محسّنة (انظر [الأمان والتشفير](#security-and-encryption) أدناه)
- استخدام أحدث ميزات OpenVPN عند توفرها (انظر [الأمان والتشفير](#security-and-encryption) أدناه)
- مجموعة متنوعة من محللات DNS ليتم دفعها إلى العملاء
- خيار استخدام محلل مستضاف ذاتيًا عبر Unbound (يدعم تثبيتات Unbound الموجودة مسبقًا)
- الاختيار بين TCP و UDP
- دعم مرن لـ IPv4/IPv6:
  - نقطة نهاية الخادم IPv4 أو IPv6 (كيفية اتصال العملاء)
  - عملاء IPv4 فقط، أو IPv6 فقط، أو ثنائي الرصة (عنونة VPN والوصول إلى الإنترنت)
  - جميع التركيبات مدعومة: 4→4، 4→4/6، 4→6، 6→4، 6→6، 6→4/6
  - منع تسرب تلقائي: حظر البروتوكول غير المرغوب فيه في أوضاع الرصة الأحادية
- وضع بصلاحيات منخفضة: التشغيل كـ `nobody`/`nogroup`
- حظر تسريبات DNS على ويندوز 10
- اسم عشوائي لشهادة الخادم
- خيار حماية العملاء بكلمة مرور (تشفير المفتاح الخاص)
- خيار السماح لأجهزة متعددة باستخدام نفس ملف تعريف العميل في نفس الوقت (يعطّل عناوين IP الثابتة)
- **مصادقة بصمة النظير** (OpenVPN 2.6+): مصادقة مبسّطة شبيهة بـ WireGuard بدون مرجعية تصديق (CA)
- والعديد من الأشياء الصغيرة الأخرى!

## التوافق

يدعم السكربت توزيعات Linux التالية:

|                     | الدعم |
| ------------------- | ------- |
| AlmaLinux >= 8      | ✅ 🤖   |
| Amazon Linux 2023   | ✅ 🤖   |
| Arch Linux          | ✅ 🤖   |
| CentOS Stream >= 8  | ✅ 🤖   |
| Debian >= 11        | ✅ 🤖   |
| Fedora >= 40        | ✅ 🤖   |
| openSUSE Leap >= 16 | ✅ 🤖   |
| openSUSE Tumbleweed | ✅ 🤖   |
| Oracle Linux >= 8   | ✅ 🤖   |
| Rocky Linux >= 8    | ✅ 🤖   |
| Ubuntu >= 18.04     | ✅ 🤖   |

مما تجب ملاحظته:

- يتم اختبار السكربت بانتظام ضد التوزيعات الموسومة بـ 🤖 فقط.
  - يتم اختباره على بنية `amd64` فقط.
- يتطلب السكربت `systemd`.

### المزوّدون الموصى بهم

- [Vultr](https://umami.stanislas.cloud/q/1HH9Thp8i): مواقع حول العالم، دعم IPv6، يبدأ من \$2.5 شهريًا
- [Hetzner](https://umami.stanislas.cloud/q/HdzaOJWq7): مواقع حول العالم، IPv6، 20 تيرابايت من حركة المرور، يبدأ من €3.59 شهريًا
- [Digital Ocean](https://umami.stanislas.cloud/q/sEVh1l79B): مواقع حول العالم، دعم IPv6، يبدأ من \$4 شهريًا

## الاستخدام

أولاً، نزّل السكربت على خادمك واجعله قابلاً للتنفيذ:```bash
curl -O https://raw.githubusercontent.com/angristan/openvpn-install/master/openvpn-install.sh
chmod +x openvpn-install.sh

تحتاج إلى تشغيل السكربت بصلاحيات root وتفعيل وحدة TUN.

الوضع التفاعلي

أسهل طريقة للبدء هي القائمة التفاعلية:```bash ./openvpn-install.sh interactive

سيرشدك هذا خلال عملية التثبيت وإدارة العملاء.

في مجلدك الرئيسي، سيكون لديك ملفات `.ovpn`. هذه هي ملفات إعدادات العملاء. نزّلها من خادمك (باستخدام `scp` على سبيل المثال) واتصل باستخدام عميل OpenVPN المفضل لديك.

إذا كان لديك أي سؤال، توجه إلى [الأسئلة الشائعة](#faq) أولاً. وإذا كنت بحاجة إلى مساعدة، يمكنك فتح [نقاش](https://github.com/angristan/openvpn-install/discussions). يرجى البحث في المشكلات والنقاشات الموجودة أولاً.

### وضع CLI

> [!WARNING]
> لا يُضمن التوافق مع واجهة برمجة التطبيقات (API). قد تحدث تغييرات جذرية بين الإصدارات. إذا كنت تستخدم هذا السكربت برمجيًا (مثلًا في الأتمتة أو CI/CD)، فثبّت الإصدار على commit محدد بدلاً من استخدام فرع master.

للأتمتة والبرمجة النصية، استخدم واجهة سطر الأوامر:```bash
# Install with defaults
./openvpn-install.sh install

# Add a client
./openvpn-install.sh client add alice

# List clients
./openvpn-install.sh client list

# Revoke a client (immediately disconnects if connected)
./openvpn-install.sh client revoke alice

الأوامر```text

openvpn-install [options]

Commands: install Install and configure OpenVPN server uninstall Remove OpenVPN server client Manage client certificates server Server management interactive Launch interactive menu

Global Options: --verbose Show detailed output --log Log file path (default: openvpn-install.log) --no-log Disable file logging --no-color Disable colored output -h, --help Show help

شغّل `./openvpn-install.sh <command> --help` للحصول على الخيارات الخاصة بالأوامر المحددة.

#### إدارة العملاء```bash
# Add a new client
./openvpn-install.sh client add alice

# Add a password-protected client
./openvpn-install.sh client add bob --password

# Revoke a client
./openvpn-install.sh client revoke alice

# Renew a client certificate
./openvpn-install.sh client renew bob --cert-days 365

قائمة بجميع العملاء:```text $ ./openvpn-install.sh client list ══ Client Certificates ══ [INFO] Found 3 client certificate(s)

Name Status Expiry Remaining

---

alice Valid 2035-01-15 3650 days bob Valid 2035-01-15 3650 days charlie Revoked 2035-01-15 unknown

مخرجات JSON للبرمجة النصية:```text
$ ./openvpn-install.sh client list --format json | jq
{
  "clients": [
    {
      "name": "alice",
      "status": "valid",
      "expiry": "2035-01-15",
      "days_remaining": 3650
    },
    {
      "name": "bob",
      "status": "valid",
      "expiry": "2035-01-15",
      "days_remaining": 3650
    },
    {
      "name": "charlie",
      "status": "revoked",
      "expiry": "2035-01-15",
      "days_remaining": null
    }
  ]
}

إدارة الخادم```bash

Renew server certificate

./openvpn-install.sh server renew

Uninstall OpenVPN

./openvpn-install.sh uninstall

عرض العملاء المتصلين (يتم تحديث البيانات كل 60 ثانية):```text
$ ./openvpn-install.sh server status
══ Connected Clients ══
[INFO] Found 2 connected client(s)

   Name    Real Address          VPN IP      Connected Since   Transfer
   ----    ------------          ------      ---------------   --------
   alice   203.0.113.45:52341    10.8.0.2    2025-01-15 14:32  ↓1.2M ↑500K
   bob     198.51.100.22:41892   10.8.0.3    2025-01-15 09:15  ↓800K ↑200K

[INFO] Note: Data refreshes every 60 seconds.

خيارات التثبيت