---
url: https://docs.ogmabox.com/fa/troubleshooting.md
description: >-
  تشخیص مشکلات رایج راه‌اندازی Ogma، ثبت ترافیک پراکسی، رهگیری HTTPS، محیط اجرای
  دسکتاپ، افزونه‌ها، MCP، اسکنر و خروجی‌گیری.
---

# عیب‌یابی {#troubleshooting}

از این صفحه برای تشخیص مشکلات رایج راه‌اندازی و اجرای Ogma استفاده کنید.

## در تاریخچهٔ HTTP ترافیکی نمایش داده نمی‌شود {#no-traffic-appears-in-http-history}

این موارد را بررسی کنید:

1. نمونهٔ Ogma در حال اجرا باشد.
2. پراکسی مرورگر یا برنامه به شنوندهٔ نمونه اشاره کند؛ این نشانی معمولا `127.0.0.1:8080` است.
3. برنامهٔ هدف پراکسی را دور نزند.
4. تنظیمات VPN، پراکسی سیستم، کانتینر، شبیه‌ساز یا پراکسی موبایل تنظیمات کلاینت آزمایش را نادیده نگیرند.
5. پروژهٔ فعال در فضای کاری باز باشد.

اگر از مرورگر Ogma استفاده می‌کنید، زبانهٔ تازه‌ای باز کنید و مطمئن شوید نشان **از طریق پراکسی** قابل مشاهده است.

## درخواست‌های HTTPS ناموفق هستند {#https-requests-fail}

این موارد را بررسی کنید:

* گواهی مرجع صدور گواهی Ogma در مخزن اعتماد درست نصب شده باشد.
* گواهی CA را در همان پروفایل مرورگری وارد کرده باشید که واقعا استفاده می‌شود.
* هدف از تثبیت گواهی استفاده نکند.
* قواعد عبور مستقیم TLS میزبان را مستثنی نکرده باشند.
* اگر هدف به mTLS نیاز دارد، الزامات گواهی کلاینت در **تنظیمات > گواهی‌های کلاینت** پیکربندی شده باشند.

برای برنامه‌های موبایل یا دسکتاپ دارای تثبیت گواهی، ممکن است به راه‌اندازی آزمایشی ویژهٔ آن برنامه در خارج از Ogma نیاز داشته باشید.

## رهگیری بیش از حد ترافیک را متوقف می‌کند {#intercept-pauses-too-much-traffic}

از قواعد رهگیری محدودتر استفاده کنید.

مراحل پیشنهادی:

1. رهگیری را غیرفعال کنید.
2. محدوده را تعریف کنید.
3. شرط‌های تطبیق برای میزبان، متد، مسیر، نوع محتوا یا هدر اضافه کنید.
4. رهگیری را دوباره فعال کنید.
5. اندازهٔ صف را زیر نظر بگیرید.

اگر صف به ظرفیت خود برسد، Ogma ترافیک جدید را عبور می‌دهد تا کلاینت دچار بن‌بست نشود.

## اسکنر موارد غیرضروری زیادی گزارش می‌کند {#scanner-reports-too-much-noise}

برای کاهش موارد غیرضروری اسکنر پسیو:

* پیش از اسکن، محدوده را فعال کنید.
* ابتدا روی یافته‌های با شدت متوسط، زیاد و بحرانی تمرکز کنید.
* یافته‌های مربوط به نبود هدر را وابسته به زمینه در نظر بگیرید.
* برای شواهد مختص پروژه از قواعد پسیو سفارشی استفاده کنید.

برای کاهش موارد غیرضروری اسکنر فعال:

* پیش از اسکن تمام تاریخچه، درخواست‌های انتخاب‌شده را اسکن کنید.
* درخواست‌های اثبات و بدنهٔ پاسخ‌ها را بررسی کنید.
* مطمئن شوید شواهد پاسخ در پاسخ مبنا وجود نداشته‌اند.
* بررسی کنید که میزان اطمینان یافته، محتمل است یا تأییدشده.

## افزونه‌ها بارگذاری نمی‌شوند {#plugins-do-not-load}

این موارد را بررسی کنید:

1. ریشهٔ افزونه شامل `manifest.json` باشد.
2. مسیرهای نقطهٔ ورود در مانیفست پس از ساخت وجود داشته باشند.
3. افزونه به JavaScript ساده کامپایل شده باشد.
4. دارایی‌های فرانت‌اند در بستهٔ افزونه گنجانده شده باشند.
5. مجوزهای لازم اعلام و اعطا شده باشند.
6. زبانهٔ لاگ افزونه فاقد خطاهای `init()` یا پل ارتباطی باشد.
7. اندازهٔ بستهٔ افزونه کمتر از حد پیکربندی‌شده باشد.

## دستیار MCP به Ogma دسترسی ندارد {#mcp-assistant-cannot-see-ogma}

این موارد را بررسی کنید:

* HTTP تعبیه‌شده: MCP در **تنظیمات > MCP** اجرا شود و کلاینت از نقطهٔ پایانی Streamable HTTP کپی‌شده استفاده کند؛ این نشانی معمولا `http://127.0.0.1:3000/mcp` است.
* stdio مستقل: مسیر فایل اجرایی درست باشد و `--api-url` / `OGMA_API_URL` با بک‌اند در حال اجرا مطابقت داشته باشد. نمونه‌های دسکتاپ ممکن است از پورت API پویا استفاده کنند.
* کلاینت تمام نشانگرهای صفحه‌بندی `tools/list` را دنبال کند؛ صفحهٔ اول به‌تنهایی شامل همهٔ ابزارها نیست.
* ابزارهای نوشتن یا ارسال به مجوزهای صریح در تنظیمات یا فلگ‌های مستقل نیاز دارند.
* پس از راه‌اندازی مجدد MCP، دوباره متصل شوید. شناسه‌های جلسه و توکن‌های تأیید قدیمی دیگر معتبر نیستند.

به [راه‌اندازی MCP](./mcp-setup.md) مراجعه کنید.

## مرورگر Ogma خالی است یا در موقعیت نادرست قرار دارد {#ogma-browser-is-blank-or-mispositioned}

این موارد را بررسی کنید:

* برنامهٔ دسکتاپ را اجرا کرده باشید، نه فقط فرانت‌اند وب را.
* زبانهٔ فعال به‌جای `about:blank` یک URL واقعی داشته باشد.
* باز کردن مرورگر در پنجره‌ای جداگانه را امتحان کنید.
* اندازهٔ پنجرهٔ Ogma را تغییر دهید تا محدودهٔ مرورگر دوباره محاسبه شود.

## JavaScript یا CSS سفارشی رابط کاربری را مختل می‌کند {#custom-javascript-or-css-breaks-the-ui}

از یکی از مسیرهای بازیابی استفاده کنید:

* روی **بازنشانی رابط کاربری سفارشی** کلیک کنید.
* `Ctrl+Alt+Shift+R` را فشار دهید.

این کار JavaScript و CSS سفارشی را از ذخیره‌سازی محلی، تنظیمات دسکتاپ و ترجیحات بک‌اند پاک می‌کند و سپس Ogma را دوباره بارگذاری می‌کند.

## داده‌ها یا پروژه نادرست به نظر می‌رسند {#data-or-project-looks-wrong}

این موارد را بررسی کنید:

* نمونهٔ درست باز باشد.
* پروژهٔ درست فعال باشد.
* ترجیحات راه‌اندازی، نمونهٔ دیگری را دوباره باز نکرده باشند.
* فیلترها یا محدوده، ردیف‌های مورد انتظار را پنهان نکرده باشند.
* پنهان‌سازی دارایی‌های ایستا، نوع محتوای مورد نظر شما را مستثنی نکرده باشد.

پیش از تغییر دستی داده‌های پروژه، نسخهٔ پشتیبان تهیه کنید.