المُطلِق المنتجات Bitnami التوثيقimaxe CLI المدوّنة اتصل بنا
imaxe firewall جدار الحماية v1.0.0

جدار حمايتك، تحت السيطرة

استعلم عن حالة ufw، واقفِل عناوين IP المُسيئة يدويًا، وافتح المنافذ أو أغلقها بأمر واحد. حالات الحظر التلقائية يضعها fail2ban؛ أما هذا فهو لأقفالك اليدوية وقواعد المنافذ.

$ imaxe firewall block 203.0.113.10 --reason "abuso" --ttl 24h
الإصدار
v1.0.0
الأوامر الفرعية
9
الإعداد
/etc/imaxe/firewall.yml
يتطلب root
نعم
الأساس
ufw + fail2ban

ماذا تفعل هذه الوحدة #

جدار الحماية هو باب الخادم: يقرّر أي الاتصالات تدخل وأيها تُرفَض. في هذه الأجهزة يقوم بهذا العمل ufw (جدار حماية Ubuntu)، وتمنحك وحدة firewall أداة تحكّم مريحة لتشغيله دون حفظ صيغة ufw.

به يمكنك أن ترى بنظرة واحدة حالة جدار الحماية (نشط، والسياسة الافتراضية والقواعد)، وأن تقفِل يدويًا عنوان IP أو نطاقًا يزعجك، وأن تحرّر ذلك القفل عندما لم يعُد لازمًا، وأن تفتح المنافذ أو تغلقها مع الحفاظ على الإعداد متزامنًا مع ما يطبّقه ufw.

أقفال يدوية، لا تلقائية

حالات الحظر التلقائية بسبب محاولات الاختراق (القوة الغاشمة على SSH، إلخ) يديرها fail2ban بمفرده. تعمل هذه الوحدة مع أقفالك اليدوية: block وunblock وflush تمسّ فقط ما تضيفه أنت يدويًا ولا تتداخل أبدًا مع حالات حظر fail2ban.

دليل سريعمهام خطوة بخطوة

المهام الشائعة #

اختر ما تريد فعله. كل وصفة تأتي بالأمر مكتوبًا بالفعل — ما عليك سوى تغيير عنوان IP أو المنفذ بما يخصّك، والضغط على نسخ.

1

عرض حالة جدار الحماية

تحقق مما إذا كان نشطًا، وسياسته الافتراضية وكم قاعدة لديه.

اتصل عبر SSH بخادمك واطلب الملخّص:

الطرفية
$ sudo imaxe firewall status

هل تريدها لسكربت؟ أضِف --json وستحصل على المعلومات نفسها قابلة للقراءة آليًا:

الطرفية
$ sudo imaxe firewall status --json
ترى ما إذا كان جدار الحماية نشطًا، والسياسة الافتراضية، وعدد القواعد وكم قفلًا يدويًا وضعت.
2

إقفال عنوان IP مُسيء

اقطع الوصول عن عنوان IP أو نطاق يزعجك.

اقفِل عنوان IP محدّدًا، مع تدوين السبب لتتذكّره لاحقًا:

الطرفية
$ sudo imaxe firewall block 203.0.113.10 --reason "abuso"

هل تريد قفلًا مؤقتًا فقط؟ حدّد له مدة باستخدام --ttl وسيُرفَع من تلقاء نفسه. يمكنك أيضًا إقفال نطاق كامل بترميز CIDR:

الطرفية
$ sudo imaxe firewall block 203.0.113.10 --reason "abuso" --ttl 24h
$ sudo imaxe firewall block 203.0.113.0/24 --reason "escaneo"
يتوقّف عنوان IP أو النطاق هذا عن الاتصال بالخادم. إذا وضعت --ttl، فينتهي القفل تلقائيًا عند انقضاء المدة.
3

عرض عناوين IP التي أقفلتها

راجِع قائمة الأقفال اليدوية النشطة لديك.

أدرِج عناوين IP والنطاقات التي أقفلتها يدويًا (تذكّر: حالات حظر fail2ban لا تظهر هنا):

الطرفية
$ sudo imaxe firewall blocked
ترى كل قفل يدوي مع سببه، ومتى ينتهي إن كان له مدة. هل هناك قفل زائد؟ انتقل إلى فتح قفل عنوان IP.
4

فتح قفل عنوان IP

حرّر قفلًا يدويًا لم يعُد لازمًا.

حرّر عنوان IP أو النطاق تمامًا كما أقفلته (كما يظهر في blocked):

الطرفية
$ sudo imaxe firewall unblock 203.0.113.10
يعود ذلك العنوان قادرًا على الاتصال. أما بقية الأقفال وحالات حظر fail2ban فتبقى سليمة.
5

فتح منفذ أو إغلاقه

اسمح بمرور خدمة جديدة أو أغلِق واحدة لم تعُد تقدّمها.

افتح منفذًا (مع تعليق لتعرف الغرض منه). يمكنك تقييد من يدخل باستخدام --from:

الطرفية
$ sudo imaxe firewall allow 443/tcp --comment "https"
$ sudo imaxe firewall allow 5432/tcp --from 203.0.113.0/24 --comment "postgres interno"

أغلِق منفذًا لم تعُد تستخدمه:

الطرفية
$ sudo imaxe firewall deny 8080/tcp
تُطبَّق القاعدة في ufw وتنعكس في firewall.yml. تحقق منها باستخدام imaxe firewall rules list.
انتبه عند إغلاق المنافذ

لا تغلق المنفذ 22 (SSH) إذا كنت متصلًا عبر SSH: ستفقد الوصول إلى الخادم. تُبقي الوحدة 22/tcp مسموحًا افتراضيًا تحديدًا لتجنّب هذا الفزع. وتذكّر أن flush يمحو جميع أقفالك اليدوية دفعة واحدة.

مرجع CLIالأوامر والرايات والملفات

صيغة الاستخدام #

الاستخدام
imaxe firewall <subcomando> [<ip>|<puerto>] [flags]

جميع الأوامر الفرعية تتطلب امتيازات root (استخدم sudo) لأنها تعمل على ufw وتكتب في /etc/imaxe/. أضِف --json إلى status أو blocked أو rules list للحصول على مخرجات قابلة للقراءة آليًا، صالحة لكتابة السكربتات.

الأوامر الفرعية #

الأمر الفرعيماذا يفعلالرايات المعنية
statusحالة جدار الحماية: نشط، والسياسة الافتراضية، وعدد القواعد والأقفال اليدوية.--json
blockedيُدرِج عناوين IP/النطاقات المُقفَلة يدويًا (لا يشمل حالات حظر fail2ban).--json
blockيقفِل عنوان IP أو نطاقًا يدويًا، مع سبب ومدة اختياريين.--reason, --ttl
unblockيحرّر قفلًا يدويًا. لا يمسّ حالات حظر fail2ban.
flushيمحو جميع الأقفال اليدوية (تدميري). لا يمسّ حالات حظر fail2ban.--yes
rules listيُدرِج قواعد المنافذ (المنافذ المسموحة، والمصادر).--json
allowيفتح منفذًا ويعكسه في الإعداد.--from, --comment
denyيغلق منفذًا ويعكسه في الإعداد.--from
reloadيعيد تحميل ufw (يعيد تطبيق قواعده النشطة).

rules يجمّع إدارة قواعد المنافذ؛ في الوقت الحالي أمره الفرعي الوحيد هو rules list.

الوسائط والرايات #

الوسيط / الرايةالنوعالافتراضيالوصف
<ip>[/cidr] مطلوبstringعنوان IP أو نطاق CIDR المراد العمل عليه في block وunblock (مثل 203.0.113.10 أو 203.0.113.0/24).
<port>[/proto] مطلوبstringالمنفذ المراد العمل عليه في allow وdeny (مثل 443 أو 443/tcp).
--reasonstringفي block: سبب القفل (للعِلم).
--ttlالمدةدائمفي block: مدة القفل (مثل 24h). افتراضيًا، دائم.
--fromcidrأي مصدرفي allow/deny: يقيّد المصدر بنطاق CIDR محدّد.
--commentstringفي allow: تعليق وصفي للقاعدة.
--yesboolfalseفي flush: يؤكّد دون سؤال (عملية تدميرية).
--jsonboolfalseفي status/blocked/rules list: يُصدِر النتيجة كـ JSON على stdout.

الملفات والمسارات #

المسارالمحتوى
/etc/imaxe/firewall.ymlإعداد الوحدة: المنافذ المسموحة التي يبقيها allow/deny متزامنة مع ufw.

مثال على firewall.yml:

/etc/imaxe/firewall.yml
allow:
  - { port: 22, proto: tcp, comment: "ssh" }
  - { port: 443, proto: tcp, comment: "https" }

رموز الخروج والسجلّات #

يُرجِع كل تنفيذ رمزًا يمكنك التحقق منه باستخدام echo $? — مفيد للتسلسل في السكربتات:

0OKاكتملت العملية بنجاح.
1ERRخطأ عام غير مصنَّف. راجِع السجلّ.
2USAGEوسائط غير صالحة أو ناقصة.
3NOTFOUNDعنوان IP أو القاعدة المحدّدة غير موجود.

تابِع الحالة والقواعد مباشرةً أثناء التنقيح:

الطرفية
$ sudo imaxe firewall status
$ sudo imaxe firewall rules list

حل المشكلات #

العَرَضالسبب المحتملالحل
يظهر NOTFOUND (رمز 3) عند فتح القفلعنوان IP لا يطابق تمامًا القفل الموضوع (ينقصه /cidr مثلًا).نفّذ imaxe firewall blocked وانسخ المُدخَل كما هو من أجل unblock.
أقفلت عنوان IP لكنه لا يزال يظهر محظورًا بعد unblockالقفل وضعه fail2ban، لا أنت.هذه الوحدة تحرّر الأقفال اليدوية فقط؛ حالات الحظر التلقائية يديرها fail2ban على حِدة.
فتحت منفذًا لكن لا تدخل حركة مرورالقاعدة موجودة في ufw لكن جدار حماية خارجي (security group) لا يزال مغلقًا.تحقق باستخدام imaxe firewall rules list وافتح المنفذ أيضًا لدى مزوّد الحوسبة السحابية.
فقدت الوصول عبر SSH بعد تعديل القواعدأُغلق المنفذ 22 أو أصبح مقيَّدًا.ادخل عبر وحدة تحكّم المزوّد وأعِد السماح بـ 22/tcp باستخدام imaxe firewall allow 22/tcp.

هل واجهتك مشكلة مع وحدة Firewall؟

راسلنا مرفقًا مخرجات «imaxe <module> status --json» وسنرد عليك بسرعة.

التواصل مع الدعم