دليل ShareX Custom Uploader: روابط لقطات الشاشة ذات الاستضافة الذاتية
أحد الأسباب التي يحبها مستخدمو الطاقة ShareX هي أنها لا تقفل لقطات الشاشة في السحابة من شخص آخر. مع محرر تحميل مخصص، ShareX يمكنه دفع كل التقاط إلى وجهة أنت التحكم — خادمك الخاص أو دلو التخزين الموضوع أو نقطة اختصار الرابط — والعودة لك عنوان URL قابل للمشاركة تلقائياً. يشرح هذا الدليل كيفية عمل نظام محمل التحميل المخصص، وكيفية إعداد واحد بنظافة، وكيفية الاحتفاظ بأوراق اعتمادك آمنة بينما تفعل ذلك.
تمييز رئيسي قدماً: ShareX محرر تحميل HTTP عام يتحدث إلى endpoint HTTP الخاص بك أو طرف ثالث. لتخزين الكائنات الرئيسي، ShareX أيضاً يشحن أدلة الوجهة المدمجة — بما في ذلك Amazon S3 و Google Cloud Storage و Cloudflare R2 — والتي تكون عادة أسهل من كتابة طلب HTTP يدوياً. اختر المسار المدمج عندما يكون موجوداً؛ استخدم محمل 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 عام باليد. الوجهات المدمجة تتعامل مع التوقيع الخاص بالمزود وإعداد المجال المخصص لك، وهو عدد أقل من الأجزاء المتحركة وأماكن أقل لارتكاب خطأ. احجز أداة تحميل HTTP المخصصة العام للنقاط النهائية التي لا تحتوي على خيار مدمج.
إذا كنت تفضل عدم تكوين الطلبات يدوياً
محمل التحميل المخصص قوي بالضبط لأنه قابل للتخصيص بالكامل — تلك المرونة هي النقطة، وللمالكين الذاتيين إنها مثالية. إذا كنت تحب امتلاك التخزين الخاص بك لكن تفضل اختيار مزود بدلاً من كتابة طلبات HTTP وموجزات الاستجابة، يمكن لإعداد موجه أن يوفر الوقت. Maxisnap Studio، ترقية لمرة واحدة، تضيف خوادم تحميل مخصصة - SFTP و FTP و S3-compatible و HTTP — لذا يتم تحميل الالتقاطات الخاصة بـ Windows إلى التخزين الذي تتحكم به مع تدفق إعداد أبسط. إنه مقايضة مختلفة عن منشئ الطلب المفتوح بالكامل في ShareX، موجهة للأشخاص الذين يريدون الملكية بدون تفاصيل مستوى الطلب. يمكنك رؤية كيفية هيكلة خيارات التحميل من Maxisnap على الرفع عبر SFTP و الرفع عبر S3 / R2 الصفحات، أو اقرأ أوسع نظرة عامة على Maxisnap و ShareX.
ShareX هي علامة تجارية لمالكها الخاص؛ Amazon S3 و Google Cloud Storage و Cloudflare R2 هي علامات تجارية لمالكيها الخاصين. تم فحص تفاصيل ميزات ShareX مقابل التوثيق الرسمي لـ ShareX في 17 أغسطس 2026 وقد تتغير. Maxisnap هي منتج مستقل وليست مرتبطة بأو يتم تأييدها من قبل أو برعاية أي من هذه المشاريع أو الشركات.