SILAB التوثيق

البدء

التثبيت

يثبّت SILAB كل ما يحتاجه — QEMU، وصورة RouterOS، وnginx، وخدماته الخاصة — من أمر واحد. وهو مستقل: يُثبَّت على جهاز Ubuntu نظيف ويتموضع بجانب أي شيء آخر موجود على المضيف دون التأثير فيه.

كل تثبيت مُتحقَّق منه: يفحص برنامج الإقلاع توقيع بيان الإصدار مقارنةً بمفتاح إصدار SILAB وSHA256 الخاص بالحزمة قبل تشغيل أي شيء، ثم يطلب منك قبول ترخيص MikroTik.

اختر نظامك:

• L Linux (أمر واحد) Ubuntu 22.04 / 24.04 / 26.04، بمعالج amd64 أو arm64. لا حاجة إلى VT-x.
• W Windows (WSL2) Windows 10 (2004 فما فوق) أو 11 — نسخة WSL2 خاصة به وقائمة على سطح المكتب.
• i المتطلبات & الخيارات تحديد حجم العتاد، وما يهيّئه المثبّت، ومتغيرات البيئة القابلة للتجاوز.

التثبيت

Linux (أمر واحد)

على Ubuntu 22.04 أو 24.04 أو 26.04 (بمعالج amd64 أو arm64)، نفّذ بصلاحية root:

curl -fsSL https://silab.securytik.com/install.sh | sudo bash

يقوم المثبّت بالتنزيل من حاوية التنزيل الخاصة بنا، ومن إصدار SILAB على GitHub تلقائيًا عندما لا يمكن الوصول إلى الحاوية — لا حاجة لأي اختيار.

ماذا يحدث

1. يجلب برنامج الإقلاع أحدث بيان إصدار، ويفحص توقيعه وتاريخ انتهائه، ويُنزّل الحزمة ويفحص SHA256 الخاص بها. أي عدم تطابق يوقف التثبيت قبل تشغيل أي شيء.
2. يطلب منك قبول ترخيص MikroTik لـ RouterOS CHR، ثم يُنزّل أحدث صورة CHR مستقرة من MikroTik ويتحقق من SHA256 الخاص بها. لا تُعاد توزيع الصورة أبدًا من طرف SILAB.
3. يثبّت QEMU وnginx وخدمات SILAB، وينشر واجهة الويب على المنفذ 80 — أو 8088 عندما يكون المنفذ 80 مشغولًا، مثلًا من طرف SAMM.

تسجيل الدخول الأول

افتح الخادم في متصفح وسجّل الدخول:

غيّر كلمة المرور فورًا من System → Profile. يعرض SILAB تحذيرًا طالما كلمة المرور الافتراضية قيد الاستخدام.

التثبيت

Windows (WSL2)

يعمل SILAB على Windows 10 (الإصدار 2004 أو أحدث) وWindows 11 في نسخة WSL2 خاصة به، يهيئها مثبّت واحد. افتح PowerShell — لا Command Prompt (cmd) — ونفّذ السطر أدناه. إذا لم يكن PowerShell يعمل بصلاحية المسؤول، يطلب Windows إذنًا: اضغط Yes ويستمر التثبيت في نافذة مسؤول جديدة.

irm https://silab.securytik.com/install.ps1 | iex

يقوم بالتنزيل من حاوية التنزيل الخاصة بنا، ومن إصدار SILAB على GitHub تلقائيًا عندما لا يمكن الوصول إلى الحاوية.

يُنزّل برنامج الإقلاع المثبّت الكامل إلى %ProgramData%\SILAB\silab-windows.ps1 ويشغّله من هناك، حتى يتمكن من رفع صلاحياته ومواصلة العمل بعد إعادة التشغيل.

ماذا يحدث

1. يُفعِّل WSL2. في المرة الأولى يحتاج ذلك إلى إعادة تشغيل واحدة لـ Windows؛ ثم يستمر الإعداد تلقائيًا.
2. يستورد نسخة Ubuntu 24.04 مخصّصة باسم SILAB (مُتحقَّق من checksum الخاص بها). توزيعات WSL الأخرى لديك تبقى دون تأثير.
3. يثبّت SILAB داخل تلك النسخة باستخدام مثبّت Linux.
4. يضيف أيقونة SILAB إلى سطح المكتب وقائمة Start: قائمة صغيرة لـ Start وStop ورؤية Status وOpen في المتصفح، وShare on the LAN حتى تتمكن أجهزة PC الأخرى — وWinBox الخاص بها — من الوصول إلى المختبر.

التثبيت من ملف مُنزَّل

يمكن أيضًا تشغيل المثبّت الكامل مباشرة، مثلًا من نسخة على USB:

powershell -ExecutionPolicy Bypass -File silab-windows.ps1

إزالة التثبيت

يزيل -Uninstall نسخة SILAB والاختصار وقواعد المشاركة على الشبكة المحلية:

powershell -ExecutionPolicy Bypass -File "$env:ProgramData\SILAB\silab-windows.ps1" -Uninstall

التثبيت

المتطلبات & الخيارات

المتطلبات

• Linux: Ubuntu 22.04 أو 24.04 أو 26.04، بمعالج amd64 أو arm64، مع صلاحية root / sudo. يُستخدم KVM تلقائيًا عندما يكون /dev/kvm قابلًا للاستخدام؛ وبدونه يعمل SILAB تحت المحاكاة البرمجية — لا حاجة إلى VT-x.
• Windows: Windows 10 الإصدار 2004 (البناء 19041) أو أحدث، أو Windows 11، مع تفعيل المحاكاة الافتراضية للعتاد (VT-x / AMD-V) من أجل WSL2.
• الحجم: نواتان و4 GB من RAM تشغّل عددًا قليلًا من الموجّهات؛ خطّط لحوالي 200–300 MB من RAM لكل موجّه.
• RouterOS: CHR 7.15 أو أحدث، مُنزَّل من MikroTik.

ما الذي يقوم المثبت بإعداده

متغيرات البيئة القابلة للتجاوز

اضبط هذه أمام أمر التثبيت، مثلًا curl -fsSL https://silab.securytik.com/install.sh | sudo SILAB_HTTP_PORT=8080 bash.

البدء

أول مختبر لك

موجّهان وكابل، من لوحة فارغة إلى ping عبر الرابط.

1. سجّل الدخول باسم admin / admin وغيّر كلمة المرور من System → Profile.
2. أنشئ مختبرًا، ثم افتح Lab → Topology.
3. اضغط + Node وأضف عنصرَي Router (CHR) — R1 وR2 في هذا المثال.
4. اضغط + Connect، ثم اضغط R1 ثم R2، واختر المنافذ — مثلًا ether1 على كليهما.
5. اضغط Start lab. تحت المحاكاة البرمجية، يعمل مختبر نظيف من موجّهين ويُهيَّأ في حوالي نصف دقيقة.
6. اضغط مرتين على R1 لفتح طرفيته، أعطِ ether1 عنوانًا على كل موجّه، واستخدم Ping — اضغط R1 ثم R2 — لاختبار الكابل.

ملف المختبر

المختبر هو مخطط YAML صغير. عند تصديره كملف .silab يحمل المخطط بالإضافة إلى ملف .rsc واحد لكل موجّه — غالبًا بضع KB. يعيد SILAB لدى المستقبل بناء المختبر من صورة RouterOS الخاصة به، والملفات المستوردة تُفحَص بصرامة: لا مسارات مضيف، ولا معطيات QEMU خام.

silab: 1
name: OSPF basics
routeros: "7.24.4"
nodes:
  - {id: 1, name: R1, kind: router, x: 100, y: 100, config: R1.rsc}
  - {id: 2, name: R2, kind: router, x: 400, y: 100}
  - {id: 3, name: LAN, kind: hub,    x: 250, y: 300}
  - {id: 4, name: PC1, kind: pc,     x: 250, y: 450}
links:
  - {a: {node: 1, port: 1}, b: {node: 2, port: 1}, delay_ms: 20}
  - {a: {node: 2, port: 2}, b: {node: 3}}
  - {a: {node: 4}, b: {node: 3}}

يُثبِّت المختبر إصدار RouterOS الخاص به، لذا يتصرّف المختبر المُشارَك بنفس الطريقة في كل مكان.

بناء المختبرات

العناصر & الكابلات

أضف عناصر بـ + Node ووصّلها منفذًا لمنفذ بـ + Connect — أثناء عمل المختبر، دون إعادة تشغيل.

أنواع العناصر

أعد تسمية موجّه على اللوحة وتتبعه هوية RouterOS الخاصة به فوريًا. يمكن لكل موجّه أن يحمل تهيئة إقلاع (.rsc) تُطبَّق عند أول تشغيل.

الكابلات

• كابلات النقطة إلى النقطة تُمرّر كل إطار: STP وLACP وLLDP وMNDP وعلامات VLAN.
• افصل الكابل وأعد وصله، أو أضعف أداءه عمدًا: delay، jitter، loss، bandwidth.
• تُرسَم عدة كابلات بين نفس العنصرين جنبًا إلى جنب، كل واحد بعلاماته الخاصة.
• اضغط بزر الفأرة الأيمن على كابل لتصويره مباشرة في Wireshark.

الطاقة

اضغط بزر الفأرة الأيمن على موجّه لقائمة طاقة على طراز VMware:

بناء المختبرات

الوصول إلى موجّه

اضغط مرتين على موجّه لفتح طرفيته في المتصفح. تعمل عبر المنفذ التسلسلي للموجّه، لذا تبقى تعمل حتى لو حذف الطالب كل عنوان IP. يحصل كل موجّه أيضًا على منافذ ثابتة على مضيف SILAB، قابلة للوصول من الشبكة المحلية أو الإنترنت.

فموجّه 1 يستجيب لـ WinBox على 20010، وSSH على 20011، وWebFig على 20012؛ وموجّه 2 على 20020 و20021 و20022. تسجيل الدخول للموجّهات باسم admin / admin.

ssh -p 20011 admin@<silab-host>

WinBox بنقرة واحدة

اضغط بزر الفأرة الأيمن على موجّه → WinBox ويفتح WinBox متصلًا بالفعل، مع العنوان والمستخدم وكلمة المرور معبّأة. لا تستطيع صفحة ويب تشغيل برنامج على جهازك بمفردها، لذا يحتاج ذلك إلى مساعد WinBox، يُثبَّت مرة واحدة لكل جهاز من System → Helpers:

• Windows — نزّل المساعد، واضغط عليه بزر الفأرة الأيمن → Run with PowerShell. إذا لم يجد WinBox، يسأل عن مكان WinBox.exe. أعد تشغيل المتصفح مرة واحدة.
• Linux — نزّل المساعد ونفّذ sh silab-winbox-linux.sh (دون صلاحية root). يجد WinBox، أو يطلب مسار الملف التنفيذي لـ WinBox.
• macOS — إلى أن يتوفر مساعد، اضغط بزر الفأرة الأيمن على موجّه → Links → WinBox لنسخ العنوان.

لا يحتاج المساعد إلى صلاحيات مسؤول. تحتاج أولًا إلى WinBox نفسه، من mikrotik.com/download.

منفذ الإدارة

يصل SILAB إلى كل موجّه عبر منفذ إدارة محفوظ في VRF خاص به، vrf-mgmt: خارج جدول توجيه الطالب وخارج OSPF وBGP. تبقى منافذ الطالب ether1..N، بالضبط كما رُسمت.

بناء المختبرات

أجهزة PC الافتراضية

عنصر PC هو عميل خفيف دون جهاز افتراضي خلفه. اضبط عنوان IP الخاص به من اللوحة — DHCP client أو Static أو PPPoE client (اختياريًا فقط الخادم الذي يقدّم اسم خدمة معيّنًا) أو No address — أو من طرفيته. لا توجد صدفة مضيف خلف الطرفية؛ وهذه أوامرها:

Ping بين أي جهازين

بجانب + Connect على مخطط الشبكة، تختبر Ping إمكانية الوصول دون فتح طرفية: اضغط جهازين، وتعمل خمس عمليات ping في الخلفية، وتفتح النتيجة في نافذة منبثقة. يستخدم SILAB العنوان على الشبكة الفرعية المشتركة بين الجهازين، وإلا فأول عنوان للهدف؛ وعند اختيار عنصر إنترنت كهدف يُستخدَم ping إلى 8.8.8.8.

بناء المختبرات

التصوير في Wireshark

اضغط بزر الفأرة الأيمن على كابل → Capture in Wireshark: يفتح Wireshark على جهازك ويعرض حركة ذلك الكابل مباشرة، في الاتجاهين، حتى تغلقه.

ثبّت مساعد Wireshark مرة واحدة

كما مع WinBox، يحتاج هذا إلى مساعد صغير لكل جهاز، من System → Helpers. لا يحتاج إلى صلاحيات مسؤول.

• Windows — نزّل المساعد، واضغط عليه بزر الفأرة الأيمن → Run with PowerShell. إذا لم يجد Wireshark، يسأل عن مكان Wireshark.exe. أعد تشغيل المتصفح مرة واحدة: بعدها تفتح روابط التصوير Wireshark دون سؤال.
• Linux — نزّل المساعد ونفّذ sh silab-wireshark-linux.sh (دون صلاحية root). يجد Wireshark، أو يطلب مسار الملف التنفيذي لـ wireshark. يحتاج إلى curl.

تحتاج أولًا إلى Wireshark نفسه، من wireshark.org.

بناء المختبرات

الإجراءات الجماعية

تُجري Lab → Bulk actions تغييرًا واحدًا على كل موجّه في المختبر — أو الموجّهات التي تحدّدها — وتعرض النتيجة لكل موجّه.

النظام

التحديثات

تعرض System → Updates الإصدار المثبَّت، وأحدث إصدار، وWhat's new. يفحص مؤقّت يومي وجود إصدارات جديدة.

1. يُنزّل Apply update الإصدار الموقَّع ويفحصه.
2. ينسخ التثبيت احتياطيًا إلى /var/backups/silab، ويستبدل الملفات بالجديدة، ويعيد تشغيل المحرّك والويب. الموجّهات العاملة تبقى تعمل.
3. إذا فشل أي شيء، يُستعاد الإصدار السابق تلقائيًا.

بعد ترقية إصدار Ubuntu (22.04 → 24.04 → 26.04) تعيد الخدمات بناء بيئة Python الخاصة بـ SILAB تلقائيًا عند تشغيلها التالي؛ وإعادة تشغيل المثبّت تعمل أيضًا.

إصدارات RouterOS

يمكن تثبيت عدة إصدارات من RouterOS جنبًا إلى جنب، ويخبرك SILAB عند صدور RouterOS أحدث. لا شيء يتحدّث تلقائيًا: يُثبِّت المختبر إصداره. أضف إصدارًا من سطر الأوامر:

silab image latest
silab image pull 7.24.4
silab image list

النظام

النسخ الاحتياطي والاستعادة

تقوم System → Backup & restore بإنشاء وتنزيل وتحميل واستعادة النسخ الاحتياطية.

• تحتوي كل نسخة احتياطية على كل مختبر مع تهيئات إقلاعه، والحسابات، والإعدادات.
• فعّل Include the routers' disks للحفاظ على حالتها الكاملة أيضًا — يكون الملف أكبر.
• صور RouterOS غير مضمَّنة؛ تُنزَّل مجددًا من MikroTik.
• تعمل نسخة احتياطية تلقائية كل يوم عند 04:00 (بتوقيت الخادم). اختر عدد النسخ التلقائية المطلوب الاحتفاظ بها؛ النسخ التي أنشأتها أو حمّلتها بنفسك لا تُحذَف أبدًا.
• يجب أن تكون التحميلات ملف .tar.gz من إنشاء SILAB؛ أي شيء آخر يُرفَض.

من سطر الأوامر:

silab backup create --disks
silab backup list

النظام

سطر الأوامر

يمكن أيضًا تنفيذ كل ما على اللوحة من صدفة الخادم باستخدام silab:

silab lab load ospf-basics.silab
silab up
silab link impair R1:1 --delay 50 --loss 2
silab console R1

مرجع

الأسئلة الشائعة & حل المشكلات

هل تحتاج إلى مزيد من المساعدة؟

راسلنا على [email protected] للإبلاغ عن خلل أو طلب ميزة جديدة.