دليل ShareX Custom Uploader: روابط لقطات الشاشة ذات الاستضافة الذاتية
ShareX أداة لقطات شاشة مجانية ومفتوحة المصدر لنظام Windows، تجمع بين التقاط الشاشة وتسجيلها ومشاركة الملفات وأدوات الإنتاجية.
تصف وثائق Custom Uploader في ShareX، التي اطُّلع عليها في أكتوبر 2026، نظامًا يتيح لك رفع الصور والنصوص والملفات إلى خدمات الاستضافة أو اختصار العناوين ومشاركتها. يتبع هذا الدليل تلك الوثائق: كيف يعمل Custom Uploader، وكيف تُعدّه بشكل سليم، وكيف تحافظ على أمان بيانات اعتمادك أثناء ذلك.
اقرأ وثائق Custom Uploader في ShareX.
تمييز رئيسي قدماً: يُستخدم Custom Uploader للتواصل مع نقطة HTTP نهائية خاصة بك أو تابعة لجهة خارجية. ويوفّر ShareX أيضًا أدلة لـ Amazon S3 وGoogle Cloud Storage وCloudflare R2، فابحث عن دليل لتخزينك قبل أن تكتب طلب HTTP يدويًا.
ما هو محرر التحميل المخصص فعلاً
كما تقول وثائق ShareX الخاصة بها، تُستخدم ميزة المرفوعة المخصصة في الغالب من قبل الأشخاص الذين يستضيفون خدماتهم الخاصة. في الممارسة العملية، هذا تعريف صغير يخبر ShareX: عندما التقط شيئاً ما، أرسله إلى هذا الرابط، باستخدام هذا الطلب، والعثور على الرابط الناتج في هذا الجزء من الاستجابة. احصل على هذه الأشياء الثلاثة بشكل صحيح و ShareX يرفع بهدوء وينسخ عنوان URL عامل في كل مرة تقص.
الطلب: الطرق وأنواع النص
يدعم المرفوع المخصص لـ ShareX طرق HTTP القياسية - GET و POST و PUT و PATCH و DELETE. كقاعدة عملية من التوثيق: إذا كان الطلب يحمل فقط معاملات وليس نصًا، GET يتضمن إرسال ملف كـ multipart/form-data، POST هو الخيار المعتاد.
بالنسبة لنص الطلب، يقدم ShareX عدة أنواع لتطابق مهما كان ما ينتظره نقطة نهايتك:
- بلا محتوى — المعاملات فقط.
- بيانات النموذج (multipart/form-data) — الخيار النموذجي لرفع ملف.
- نموذج مشفّر في عنوان URL (application/x-www-form-urlencoded).
- JSON (application/json).
- XML (application/xml).
- ثنائي — الملف الخام كجسم.
توثيق API الخاص بخادمك يخبرك بالطريقة ونوع الجسم الذي يتوقعه؛ أنت تعكس ذلك ببساطة في تعريف ShareX.
تحليل الاستجابة: أين الرابط؟
بعد الرفع، تستجيب نقطتك النهائية — عادةً بـ JSON أو XML أو نص عادي — وعليك أن تخبر ShareX بالحقل الذي يحمل عنوان URL النهائي. يمنحك ShareX هذه الطرق لاستخراجه:
- JSON استخدام بناء جملة JsonPath، مثل
{json:data.link}لقراءةdata.linkمن رد JSON. - XML باستخدام XPath، على سبيل المثال
{xml:/files/file[1]/url}. - Regex لمطابقة النمط على رد نص عادي.
- الرؤوس لقراءة عنوان URL يتم إرجاعه في رأس الاستجابة.
إذا نجح الرفع لكن عنوان URL الذي ينسخه ShareX فارغ أو مشوّه، فقد يكون المحلل يشير إلى الحقل الخطأ. انظر في الاستجابة الخام التي يعيدها خادمك وتتبّع المسار الدقيق إلى سلسلة URL.
خطوة بخطوة: إعداد نظيف
- اقرأ مستندات API الخاص بـ endpoint ولاحظ الطريقة والنوع الجسم واسم الحقل للملف وأي رأس مصادقة والموقع الدقيق لعنوان URL في الاستجابة.
- عمل نسخة احتياطية من إعدادات ShareX الحالية أولاً. صدّر إعدادات وجهتك الموجودة حتى تتمكن من الرجوع إذا تصرفت التغييرات بشكل خاطئ.
- إنشاء محرر التحميل المخصص في ShareX (Destinations → Custom uploader settings). قم بتعيين طريقة الطلب وعنوان URL الوجهة والرؤوس ونوع النص لمطابقة ما يتوقعه endpoint الخاص بك.
- قم بتكوين محلل الاستجابة استخدام JsonPath أو XPath أو regex أو قاعدة رأس صحيحة حتى يعيد ShareX الرابط الصحيح.
- اختبر مع لقطة غير ضارة - صورة تُستخدم مرة واحدة - وتأكد من أن الرابط المُعاد يفتح الملف فعليًا.
- التحقق من سلوك الحذف/الاحتفاظ إذا كانت نقطة نهايتك تدعم الحذف، حتى تعرف كيفية إزالة تحميل لاحقًا.
- اضبطها كوجهة نشطة فقط بمجرد ارتباط اختبار حقيقي يعمل من البداية إلى النهاية.
مشاركة وإعادة استخدام الإعدادات: ملفات .sxcu
يمكن تصدير أداة المرفوع المخصص المكتملة كـ .sxcu ملف. يمكن لمستخدم آخر استيراده بالنقر المزدوج على الملف، و ShareX تطبق تكوين الوجهة تلقائياً. يجعل من السهل مشاركة إعداد عامل عبر أجهزتك الخاصة أو مع فريق — لكنه أيضاً بالضبط حيث يتسرب الأسرار، لذا اقرأ القسم التالي قبل أن ترسل واحدة إلى أي شخص.
حماية أسرارك
غالبًا ما يحتوي المرفوع المخصص على مفاتيح API أو الرموز أو الاعتمادات الموقعة. تعامل مع .sxcu ملف مثل كلمة سر:
- قبل مشاركة الإعدادات، أزل أو استبدل الاعتمادات الحقيقية مع العناصر النائبة. أ
.sxcuيمكنك نشر المفاتيح المباشرة. - يفضل الرموز المحدودة والقابلة للإلغاء على مفاتيح رئيسية طويلة الأجل، لذا فإن التسرب محتوى وسهل الدوران.
- تحميل دائماً عبر HTTPS حتى لا يتم إرسال الاعتمادات والملفات دون تشفير.
- قلب أي شيء قد يكون تعرضت - لقطات الشاشة وإعداداتها تسافر أبعد مما تتوقع.
يفضل وجهة مدمجة عند وجود واحد
إذا كان تخزينك Amazon S3 أو Google Cloud Storage أو Cloudflare R2، فاتبع دليل ShareX لذلك المزوّد بدل بناء طلب HTTP عام يدويًا. فدليل ShareX لـ Amazon S3، مثلًا، يغطي الحاوية (bucket) ومفاتيح الوصول ونطاقًا مخصصًا اختياريًا. واحتفظ بـ HTTP Custom Uploader العام للنقاط النهائية التي لا يوجد لها دليل.
يستطيع Maxisnap Studio أيضًا الرفع إلى خادمك الخاص
Maxisnap Studio، ترقية لمرة واحدة، تضيف خوادم تحميل مخصصة - SFTP و FTP و S3-compatible و HTTP — فتُرفع لقطاتك على Windows إلى تخزين تتحكم فيه. يمكنك الاطلاع على كيفية بناء خيارات الرفع في Maxisnap في صفحتَي الرفع عبر SFTP و الرفع عبر S3 / R2، أو اقرأ الصفحة الأشمل: نظرة عامة على Maxisnap و ShareX.
Maxisnap غير تابعة لـ ShareX. تصف هذه الصفحة ShareX كما عرضها موقعه الرسمي في أكتوبر 2026؛ راجع الموقع الرسمي لمعرفة الميزات والأسعار والأنظمة الحالية. getsharex.com