التوثيق/الاتصال/لوحتك الخاصة/إن حدث خلل·4 / 9
إن حدث خلل
ابدأ بأمرين: sudo veli panel يعرض حالة اللوحة، وsudo veli doctor على خادم العقدة يبيّن لماذا لا يتصل الجهاز.
اللوحة لا تفتح
sudo veli panel على خادمها يبيّن إن كانت تعمل. افتح المنفذ 443، ومع النطاق 80 أيضًا، في جدار حماية المضيف إن كان له جدار خاص.
لم تصدر الشهادة
يجب أن يشير النطاق إلى خادم اللوحة وأن يكون المنفذ 80 مفتوحًا. آخر خطأ يعرضه sudo veli panel. بلا نطاق تُثبَّت اللوحة بعنوان IP: --host.
الخادم لا ينزّل الأمر
قد لا يفتح موقعنا من بعض البلدان ومنها روسيا. نزّل ملف veli على حاسوبك وانسخه إلى الخادم — scp veli root@<العنوان>:~ — وشغّل السطر بدون جزء curl. وللعقدة عبر SSH — nodes add مع --from و--node-from.
توقف nodes add
يذكر السبب بالكلمات ويعيد الخادم كما كان، فتشغيله من جديد آمن. يلزم root (--ssh root@العنوان) وبصمة مطابقة: إن لم تطابق فالعنوان غير صحيح. وللسكربت تُعطى البصمة مسبقًا — --fingerprint.
عقدة صامتة أو «لم ترسل تقريرًا بعد»
على خادم العقدة يبيّن sudo veli panel متى خرج آخر تقرير. تحتاج العقدة إلى الوصول إلى اللوحة عبر عنوانها — افحص curl -I https://panel.example.com والمنفذ 443. ثم شغّل nodes add نفسه.
العميل لا يرى عقدة جديدة
تصل العقدة مع التحديث التالي للاشتراك — حدّثه في التطبيق. وافحص مجموعة العميل أيضًا: قد لا تكون العقدة فيها.
ضاع الرمز
يُعرض مرة واحدة. اسحبه — sudo veli token revoke site — وأصدر رمزًا جديدًا.
اختفى عميل أو عقدة
أعد اللوحة من نسخة — sudo veli panel restore.
API
الأخطاء الشائعة في الواجهة البرمجية وخطافات الويب، وما العمل حيالها.
400 name- الاسم فارغ أو أطول من 40 حرفًا أو فيه محارف تحكّم أو بشكل c_ مع 12 حرفًا أو كلمة من كلمات API: bulk وfind
400 taken- هذا الاسم مستخدم
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
400 main- العقدة الرئيسية للوحة المصغّرة لا تُعطَّل ولا تُزال
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
404 none- المطلوب غير موجود، أو استدعاء غير معروف
409 idempotency- مفتاح Idempotency-Key هذا استُخدم لطلب آخر. المفتاح لعملية واحدة: للتمديد مفتاح وللإنشاء مفتاح آخر
411 length- جسم بلا Content-Length (مقسّم chunked): أرسله كاملًا
413 big- جسم الطلب أكبر من 1 ميغابايت، وmax هو الحد. قسّم تعديل الكثيرين إلى أجزاء
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
كل طلب يعود بـ«غير موجود»
عنوان API خاطئ: تحقّق من النطاق والمسار السري و/api/ — يطبع veli token add عنوان API مع الرمز.
خطأ CORS في المتصفح
هذا مقصود: الرمز لخوادمك، ولن تسأل صفحة في المتصفح اللوحة. لتتصل الصفحة بخادمك، وهو باللوحة.
التوقيع لا يتطابق
في الغالب — الجسم حُلّل وأُعيد تجميعه. خذ البايتات الخام: في Express — express.raw، وفي Flask — request.get_data(). وتحقّق أن السرّ لهذا الخطاف: فالخطاف المضاف من جديد له سرّ آخر.
لا أحداث إطلاقًا
الخطاف غير موجود في veli webhook list، أو الحدث المطلوب غير مذكور في --events — أو اللوحة لا تعمل: يُظهر ذلك sudo veli panel على خادمها.