المتطلبات
Supported systems, ports, privileges and dependencies: what the installers check, install or expect, and what each component needs. Read it before you plan an installation.
أي إصدار ستثبّت
الإصدار العام هو إصدار تطوير باسم 0.3.0-dev. يبقى اسمه ثابتاً: كل نشر يحلّ محل السابق، ويميّز معرّف البناء بين بنائين. لا يوجد إصدار مستقر بعد: لن يُنشر إلا بعد اختبار كل نظام وكل حزمة من البداية إلى النهاية. لذلك تثبّت الأوامر في هذه الصفحة من قناة dev. قد يحتوي إصدار التطوير على أخطاء: جرّبه على موقع اختبار قبل أن تعتمد عليه.
At a glance
- A 64-bit server (amd64 or arm64) running Linux (systemd 239+, glibc 2.28+, kernel 4.18+) or Windows, with root or administrator rights.
- Ports: 80 and 443 (web traffic), 9443 (console, restrict it to your admin network), 9444 (API used by nodes and agents: open it only from your own servers), 127.0.0.1:9101 (local health). UDP 443 stays closed: HTTP/3 is not implemented.
- No runtime to install: self-contained binaries, data in SQLite, no database server.
- The installer checks free disk space, DNS and the clock; memory is not checked.
المتطلبات والاعتماديات
ما يحتاجه خادمك، وما يضيفه المثبّت، وما يبقى اختيارياً.
الأنظمة المدعومة
Linux مع systemd 239 أو أحدث وglibc 2.28 أو أحدث، على amd64 أو arm64: AlmaLinux وRocky Linux وRHEL وOracle Linux من 8 إلى 10، وCentOS Stream وFedora وAmazon Linux 2023 وDebian من 11 إلى 13 وUbuntu من 20.04 إلى 26.04 وopenSUSE وArch (الجدول الكامل أدناه). وWindows 10 و11 وServer من 2016 إلى 2025 (لم تُشغَّل بعد على مضيف Windows حقيقي). يفحص برنامج التثبيت نظامك قبل أن يغيّر أي شيء. الخوادم التي تضيفها من وحدة التحكم: وكيل المضيف متوفر لنظام Linux (amd64 وarm64) ولنظام Windows (amd64).
منافذ الشبكة
80 و443: حركة الويب (مستوى البيانات). 9443: وحدة التحكم (يمكن تغييره بالخيار --cp-port). 9444: واجهة API التي تستخدمها عقد مستوى البيانات ووكلاء الخوادم؛ لا يفتحها المثبّت، فاسمح بها من خوادمك فقط. 127.0.0.1:9101: نقطة فحص الحالة المحلية. يبقى UDP 443 مغلقاً (HTTP/3 غير منفَّذ). يقوم وكلاء الخوادم باتصالات صادرة فقط نحو المنفذ 9444.
ما يفعله المثبّت
يتطلب صلاحيات root أو مسؤول واتصال HTTPS صادراً لتنزيل الإصدار. يثبّت curl وtar وlibcap إن كانت ناقصة (وpolicycoreutils-python-utils على أنظمة SELinux)، وينشئ مستخدماً بلا صلاحيات اسمه toutwaf ومجلد تثبيت واحداً (/var/toutwaf ويضم bin وconf وdata وlogs؛ يغيّره --home DIR، ويحتفظ التثبيت الأقدم بمساراته)، ويثبّت خدمات systemd مُحصَّنة (خدمات Windows على Windows)، ويتيح لمستوى البيانات استخدام المنفذين 80 و443 دون root، ويفتح جدار الحماية افتراضياً عندما يكون firewalld أو ufw نشطاً (80 و443 ومنفذ لوحة التحكم؛ يقيّد --console-from اللوحة ويعطّله --no-firewall)، ويضع وسوم SELinux للملفات، ويتحقق من مجاميع SHA-256.
لغة المثبّت
الإنجليزية افتراضياً؛ يكتشف المثبّت لغة النظام. افرض لغة بالخيارات --fr --de --es --it --pt --nl --ru --zh --ar أو --en (على Windows: -Fr وهكذا، أو المتغير TOUTWAF_LANG).
ملفات تنفيذية مستقلة
كُتب مستوى البيانات بلغة Rust، ومستوى التحكم والوكيل بلغة Go، وتُضمَّن وحدة التحكم في مستوى التحكم. لا حاجة لتثبيت بيئة تشغيل Python أو Node.js أو Java ولا خادم قواعد بيانات: تُخزَّن البيانات في SQLite. يتطلب مستوى البيانات المكتوب بـ Rust الإصدار 2.28 من glibc أو أحدث. أهم المكونات الخارجية: tokio وhyper وrustls (Rust) وSvelte وxterm.js (وحدة التحكم).
مكونات اختيارية
ClamAV لفحوص مضاد الفيروسات على مضيفي Linux (يمكن لوحدة التحكم تثبيته لك)؛ وMicrosoft Defender على Windows. لا يلزم openssl إلا إذا فعّلت التحقق من توقيع الإصدارات، ولا cosign إلا إذا أردت التحقق من التواقيع. Docker غير مطلوب: بيانات Docker وKubernetes طرق نشر بديلة.
ToutPanel (خادم استضافة الويب)
يُثبَّت من وحدة التحكم عبر SSH أو بمثبّته الخاص. Linux: Debian من 11 إلى 13 وUbuntu من 20.04 إلى 24.04 وAlmaLinux وRocky Linux وRHEL 9 و10 وFedora 40 وما بعده. Windows 10 و11 وWindows Server من 2016 إلى 2025. يتطلب root وbash (Linux) أو PowerShell 5.1+ بصلاحيات المسؤول (Windows) وPython من 3.9 إلى 3.14 (يثبّته السكربت إذا وفّرته التوزيعة) وذاكرة 1 جيجابايت على الأقل (يُنصح بـ 2 جيجابايت مع MariaDB وPHP) و2 جيجابايت من القرص الحر إضافة إلى مواقعك واتصال HTTPS صادر. تستمع لوحته افتراضياً على المنفذ 8888؛ والمنفذان 80 و443 لخدمة المواقع. المصدر: ملف README الخاص بـ ToutPanel.
لا ينشر ToutWAF بعد حدوداً دنيا للمعالج أو الذاكرة أو القرص: حدّد حجم خادمك باختبار على حركتك الخاصة.
الأنظمة المدعومة
يفحصها برنامج التثبيت قبل أن يغيّر أي شيء. وتأتي الحالات من بيانات برنامج التثبيت نفسه.
- tested نجح اختبار التثبيت الكامل في حاوية على هذا الإصدار بالضبط.
- expected العائلة نفسها وglibc وsystemd حديثان بما يكفي، لكن الاختبار الكامل لم يجرِ.
- unsupported يُرفض قبل أي تغيير (يمكن تجاوزه على مسؤوليتك بـ--skip-os-check).
| التوزيعة | الإصدارات |
|---|---|
| AlmaLinux | 10tested9tested8tested |
| Rocky Linux | 10tested9tested8tested |
| Red Hat Enterprise Linux | 10tested9tested8tested7unsupported |
| CentOS Stream | 10tested9tested8unsupported7unsupported |
| Oracle Linux | 10tested9tested8tested7unsupported |
| Fedora | 44tested43tested42tested41tested |
| Amazon Linux | 2023tested2unsupported |
| Debian | 13tested12tested11tested10unsupported |
| Ubuntu | 26.04tested25.10tested24.04tested22.04tested20.04tested18.04unsupported |
| Linux Mint / LMDE | جميع الإصداراتexpected |
| Pop!_OS | جميع الإصداراتexpected |
| Zorin OS | جميع الإصداراتexpected |
| elementary OS | جميع الإصداراتexpected |
| Kali Linux | rollingexpected |
| Raspberry Pi OS (32-bit, Raspbian) | جميع الإصداراتunsupported |
| Devuan | جميع الإصداراتunsupported |
| openSUSE Leap | 16.0tested15.6tested |
| openSUSE Tumbleweed | rollingtested |
| openSUSE Slowroll | rollingexpected |
| SUSE Linux Enterprise Server | 16.0expected15.7expected15.6expected |
| SUSE Linux Micro / MicroOS / Aeon | جميع الإصداراتunsupported |
| openSUSE MicroOS / Aeon / Kalpa | جميع الإصداراتunsupported |
| Arch Linux | rollingtested |
| Manjaro | rollingexpected |
| EndeavourOS | rollingexpected |
| Garuda Linux | rollingexpected |
| CachyOS | rollingexpected |
| Artix Linux | جميع الإصداراتunsupported |
| Alpine Linux | جميع الإصداراتunsupported |
| Void Linux | جميع الإصداراتunsupported |
| NixOS | جميع الإصداراتunsupported |
| Windows | Windows 11expectedWindows 10expectedWindows Server 2025expectedWindows Server 2022expectedWindows Server 2019expectedWindows Server 2016expected |
What is not verified
We prefer to say it plainly.
- ToutWAF does not publish minimum CPU, RAM or disk figures yet: size your server with a test on your own traffic.
- The “tested” and “expected” statuses of the table mean: full installation passed in a container with systemd, or same family without that test. Windows is “expected” everywhere.