---
url: https://docs.ogmabox.com/ar/app/settings.md
description: >-
  أعد مظهر Ogma واختصاراته وشبكته وDNS وشهاداته والذكاء الاصطناعي وMCP والماسح
  الأمني وTLS والمتصفح وتخصيصات المطور.
---

# الإعدادات {#settings}

تتحكم الإعدادات في مظهر Ogma والتقاطه لحركة المرور ومعالجته TLS وتوجيه الاتصالات الصادرة وإتاحته ميزات الذكاء الاصطناعي أو MCP. أبق الأذونات الحساسة أمنياً معطلة ما لم يتطلبها مسار عمل.

## المظهر {#appearance}

استخدم **المظهر** لتحسين راحة مساحة العمل وقابلية القراءة.

| القسم | ما يتحكم فيه |
| --- | --- |
| السمة | وضع الألوان الفاتح أو الداكن أو حسب النظام. |
| سمة تمييز الصياغة | الألوان المستخدمة في عارضي المتن ومحررات إعادة الإرسال وفاحصي WebSocket. |
| التخطيط | كثافة الجدول والتمرير التلقائي لسجل HTTP واتجاه الفاحص وموضع الشريط الجانبي. |
| الخطوط | خط الواجهة وحجمه وحجم خط المحرر. |
| الطوابع الزمنية | وقت بنظام 12 ساعة أو 24 ساعة والمنطقة الزمنية المحلية أو UTC ومعاينة حية. |

## الاختصارات {#shortcuts}

تسرد صفحة **الاختصارات** كل إجراء مرتبط بمفتاح وتتيح إعادة تعيين المفاتيح. انقر **تحرير** واضغط تركيبة المفاتيح الجديدة، أو استخدم **إعادة تعيين** لاستعادة القيمة الافتراضية.

من القيم الافتراضية الشائعة:

| الإجراء | الافتراضي |
| --- | --- |
| فتح الاعتراض | `I` |
| فتح إعادة الإرسال | `R` |
| فتح البحث | `/` |
| تمرير الطلب المعترض | `F` |
| إرسال إلى إعادة الإرسال | `Ctrl+R` |
| فتح لوحة الأوامر | `Ctrl+K` |

## بدء التشغيل والعرض {#startup-and-rendering}

| الصفحة | الاستخدام |
| --- | --- |
| بدء التشغيل | اختيار مثيل الوكيل الافتراضي الذي يُفتح عند بدء Ogma والتحكم في سلوك نافذة بدء التشغيل. |
| العرض | تقليل الحركة لإمكانية الوصول أو الأداء ومراجعة سلوك تسريع الأجهزة. |

## الشبكة {#network}

استخدم **الشبكة** عندما يجب أن يرسل Ogma حركة المرور الصادرة عبر وكيل آخر.

| نوع الوكيل | السلوك |
| --- | --- |
| وكيل HTTP | يوجّه حركة مرور HTTP وHTTPS الصادرة عبر وكيل HTTP وسيط. |
| وكيل SOCKS5 | يوجّه حركة المرور الصادرة عبر خادم SOCKS5؛ ويُحل DNS عبر خادم SOCKS5. |
| وكيل إضافة | يوجّه حركة المرور عبر وكيل وسيط تعرّفه إضافة Ogma. |

يمكن تمكين كل إدخال وسيط أو تعطيله وترتيبه بحسب الأولوية. استخدم ذلك لوكلاء المؤسسات أو إعدادات الاختبار المتسلسلة أو توجيه حركة المرور عبر أداة فحص أخرى.

## DNS {#dns}

| القسم | الاستخدام |
| --- | --- |
| قواعد ثابتة لإعادة كتابة المضيفات | ربط أسماء المضيفات بعناوين IP محددة دون تحرير ملف hosts لنظام التشغيل. تطابق أحرف البدل مثل `*.example.com` مستوى نطاق فرعي واحداً. |
| خوادم DNS الوسيطة | توجيه استعلامات DNS عبر محلّل مخصص. اترك نمط المضيف فارغاً لتطبيق محلّل على المستوى العام. |

تفيد إعادة كتابة DNS عند اختبار خدمات التجهيز خلف أسماء مضيفي الإنتاج أو إعادة توجيه حركة المرور إلى نقطة نهاية مختبرية مضبوطة.

## الشهادات وTLS {#certificates-and-tls}

### المرجع المصدق {#certificate-authority}

ينشئ Ogma مرجعاً مصدقاً محلياً عند التشغيل الأول. لاعتراض حركة مرور HTTPS، يجب أن يثق المتصفح أو نظام التشغيل بشهادة CA المصدرة.

1. افتح **الإعدادات > الشهادة**.
2. نزّل شهادة CA العامة لإضافتها إلى ثقة المتصفح أو نظام التشغيل.
3. ثبّتها في مخزن الثقة للمتصفح أو نظام التشغيل.

يمكن للصفحة نفسها تصدير نسخة احتياطية كاملة للمرجع المصدق أو استيراد نسخة من مثيل Ogma آخر أو إدارة مراجع مصدقة مسماة للاعتراض لكل مستمع أو إعادة إنشاء المرجع النشط. تتضمن نسخ CA الاحتياطية مادة المفتاح الخاص؛ خزّنها كالأسرار.

### شهادات العميل {#client-certificates}

استخدم **شهادات العميل** للأهداف التي تتطلب mTLS. يربط كل إدخال نمط مضيف، مثل `*.internal.corp`، بشهادة PEM ومفتاح خاص.

### تجاوز TLS {#tls-bypass}

استخدم **تجاوز فحص TLS** للمضيفات التي ينبغي تمرير حركة الاتصال بها عبر نفق دون فحص TLS. يفيد ذلك للتطبيقات التي تثبت الشهادات أو لحركة المرور التي لا تحتاج إلى فك تشفيرها عمداً.

### تشخيص TLS {#tls-diagnostics}

استخدم **تشخيص TLS** لفحص موضوع شهادة CA في Ogma وبصمة SHA-256 وفترة الصلاحية وإصدار مخطط قاعدة البيانات ونتائج اختبار اتصال TLS الحي. يبلغ اختبار الاتصال عن إصدار TLS المتفاوض عليه ومجموعة التعمية وموضوع شهادة الخادم وموضوع شهادة MITM وزمن الذهاب والإياب.

## WebSockets {#websockets}

| الإعداد | الوصف |
| --- | --- |
| الالتقاط | يتحكم في تسجيل رسائل WebSocket. |
| اعتراض رسائل WebSocket | يضع رسائل WebSocket في قائمة انتظار لوحة الاعتراض عند تمكينه. |

راجع [سجل WebSocket وSSE](./ws-sse-history.md) لمسارات عمل الفحص وإعادة الإرسال.

## الذكاء الاصطناعي {#ai}

| الخيار | الوصف |
| --- | --- |
| المزود | Anthropic أو OpenAI أو Google Gemini أو نقطة نهاية مخصصة متوافقة مع OpenAI. |
| نقطة نهاية API | نقطة النهاية الافتراضية للمزود أو عنوان URL أساسي مخصص. |
| مفتاح API | مفتاح سري للمزود المحدد. يُخزن محلياً. |
| النموذج | معرّف النموذج الذي يستخدمه مساعد Ask Bob. |
| وكيل HTTP | حقل مرجعي؛ تتبع استدعاءات المزود من المتصفح سلوك وكيل النظام. |
| خيارات متقدمة | أقصى رموز المخرجات ودرجة الحرارة ومهلة الطلب وعدد طلبات السياق الحي ورسائل سياق الأدوات وأقصى تكرارات الأدوات. |

راجع [الذكاء الاصطناعي لمساحة العمل](../guide/workspace-ai.md) لمعرفة كيفية استخدام المساعد سياق حركة المرور والأدوات.

## MCP {#mcp}

استخدم إعدادات **بروتوكول سياق النموذج** لبدء خادم MCP أو إيقافه واختيار أذونات الوكلاء الخارجيين المفعلة.

| الخيار | الوصف |
| --- | --- |
| مضيف الربط | عناوين loopback المحلية فقط: `127.0.0.1` أو `localhost` أو `::1`. تُرفض عناوين الربط العامة. |
| المنفذ | منفذ MCP مخصص لنقل Streamable HTTP؛ الافتراضي `3000`. انسخ نقطة النهاية `/mcp` الكاملة المعروضة في الإعدادات. |
| أدوات حركة المرور للقراءة فقط | متاحة دائماً: قراءة سياق المشروع وسجل HTTP والنتائج ومسارات العمل والبيانات الوصفية ذات الصلة. |
| كتابة النتائج | يسمح بإنشاء النتائج وتحديثها ووسمها وربطها. |
| تصدير البيانات | يسمح بإنشاء مهام تصدير. |
| قراءة القيم السرية | يسمح بقيم متغيرات البيئة غير المخفية، بصورة منفصلة عن إذن تعديل المتغيرات. |
| إرسال إعادة الإرسال | يسمح بأدوات إرسال الطلبات وتنقل المتصفح والزحف والاستكشاف النشط واختبار WebSocket ومساعدات ملفات تعريف المصادقة. |
| تشغيل مسار العمل | يسمح بمعاينة مسار العمل وتنفيذه وإلغائه. |
| التحكم في الاعتراض | يسمح بتمكين حركة المرور الحية المعترضة أو إيقافها مؤقتاً أو تعديلها أو تمريرها أو إسقاطها. |

عطّل الأذونات التي لا تحتاجها. راجع [إعداد MCP](../mcp-setup.md) و[موارد MCP وأدواته](../reference/mcp-tools.md).

يعيد الحفظ تشغيل خادم MCP العامل تلقائياً. أعد توصيل العملاء بعد الحفظ؛ واستخدم تشخيص التشغيل للتحقق من أخطاء بدء التشغيل. لا توجد للقدرات المفعلة حصص نشاط لكل دقيقة أو جلسة، مع استمرار تطبيق حدود كل أداة.

## الماسح الأمني {#scanner}

تحتوي صفحة **الماسح الأمني** على محرر القواعد السلبية المخصصة. تعمل القواعد على حركة مرور HTTP الملتقطة وتعرض نتائج أمنية. راجع [الماسح الأمني](./utilities/scanner.md) لبنية القواعد واستخدامها.

## المهل {#timeouts}

استخدم **المهل الزمنية** لضبط سلوك الاتصالات الصادرة.

| الإعداد | الافتراضي | الوصف |
| --- | --- | --- |
| مهلة الاتصال | `30000ms` | الوقت المسموح لإنشاء اتصال TCP بالخادم. |
| مهلة القراءة | `60000ms` | الوقت المسموح لاستلام بيانات الاستجابة بعد فتح الاتصال. |
| مهلة الكتابة | `60000ms` | الوقت المسموح لإرسال بيانات الطلب إلى الخادم. |

تطبق الإعدادات المسبقة ملفات مهل شائعة بسرعة. زد القيم للأهداف البطيئة؛ وخفضها عندما ينبغي للفحوص الكبيرة الفشل سريعاً.

## الأمان {#security}

| القسم | الوصف |
| --- | --- |
| التحقق من TLS للخادم | يتحكم في تحقق Ogma من شهادات TLS للخادم. أبقه مفعلاً إلا عند اختبار مختبر أو هدف ذي TLS معطل. |
| مصادقة API | تحمي API في Ogma برمز Bearer. مطلوبة عند الربط بعنوان غير localhost. |
| طلبات مسار العمل | تحذر من أن عقد الطلبات في مسار العمل تتجاوز إعدادات الوكيل ومرشحات النطاق. راجع مسارات العمل قبل تشغيل تعريفات غير موثوقة. |

## مخططات Protobuf {#protobuf-schemas}

استخدم **مخططات Protobuf** لرفع ملفات `FileDescriptorSet` الثنائية المترجمة من مصادر `.proto`. يستخدم Ogma هذه المخططات لفك الترميز القائم على المخطط في لوحات الاستجابة وأدوات protobuf.

## تخصيص المطور {#developer-customization}

| الصفحة | الوصف |
| --- | --- |
| CSS مخصص | يطبق أنماطاً مخصصة على واجهة Ogma. تسري التغييرات مباشرة. |
| JavaScript مخصص | يشغّل JavaScript في سياق التطبيق. يمكن للبرامج النصية طباعة المخرجات وإعدادها للتشغيل التلقائي عند بدء التشغيل. |

استخدم تخصيص المطور لتخصيص مساحة العمل المحلية، لا لحالة المشروع المشتركة.

## استكشاف الأخطاء وحول التطبيق {#troubleshooting-and-about}

| الصفحة | الوصف |
| --- | --- |
| استكشاف الأخطاء | يعرض إصدارات الخادم وElectron ويعيد ضبط إعدادات الواجهة ويعرض موقع السجل. |
| حول التطبيق | يعرض هوية المنتج والإصدار الحالي ومعرّف commit المستخدم للبناء وحالة التحديث وروابط الإصدارات. |

## صفحات ذات صلة {#related-pages}

* [إعداد MCP](../mcp-setup.md)
* [نموذج الأمان](../security.md)
* [استكشاف الأخطاء](../troubleshooting.md)