استكشاف الأخطاء وإصلاحها
ابحث عن الرسالة التي تراها، واقرأ السبب، وطبّق الحل.
| ما تراه | السبب والحل |
|---|---|
SFTP connections require a managed xEvolve Agent | ليس للاتصال وكيل. عدّل الاتصال، واختر وكيلاً مثبّتاً، وأعد الاختبار. ينطبق الأمر نفسه على FTP وFTPS وSMB وNFS. |
لا يسجّل الوكيل نفسه ويردّ API بـ workspace_not_ready | يشير XEVOLVE_API_URL إلى api.xevolve.io. استخدم عنوان مساحة عملك https://<workspace>.xevolve.io. |
| اختبار الوكيل أخضر لكن لا توجد نبضة | لا يتحقق اختبار الوكيل من السر. قارن AGENT_SECRET وXEVOLVE_API_TOKEN بالسر في الدليل. إذا فقدته فأنشئ وكيلاً جديداً. |
يعرض دليل نشر الوكيل <agent-secret> | يظهر السر مرة واحدة فقط عند إنشاء الوكيل. أنشئ وكيلاً جديداً للحصول على سر جديد. |
403 API key missing required scope | أضف النطاق المذكور في الرسالة. أنشئ مفتاحاً جديداً؛ لا يمكن توسيع نطاقات مفتاح موجود. |
| 403 عند إنشاء مفتاح | لا يستطيع المفتاح منح إلا النطاقات التي يملكها. استخدم جلسة لوحة التحكم أو مفتاحاً يملك كل النطاقات المطلوبة. |
| يُرفض الرفع مع 422 | حظر الفحص الملف. راجع سجل التدقيق لمعرفة تفاصيل الفحص. |
| رابط المشاركة يردّ بـ 410 | انتهت صلاحية الرابط أو بلغ حد التنزيلات. أنشئ رابطاً جديداً. |
تصفح مجلد SFTP يعرض مساراً مكرراً مثل /upload/upload | لدى الاتصال مسار ومسار أساسي معاً. أبقِ أحدهما فقط. |
| لا يستطيع شريك استيراد مفتاح أُنشئ في xEvolve | لا يقرأ GnuPG صيغة OpenPGP v6. أنشئ المفتاح باستخدام gpg واستورده في xEvolve. |
| لم يعد webhook يتلقى أحداثاً | تُحتسب عملية التسليم الفاشلة ولا تُعاد. أصلح المستقبِل وأرسل حدثاً تجريبياً. |
لأي أمر آخر، راسل hello@spot-suite.com واذكر عنوان مساحة عملك.