لا توجد مفاتيح API مكشوفة في كود الواجهة. جميع الطلبات تمر عبر الـ Worker الخاص بك بشكل مشفر.
شرح تفصيلي لكل مرحلة: من تسجيل الدخول الأولي إلى إدارة النسخ والتراجع.
اسأل عن أي أمر Wrangler مباشرة من الموقع، وسيقوم المساعد بالرد عليك باستخدام نماذج AI.
# 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 جديدة
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 إلى النماذج دون كشف المفاتيح في الواجهة الأمامية.
// المفتاح يُقرأ من بيئة 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 })
});