Docker وCompose
Run the control plane and the data plane in containers with Docker Compose, on Linux or a Mac: start, first-login credentials, upgrade and uninstall.
أي إصدار ستثبّت
الإصدار العام هو إصدار تطوير باسم 0.3.0-dev. يبقى اسمه ثابتاً: كل نشر يحلّ محل السابق، ويميّز معرّف البناء بين بنائين. لا يوجد إصدار مستقر بعد: لن يُنشر إلا بعد اختبار كل نظام وكل حزمة من البداية إلى النهاية. لذلك تثبّت الأوامر في هذه الصفحة من قناة dev. قد يحتوي إصدار التطوير على أخطاء: جرّبه على موقع اختبار قبل أن تعتمد عليه.
At a glance
- One image runs the control plane (console and API) or the data plane, selected with TOUTWAF_ROLE; the compose file starts one of each.
- The files (the deploy folder) come with your ToutWAF distribution: they are not in the public repository, which holds binaries and installers only.
- On the very first start, the toutwaf-cp logs show once the secret console address and the generated username and password: copy them, they are written nowhere else.
- The console is published on 127.0.0.1 only: to reach it remotely, use an SSH tunnel, a VPN or a TLS reverse proxy with an allow-list. Never publish 9443 on a public interface.
The commands, step by step
Docker Compose على Mac أو Linux
Docker Compose على Linux أو Mac (Docker Desktop أو OrbStack أو Colima) مع الصورة المتكاملة (مستوى التحكم ومستوى البيانات). تأتي الملفات مع توزيعة ToutWAF لديك (مجلد deploy، وهو غير موجود في المستودع العام الذي لا يضم سوى البرامج والمثبّتات). تتضمن الصورة ملفات ثنائية مبنية مسبقاً لكل بنية (bin/amd64 أو bin/arm64) ولا تُنشر أي صورة في سجل بعد. اختُبرت على Linux amd64 فقط؛ ولم تُختبر على Mac حقيقي، حيث يكون عنوان IP الظاهر للعميل خلف Docker Desktop هو عنوان بوابة Docker. وتظهر بيانات الدخول لمرة واحدة مرة واحدة في سجل مستوى التحكم.
cd deploy/docker
# bin/amd64/{toutwaf-cp,toutwaf-dp,toutwafctl} (Intel Mac, Linux x86-64)
# bin/arm64/{toutwaf-cp,toutwaf-dp,toutwafctl} (Apple Silicon, Linux ARM)
cp .env.example .env
docker compose up -d --build
docker compose logs toutwaf-cpالترقية (الحاويات)
أنشئ نسخة احتياطية أولاً. لا يمكن لزر التحديث في وحدة التحكم أن يعمل داخل حاوية: استبدل الملفات الثنائية في مجلد bin (أو الصورة حين تُنشر واحدة) وأعد البناء؛ وتبقى الأحجام، أي بياناتك.
docker compose up -d --buildإلغاء التثبيت
تزيل الكتلة الأولى الخدمات والملفات التنفيذية وقواعد جدار الحماية التي أضافها ToutWAF وتُبقي بياناتك. وتحذف الثانية أيضاً الإعدادات والبيانات والسجلات.
docker compose downdocker compose down -vWhat is not verified
We prefer to say it plainly.
- Tested end to end on Linux x86-64 only. An Intel Mac, an Apple Silicon Mac (linux/arm64) and Windows with Docker Desktop are not tested on real hardware.
- No image is published to a registry: building needs the prebuilt release binaries. Native macOS is not provided.
- The in-console update and the firewall helper do not work in a container: you update by replacing the image. A single control-plane instance, with SQLite.