أضف Studio إلى حساب Cloudflare الخاص بنشاطك التجاري
إذا كان نطاق شركتك مُدارًا بالفعل في Cloudflare، فيمكن وضع Studio في الحساب نفسه، إلى جانب موقعك الإلكتروني. ويحصل على عنوان workers.dev مجاني خاص به، وعلى نطاق فرعي جديد من نطاقك إن رغبت. ويبقى موقعك الإلكتروني وسجلات DNS الخاصة به كما هي تمامًا.
- الأفضل لـ
- الشركات التي يُدار نطاقها بالفعل في Cloudflare.
- ما تحتاج إليه
- Maxisnap لنظام Windows أو Mac، مع تسجيل الدخول بالحساب الذي لديه Studio؛ وبيانات دخول إلى حساب Cloudflare الخاص بشركتك تتيح إضافة Workers، أو الشخص الذي يتولى إدارة الحساب؛ ومساعد برمجة بالذكاء الاصطناعي على جهازك، أو طرفية يتوفر فيها Node.js 20 أو أحدث.
- المدة
- نحو 20 دقيقة في المرة الأولى.
- ما تحصل عليه
- Studio على عنوان workers.dev خاص به، بالإضافة إلى نطاق فرعي جديد مثل snaps.yourcompany.com إذا أردت. ويبقى موقعك كما هو تمامًا.
- التكلفة
- صُمّم Studio ليعمل على خطة Cloudflare المجانية. تنشر Cloudflare الحصة المجانية الحالية والأسعار الخاصة بـ R2.
ما يضيفه Studio وما يتركه كما هو
ما يضيفه Studio
- تطبيق Studio نفسه (تسميه Cloudflare «Worker»)
- مساحة تخزين للقطاتك (تُسمّى «R2 bucket»)
- قاعدة بيانات صغيرة لمكتبتك وفريقك («D1»)
- عنوانه على workers.dev، بالإضافة إلى نطاق فرعي جديد واحد إذا اخترته
- اسم workers.dev لحسابك، إن لم يكن لديه اسم بعد (اسم واحد للحساب بأكمله)
ما يتركه Studio كما هو
- موقعك وملفاته
- سجلات DNS الحالية لنطاقاتك
- أي Worker أو تخزين أو قاعدة بيانات أخرى
- الفوترة وإعدادات حسابك الأخرى
إذا كان الاسم مستخدمًا بالفعل، فإن Studio يختار اسمًا آخر أو يطلب منك ذلك؛ ولا يستبدل شيئًا موجودًا بالفعل.
إذا كان شخص آخر يتولى إدارة Cloudflare أو موقعك، فاستشره أولًا. لدى بعض الشركات قواعد بشأن من يضيف الخدمات إلى حساب الشركة، أو تضع صفحة تسجيل دخول أمام كل نطاق فرعي، وهذا من شأنه أن يمنع عمليات الرفع من Maxisnap.
شارك الموجز التقني مع الشخص الذي يتولى إدارة Cloudflare لديك.
تحقق من تفعيل التخزين
يخزّن Studio لقطاتك في Cloudflare R2. سجّل الدخول إلى حساب Cloudflare الخاص بشركتك وتحقق من ذلك مرة واحدة:
- في لوحة تحكم Cloudflare، افتح «Storage & databases» ← «R2» ← «Overview».
- إذا عرضت Cloudflare إضافة R2، فأكمل عملية الدفع لديها. وإذا لم تكن أنت المسؤول عن الفوترة في الحساب، فاطلب من المسؤول عنها تنفيذ هذه الخطوة.
تعرض لوحة تحكم Studio مقدار التخزين الذي تستخدمه. بحسب ما اطّلعنا عليه في أكتوبر 2026، تقول وثائق R2 من Cloudflare إن R2 مجاني للبدء مع استخدام شهري مجاني مُضمَّن، وإنك تُحاسَب على استخدامك على أساس شهري.
احصل على Studio على جهازك
- على Windows: في Maxisnap، افتح الإعدادات ← الحساب ← معالج إعداد Maxisnap Studio، وانقر على «ابدأ الآن»، ثم «تنزيل لوحة المعلومات». يحفظ Maxisnap ملف ZIP الخاص بـ Studio في مجلد التنزيلات لديك ويفتح ذلك المجلد.
- على Mac: في Maxisnap، افتح «Settings» ← «Welcome & Help» ← «Studio Setup Guide»، وانقر على «Get Started» ثم «Download Dashboard». يحفظ Maxisnap ملف ZIP الخاص بـ Studio في مجلد التنزيلات لديك.
فك ضغط ملف ZIP. على Windows، انقر عليه بزر الماوس الأيمن واختر «استخراج الكل». وعلى Mac، انقر عليه نقرًا مزدوجًا.
هل تريد شعارك وألوانك منذ البداية؟ انقر نقرًا مزدوجًا على «Maxisnap Studio - Start Here.html»، وصمّم علامتك التجارية وانقر على «Lock in my branding». سيستخدم مساعدك ذلك. أو تخطَّ هذه الخطوة وغيّر العلامة التجارية لاحقًا من لوحة التحكم ضمن «Branding».
حدّد العنوان
يحصل Studio دائمًا على عنوان workers.dev، وهو يعمل منذ البداية. ويمكنك أيضًا إضافة نطاق فرعي جديد من نطاقك، مثل snaps.yourcompany.com، إذا كان النطاق نشطًا في حساب Cloudflare هذا.
سيبدو عنوانك هكذا: snaps.yourcompany.workers.dev
يمكنك إضافة نطاقك الخاص لاحقًا دون أن تفقد أي شيء.
سلّم المهمة إلى مساعدك الذكي
- افتح مساعد البرمجة بالذكاء الاصطناعي لديك: Claude Code أو Codex أو Cursor أو أي مساعد آخر يستطيع تشغيل الأوامر على جهازك.
- انسخ التعليمات الجاهزة من دليل الإعداد عبر المساعد الذكي في مركز المساعدة، واستبدل السطر الموجود بين الأقواس الزاوية بمجلد Studio لديك، ثم الصقها في المساعد.
- أخبره بأن نشاطك التجاري يستخدم Cloudflare بالفعل، وبما إذا كنت تريد نطاقًا فرعيًا. يقرأ ملف التعليمات في مجلد Studio ويشرح كل خطوة قبل أن ينفذها.
أنشئ مفتاح Cloudflare عندما يطلبه مساعدك
يحتاج النشر إلى إذن للعمل في حسابك. وتمنحه هذا الإذن عبر رمز API من Cloudflare، وهو يعمل مثل كلمة مرور لهذه المهمة وحدها.
- في Cloudflare، افتح «My Profile» ← «API Tokens»، وانقر على «Create Token» واختر إنشاء رمز مخصص.
- أضف هذه الأذونات الأربعة: Account Settings Read وWorkers Scripts Edit وWorkers R2 Storage Edit وD1 Edit.
- وللنطاق الفرعي، أضف ثلاثة أذونات أخرى: Zone Read وDNS Read وWorkers Routes Read.
- ضمن «Account Resources»، اختر حساب شركتك. وللنطاق الفرعي، ضمن «Zone Resources»، أدرج نطاقك.
- انقر على «Continue to summary» ثم «Create Token». تعرض Cloudflare الرمز مرة واحدة فقط، لذا انسخه فورًا.
- عندما يطلب مساعدك الرمز، الصقه في الطرفية بنفسك، وليس في المحادثة.
افتح صفحة «API Tokens» في Cloudflare.
يوضح الموجز التقني فيمَ يُستخدم كل إذن. وبمجرد أن يعمل Studio يمكنك حذف الرمز؛ أما تحديث Studio أو إزالته لاحقًا فيحتاج إلى رمز جديد.
راجع الخطة، ثم أنشئ Studio الخاص بك
لا يُنشأ أي شيء قبل أن توافق. يشغّل مساعدك الخطة أولًا ويعرضها عليك. يسرد «Will create» ما سيُنشأ: Worker واحدًا وحاوية R2 واحدة وقاعدة بيانات D1 واحدة، بالإضافة إلى اسم workers.dev الخاص بك إن كان جديدًا ونطاقك الفرعي إن اخترت نطاقًا فرعيًا. ويسرد «Will not touch» ما لن يمسّه: نطاقاتك وسجلات DNS الخاصة بها، وما لديك من Workers وحاويات وقواعد بيانات أخرى.
- إذا أظهرت الخطة مشكلة، مثل اسم مستخدم بالفعل، فاختر اسمًا آخر وشغّل الخطة مرة أخرى.
- عندما تبدو الخطة صحيحة، اطلب من مساعدك المضي قدمًا. وإذا توقف النشر في منتصف العملية، فإن تشغيل الأمر نفسه مرة أخرى يتابع دون إنشاء أي شيء مرتين.
احفظ مفتاح المسؤول
- عند الانتهاء، يعرض النشر عنوان Studio ومفتاح المسؤول الخاص به مرة واحدة. احتفظ بالمفتاح في مكان آمن، مثل مدير كلمات المرور لديك. تسجّل الدخول إلى لوحة التحكم به، ويستطيع أي شخص يملكه استخدام Studio الخاص بك.
- كما يكتب النشر ملفًا باسم deployment.json في مجلد cloudflare. احتفظ بهذا الملف، لأن تحديث Studio أو إزالته لاحقًا يستخدمه.
اربط Maxisnap وجرّبه
- Maxisnap لنظام Windows: افتح الإعدادات ← الحساب ← معالج إعداد Maxisnap Studio، وانقر على «ابدأ الآن»، ثم على «التالي» حتى الخطوة 4، «ربط Maxisnap». الصق عنوان Studio الخاص بك ومفتاحه، وانقر على «اختبار الاتصال»، ثم «التالي»، ثم «إنهاء وحفظ» في الصفحة الأخيرة. يمكنك استخدام مفتاح المسؤول الذي ظهر لك أثناء الإعداد، أو رمز رفع من «People & access» في لوحة التحكم.
- Maxisnap لنظام Mac: افتح «Settings» ← «Welcome & Help» ← «Studio Setup Guide» واختر «I already have a dashboard». الصق عنوان Studio الخاص بك ومفتاحه، وانقر على «Test Connection»، ثم «Next»، ثم «Finish & Save».
التقط شيئًا ما ثم انقر على «رفع» (أو «Upload» على Mac) في المحرر. وعلى Windows، يلتقط Ctrl+Alt+7 منطقة ويرفعها فورًا. ويصل رابط المشاركة إلى الحافظة.
يرسل Maxisnap لنظام Windows وMaxisnap لنظام Mac كل عملية رفع إلى Studio على Cloudflare في طلب واحد، ويقبل Studio ما يصل إلى 25 MB لكل ملف.
الخطوات التالية: أضف فريقك في لوحة التحكم ضمن «People & access» (يحصل كل شخص على رمزه ودوره الخاص)، وغيّر شعارك أو ألوانك في أي وقت ضمن «Branding».
إذا حدث خطأ ما
النطاق الفرعي مستخدم بالفعل
snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.
هذا الاسم يشير بالفعل إلى مكان ما، لذا يتركه Studio كما هو. اختر نطاقًا فرعيًا لا يستخدمه شيء بعد، مثل studio أو share.
يوجد مسار Worker يغطي النطاق الفرعي بالفعل
The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.
يردّ Worker آخر في حسابك على كل نطاق فرعي يطابق ذلك المسار، لذا لن يرى Studio زواره أبدًا. اختر اسمًا خارج المسار، أو اسأل الشخص الذي أعدّ المسار.
لا يستطيع Studio العثور على نطاقك
That domain is not in this Cloudflare account.
النطاق موجود في حساب Cloudflare آخر، أو أن الرمز لا يستطيع رؤيته. أنشئ الرمز في الحساب الذي يحتوي على نطاقك، بأذونات Zone Read وDNS Read وWorkers Routes Read لذلك النطاق.
نطاقك مُعلَّم بعبارة «not active yet»
yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.
لا تستجيب Cloudflare لهذا النطاق بعد، وغالبًا ما يكون السبب أن خوادم الأسماء (nameservers) لديه ما زالت تشير إلى مزوّدك القديم. استخدم عنوان workers.dev في الوقت الحالي؛ ويمكنك إضافة النطاق الفرعي لاحقًا دون أن تفقد أي شيء.
النطاق الفرعي الجديد لا يُفتح بعد
قد تستغرق Cloudflare بعض الوقت في تفعيل نطاق فرعي جديد. ويعمل عنوان workers.dev منذ البداية، لذا استخدمه إلى ذلك الحين.
تفشل عمليات الرفع على النطاق الفرعي، لكن عنوان workers.dev يعمل
هناك إعداد أمان في Cloudflare على ذلك النطاق الفرعي يمنع Maxisnap: Cloudflare Access (صفحة لتسجيل الدخول أمام العنوان)، أو قاعدة WAF، أو Bot Fight Mode. اطلب من الشخص الذي يتولى إدارة Cloudflare لديك السماح بمرور النطاق الفرعي الخاص بـ Studio. يسرد الموجز التقني ما يجب فحصه.
تقول الخطة إنها لم تستطع فحص مسارات Worker
Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).
أضف Workers Routes Read إلى الرمز. وبدونه لا يستطيع Studio معرفة ما إذا كان Worker آخر يلتقط النطاق الفرعي الجديد بالفعل.
التخزين غير مفعّل
R2 storage is not turned on for this Cloudflare account yet.
فعّل R2 في لوحة تحكم Cloudflare كما في الخطوة 1، ثم اطلب من مساعدك تشغيل الخطة مرة أخرى.
اسم Studio مستخدم بالفعل
A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.
أعطِ مساعدك اسمًا آخر، مثل snaps-yourcompany. وإذا كان اسم مساحة التخزين أو قاعدة البيانات مستخدمًا، فإن أداة النشر تختار الاسم المتاح التالي من تلقاء نفسها.
رفضت Cloudflare إحدى الخطوات
Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.
ينقص الرمز أحد الأذونات. أنشئ رمزًا جديدًا بالأذونات الواردة في الخطوة 5 والصقه في الطرفية مرة أخرى عندما يطلب مساعدك ذلك.
توقف الإعداد في منتصف العملية
اطلب من مساعدك تشغيل أمر النشر نفسه مرة أخرى. سيتابع من حيث توقف ولن ينشئ أي شيء مرتين.
عنوانك الجديد لا يُفتح بعد
Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.
تم إنشاء كل شيء؛ لكن Cloudflare ما زالت تُفعّل العنوان. انتظر بضع دقائق ثم افتح العنوان مرة أخرى.
فقدت مفتاح المسؤول
يمكن لمساعدك تعيين مفتاح جديد. يشغّل هذا الأمر من مجلد cloudflare في حزمة Studio، مع رمز Cloudflare في الطرفية. يعرض الأمر المفتاح الجديد مرة واحدة؛ ثم اربط Maxisnap من جديد باستخدامه.
node deploy/cli.mjs update --record deployment.json --yes --new-admin-keyلا تُرفع مقاطع الفيديو الكبيرة
يرسل Maxisnap لنظام Windows وMaxisnap لنظام Mac كل عملية رفع إلى Studio على Cloudflare في طلب واحد، ويقبل Studio ما يصل إلى 25 MB لكل ملف.
أبقِ التسجيلات دون ذلك الحجم، أو قصّر مدتها قبل الرفع.
يقول Maxisnap إن المفتاح غير صحيح
انسخ المفتاح مرة أخرى من المكان الذي حفظته فيه، دون مسافات قبله أو بعده. وتحقق من العنوان أيضًا: فهو العنوان الذي عرضه عليك الإعداد، ويبدأ بـ https://.
لا تزال بحاجة إلى مساعدة؟
راسلنا عبر البريد الإلكتروني وسيرد عليك شخص، عادةً خلال يوم عمل واحد. تساعدنا هذه التفاصيل على الرد عليك برسالة واحدة:
- خيار الإعداد الذي اخترته والخطوة التي أنت فيها.
- لقطة شاشة للشاشة، مع أي رسالة خطأ كاملة.
- المكان الذي ستضع فيه Studio: حساب Cloudflare جديد أو حالي، أو اسم مزوّد استضافة الويب لديك.
- إصدار Maxisnap لديك: على Windows في الإعدادات ← حول؛ وعلى Mac ضمن «Maxisnap»، ثم «About Maxisnap».
يُرجى عدم إرسال مفتاح المسؤول أو مفتاح Cloudflare أو كلمة مرور. لا نحتاج إليها لمساعدتك.