📦

routeros-app-yaml

Name: routeros-app-yaml
Author: tikoci

آمن ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة

كتابة تكوينات YAML لحاويات RouterOS

إنشاء والتحقق من صحة تكوينات YAML لتطبيقات حاويات MikroTik RouterOS. تساعدك هذه المهارة في تعريف الخدمات والمنافذ ومجلدات التخزين والشبكات لنظام /app في RouterOS دون الحاجة لمعرفة docker-compose.

يدعم: Claude Codex Code(CC)

🥉 73 برونزي

تنزيل ZIP المهارة

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

فعّل وابدأ الاستخدام

اختبرها

استخدام "routeros-app-yaml". إنشاء YAML لـ /app لحاوية Home Assistant مع تخزين مستمر على المنفذ 8123

النتيجة المتوقعة:

ملف YAML يحتوي على أقسام name و services و volumes و networks.
تستخدم خدمة الويب صورة ghcr.io/home-assistant/home-assistant مع تعيين المنفذ 8123.
يتم تركيب مجلد تخزين مسمى home-assistant-config على /config.
تم تعيين سياسة إعادة التشغيل إلى always للموثوقية.

استخدام "routeros-app-yaml". عرض الفرق بين تنسيقات المنافذ القديمة والجديدة في YAML لـ RouterOS

النتيجة المتوقعة:

يستخدم نمط OCI القديم شرطة مائلة قبل البروتوكول: 8080:80/tcp
يستخدم نمط RouterOS 7.23 الجديد نقطتين رأسيتين: 8080:80:web:tcp
كلا التنسيقين صالح. يجب تفضيل نمط النقطتين الرأسية في النشر الجديد من الإصدار 7.23beta2.
تعمل صيغة الكائن الطويلة مع حقول target و published و protocol في جميع الإصدارات.

التدقيق الأمني

آمن

v2 • 4/16/2026

All 159 static analysis findings are false positives. The skill contains only documentation and YAML configuration examples for RouterOS container applications. There is no executable code, no actual shell commands, no network requests, and no credential handling. The static scanner flagged YAML examples in markdown code blocks as security risks (for example, backticks in YAML values, example URLs in documentation, and placeholder IP addresses in configuration samples). After manual review, no genuine security issues were found.

الملفات التي تم فحصها

453

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

مشكلات منخفضة المخاطر (3)

SKILL.md:1-276 references/examples.md:1-177

False positive: External command detection in YAML documentation

The static scanner flagged 132 locations as external command execution. These are YAML configuration examples and markdown documentation, not executable code. Examples include shell commands in YAML entrypoint values (for example, nginx -g daemon off in SKILL.md line 32 and references/examples.md line 31) and backtick-formatted text in markdown. No actual command execution exists.

SKILL.md:110-275 references/examples.md:19-173

False positive: Network pattern detection in documentation URLs

The static scanner flagged 13 locations as network risks including hardcoded URLs, hardcoded IP addresses, and fetch API calls. All are documentation examples: example.com URLs in YAML samples (references/examples.md lines 19, 21), example IP addresses like 192.168.1.1 in port mapping examples (SKILL.md line 110, references/examples.md line 145), and TypeScript fetch snippets showing RouterOS REST API usage (SKILL.md lines 216, 222). No actual network requests are made by this skill.

SKILL.md:1-276 references/examples.md:1-177

False positive: Blocker patterns misidentified in YAML content

The static scanner flagged weak cryptographic algorithms, Windows SAM database references, LLM role token injection, and system reconnaissance patterns. None of these patterns exist in the actual file content. The scanner likely misidentified YAML property names or markdown formatting as security threats.

عوامل الخطر

⚙️ الأوامر الخارجية (132)

🌐 الوصول إلى الشبكة (13)

references/examples.md:19 references/examples.md:21 references/examples.md:57 references/examples.md:101 references/examples.md:173 references/examples.md:145 SKILL.md:216 SKILL.md:222 SKILL.md:225 SKILL.md:248 SKILL.md:249 SKILL.md:275 SKILL.md:110

تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

الأمان

100

الامتثال للمواصفات

ماذا يمكنك بناءه

تعريف تطبيق حاوية لـ RouterOS

يكتب مسؤول الشبكة YAML لنشر مجموعة مراقبة تتضمن Grafana و Prometheus على جهاز توجيه MikroTik باستخدام نظام /app الفرعي.

ترحيل مشاريع docker-compose إلى RouterOS

يقوم المطور بتعديل تكوين docker-compose موجود إلى صيغة YAML الخاصة بـ /app في RouterOS، مع ضبط صيغة المنافذ وإزالة الخصائص غير المدعومة.

إنشاء متجر تطبيقات لنشر الفريق

يبني مهندس النظام ملف YAML بصيغة tikappstore يحتوي على تطبيقات مهيأة مسبقاً لنشر متسق عبر عدة أجهزة RouterOS.

جرّب هذه الموجهات

إنشاء تعريف /app أساسي

اكتب ملف YAML لـ /app في RouterOS يشغّل حاوية nginx على المنفذ 8080 مع مجلد تخزين مسمى للبيانات المستمرة.

تحويل docker-compose إلى YAML لـ RouterOS

حوّل ملف docker-compose هذا إلى صيغة YAML الخاصة بـ /app في RouterOS. أبرز أي خصائص غير مدعومة أو تعمل بشكل مختلف.

إنشاء تطبيق متعدد الخدمات

اكتب YAML لـ /app في RouterOS يحتوي على واجهة ويب وقاعدة بيانات PostgreSQL وذاكرة تخزين مؤقت Redis. تضمين تركيبات مجلدات التخزين المناسبة وعزل الشبكة وفحوصات الحالة.

بناء ملف متجر تطبيقات

أنشئ ملف YAML لمتجر تطبيقات RouterOS يحتوي على ثلاثة تطبيقات: خادم ويب، ومدير قاعدة بيانات، ولوحة مراقبة. يجب أن يحتوي كل منها على فئات وبيانات وصفية مناسبة.

أفضل الممارسات

استخدم دائماً الامتداد .tikapp.yaml لتعريفات تطبيقات RouterOS المخصصة لتمييزها عن ملفات YAML العامة.
استخدم.variant *.editor.json من المخطط أثناء التطوير للحصول على إكمال تلقائي أفضل، ثم تحقق من الصحة مقابل *.latest.json قبل النشر.
اختبر YAML على جهاز RouterOS CHR الافتراضي قبل النشر على الأجهزة الفعلية لاكتشاف أخطاء المخطط مبكراً.

تجنب

افتراض التوافق الكامل مع docker-compose. يدعم /app في RouterOS مجموعة فرعية فقط من خصائص compose ويتعامل مع بعضها بشكل مختلف.
استخدام المفتاح version على المستوى الأعلى. يتجاهل RouterOS هذا المفتاح ولا يخدم أي غرض في YAML الخاص بـ /app.
خلط أنماط تنسيق المنافذ ضمن سلسلة منفذ واحدة. يجب أن يستخدم كل إدخال منفذ إما نمط OCI القديم أو نمط النقطتين الرأسية الجديد حصرياً.

الأسئلة المتكررة

ما إصدار RouterOS الذي أحتاجه لـ YAML الخاص بـ /app؟

المسار /app مدمج بدءاً من RouterOS 7.21. يتطلب إنشاء تطبيق مخصص عبر /app/add الإصدار 7.22 أو أحدث. يجب أيضاً تثبيت حزمة container الإضافية.

هل YAML الخاص بـ /app في RouterOS هو نفسه docker-compose؟

لا. يبدو YAML الخاص بـ /app في RouterOS مشابهاً لـ docker-compose لكنه يدعم خصائص أقل. بعض الخصائص مثل deploy و resources غير مدعومة. كما يختلف صيغة تعيين المنافذ بينهما.

ما امتداد الملف الذي يجب استخدامه لملفات YAML الخاصة بـ /app؟

استخدم .tikapp.yaml لتعريفات التطبيقات الفردية و .tikappstore.yaml لملفات متجر التطبيقات. تساعد هذه الاصطلاحات الأدوات والمحررات في تطبيق المخطط الصحيح.

كيف تعمل العناصر النائبة في YAML الخاص بـ RouterOS؟

يتم توسيع العناصر النائبة مثل [accessIP] و [accessPort] و [containerIP] و [routerIP] في وقت النشر بواسطة RouterOS. تظهر في تعيينات المنافذ وقيم البيئة ومحتوى التكوين.

هل يمكنني استخدام متغيرات بيئة بأسماء بأحرف صغيرة؟

يتطلب مخطط التحقق الصارم أسماء متغيرات بيئة بأحرف كبيرة تطابق النمط [A-Z_][A-Z0-9_]*. استخدم variant المحرر من المخطط إذا كنت بحاجة إلى أسماء متغيرات بأحرف مختلطة.

كيف أضيف تطبيقاً مخصصاً إلى RouterOS؟

استخدم أمر CLI المسمى /app/add مع المعلمة yaml-url التي تشير إلى عنوان URL لملف YAML الخاص بك. بدلاً من ذلك، استخدم نقطة نهاية PUT في REST API على /app مع yaml-url في جسم الطلب.

تفاصيل المطور

المؤلف

tikoci

الترخيص

MIT

المستودع

https://github.com/tikoci/routeros-skills/tree/main/routeros-app-yaml

مرجع

main

بنية الملفات

📁 references/

📄 examples.md

📄 SKILL.md