🚀 مدعوم بالذكاء الاصطناعي وآمن 100%

مرجع Wrangler الاحترافي

لماذا هذا الدليل مختلف؟

🔒

أمان تام (Zero Exposure)

لا توجد مفاتيح API مكشوفة في كود الواجهة. جميع الطلبات تمر عبر الـ Worker الخاص بك بشكل مشفر.

🎓

من المبتدئ إلى المحترف

شرح تفصيلي لكل مرحلة: من تسجيل الدخول الأولي إلى إدارة النسخ والتراجع.

🤖

مساعد ذكي مدمج

اسأل عن أي أمر Wrangler مباشرة من الموقع، وسيقوم المساعد بالرد عليك باستخدام نماذج AI.

المرحلة الأولى: التهيئة والدخول

🖥️ Terminal
# 1. تثبيت Node.js (متطلب مسبق) ثم تثبيت Wrangler عالمياً
npm install -g wrangler

# 2. تسجيل الدخول لحساب Cloudflare (سيفتح متصفح للتأكيد)
wrangler login

# 3. التحقق من هوية الحساب المتصل حالياً
wrangler whoami

# 4. إنشاء مشروع جديد (سيوجهك معالج تفاعلي)
wrangler init my-pro-worker

المرحلة الثانية: الأوامر الاحترافية

🚀 دورة حياة المشروع
# تشغيل الخادم المحلي للمعاينة الفورية مع محاكاة السحابة
wrangler dev

# نشر المشروع على بيئة الإنتاج (Production)
wrangler deploy

# نشر المشروع مع تسمية إصدار محدد (مفيد للتتبع)
wrangler deploy --message "تحديث واجهة API"
🗄️ إدارة قواعد البيانات (KV & D1)
# إنشاء مساحة تخزين KV جديدة
wrangler kv namespace create "MY_CACHE"

# إدراج بيانات في KV (مع تحديد الـ Binding)
wrangler kv key put --binding=MY_CACHE "user:101" '{"name":"أيوب"}'

# قراءة البيانات من KV
wrangler kv key get --binding=MY_CACHE "user:101"

# إنشاء قاعدة بيانات SQLite (D1) جديدة
wrangler d1 create my-database
🔐 إدارة الأسرار بأمان
# إضافة سر جديد (سيطلب منك إدخال القيمة بشكل مخفي)
wrangler secret put OPENROUTER_API_KEY

# عرض قائمة الأسرار المحفوظة (بدون إظهار قيمها)
wrangler secret list

# حذف سر لم يعد مستخدماً
wrangler secret delete OLD_API_KEY
👑 أدوات المحترفين والمراقبة
# مراقبة السجلات (Logs) بشكل مباشر ومباشر (Tail)
wrangler tail

# عرض سجلات مع تصفية حسب مستوى الخطأ فقط
wrangler tail --status error

# عرض سجل الإصدارات المنشورة (Versions)
wrangler versions list

# التراجع عن نشر خاطئ إلى إصدار سابق (Rollback)
wrangler rollback

🤖 دمج الذكاء الاصطناعي بأمان

مثال على كيفية وصول الـ Worker إلى النماذج دون كشف المفاتيح في الواجهة الأمامية.

كود الـ Worker الآمن (الخلفي)

📄 worker.js
// المفتاح يُقرأ من بيئة Cloudflare الآمنة وليس من الكود
const apiKey = env.OPENROUTER_API_KEY;

const response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ model: "meta-llama/llama-3-8b-instruct:free", messages })
});

🤖 مساعد Wrangler

آمن ومدعوم بـ AI
أهلاً أيوب! 👋 كيف يمكنني مساعدتك في أوامر Wrangler اليوم؟