صفحات الخطأ

يعرض خادم Unne صفحات خطأ منسّقة لزوار المتصفح عند حدوث خطأ ما.

أنواع الصفحات

صفحة التحذير (200)

تُعرض عند أول زيارة من المتصفح لنفق. تطلب من الزائر تأكيد رغبته في المتابعة.

خيارات التجاوز:

• كوكي unne_confirmed_<subdomain>=1 (يُعيَّن تلقائياً بعد التأكيد، يستمر 24 ساعة)
• ترويسة X-Unne-Skip-Warning: 1
• User-Agent غير متصفح (عملاء API، curl، إلخ.)
• خيار العميل --skip-warning (إذا كان لدى المستخدم صلاحية skip_warning)

غير موجود (404)

تُعرض عندما لا يكون للنطاق الفرعي نفق نشط. تتضمن:

• رمز الخطأ ERR_UNNE_404
• أمر CLI لإصلاح المشكلة
• زر إعادة التحميل

غير متصل (502)

تُعرض عندما يكون النفق مسجلاً لكن الخدمة المحلية غير قابلة للوصول. هذا يعني:

• عميل CLI متصل بالخادم
• لكن الخدمة المحلية لا تعمل أو لا تستجيب

خطأ عام

تُعرض للأخطاء الأخرى مع رمز خطأ مخصص ورسالة.

التصميم

تستخدم جميع الصفحات تصميماً مستوحى من shadcn:

• خلفية بيضاء نظيفة
• مكون تنبيه بحد ملون على اليسار (أحمر للأخطاء، كهرماني للتحذيرات)
• أيقونات Lucide
• شارة معرّف الطلب لتسهيل التتبع
• تخطيط متجاوب

التخصيص

قوالب صفحات الخطأ مضمنة في ملف الخادم التنفيذي في internal/server/pages/. للتخصيص:

1. انسخ المستودع (Fork)
2. عدّل قوالب HTML في internal/server/pages/
3. عدّل الأنماط في internal/server/pages/base.css
4. أعد بناء الملف التنفيذي للخادم

CSS وHTML مضمنان عبر embed.FS في Go — لا توجد تبعيات خارجية في وقت التشغيل.