🛠️ تثبيت ConvertX — محوّل ملفات ذاتي الاستضافة
انشر ConvertX على Ubuntu بـ Docker — محوّل ويب ذاتي الاستضافة يدعم أكثر من ألف صيغة عبر الصور والمستندات والصوت والفيديو، على المنفذ 3042.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/convertx/convertx-ubuntu.sh
chmod +x convertx-ubuntu.sh
sudo bash convertx-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/convertx/convertx-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x convertx-ubuntu.sh
3 تشغيل المُثبّت
يثبّت السكريبت Docker إن لزم، يُولّد JWT_SECRET بـ openssl، ويُشغّل ConvertX على المنفذ 3042 مع ضبط ACCOUNT_REGISTRATION وHTTP_ALLOWED كلاهما على true، والبيانات في ./data.
sudo bash convertx-ubuntu.sh
4 التسجيل والتحويل
افتح ConvertX، سجّل الحساب الأول، ثم ارفع ملفاً واختر صيغة الهدف:
http://<your-server-ip>:3042
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3042 | Web UI (host → container 3000) — JWT_SECRET generated |
| ACCOUNT_REGISTRATION | true — set to false after you register |
| ./data | Accounts and converted files |
نظرة عامة
ConvertX تطبيق ويب ذاتي الاستضافة ومفتوح المصدر لتحويل الملفات بين أكثر من ألف مزيج صيغة، يمتد عبر الصور والمستندات والصوت والفيديو وغيرها. بدلاً من إعادة تطبيق منطق التحويل بنفسها، تُغلّف أدوات سطر أوامر راسخة — FFmpeg للصوت/الفيديو، وImageMagick وlibvips للصور، وPandoc وCalibre للمستندات — خلف واجهة ويب موحدة واحدة، فتحصل على قدراتها مجتمعة من دورة عمل رفع-وتنزيل واحدة.
لماذا تستخدمه
المحوّلات المجانية عبر الإنترنت مريحة لكنها تستلم نسخة كاملة من كل ملف ترفعه، والعديد منها يحتفظ بذلك المحتوى أو يفحصه — قلق حقيقي للعقود ومسح الهوية والمستندات المالية أو أي شيء آخر لا تريد تسليمه لطرف ثالث. تمنحك ConvertX نفس راحة السحب والإفلات بينما لا يغادر الملف سيرفرك الخاص أبداً. ولأنها تُجمّع عدة محركات تحويل مفتوحة المصدر ومُثبَتة خلف واجهة واحدة، تتفادى أيضاً تثبيت وتعلّم FFmpeg وImageMagick وPandoc كلاً على حدة فقط للتعامل مع تحويلات صيغ عرضية.
متى تحتاجه
- تُحوّل ملفات بين الصيغ بانتظام وتريد واجهة ويب بسيطة بدلاً من حفظ صيغة أوامر FFmpeg أو ImageMagick
- تتعامل مع مستندات حساسة (عقود، مسح هوية، سجلات مالية) ولا تريد رفعها لمحوّل عبر إنترنت طرف ثالث
- تريد أداة واحدة تغطي تحويل الصور والمستندات والصوت والفيديو بدلاً من أدوات منفصلة لكل نوع صيغة
- يحتاج فريقك تحويل ملفات مشتركاً عبر المتصفح دون تثبيت برامج تحويل على كل جهاز
- تريد استضافة ذاتية لخدمة تحل محل مواقع تحويل مجانية مدعومة بالإعلانات أو منتهكة للخصوصية
من يحتاجه
- الأفراد والشركات المهتمون بالخصوصية الذين يحتاجون تحويل مستندات حساسة دون رفعها لموقع طرف ثالث
- عشاق الاستضافة الذاتية الذين يريدون محوّل ملفات عام الغرض كجزء من مختبرهم المنزلي أو سحابتهم الشخصية
- الفرق والمكاتب الصغيرة التي تحتاج بانتظام تحويل مستندات أو صور أو وسائط بين الصيغ لأسباب توافق
- المطورون والمبدعون الذين يحتاجون أحياناً تحويل صيغ (صور، ترميزات صوتية، أنواع مستندات) دون تثبيت أدوات سطر أوامر متعددة
- مديرو تقنية المعلومات الذين يوفّرون أداة تحويل داخلية مشتركة لموظفين غير تقنيين لا ينبغي أن يحتاجوا وصولاً لسطر الأوامر
- المستخدمون الذين سئموا من مواقع التحويل المجانية المُثقَلة بالإعلانات أو البطيئة أو محدودة الرفع
حالات الاستخدام الشائعة
- تحويل مستندات ممسوحة أو عقود بين PDF وDOCX وصيغ أخرى دون إرسالها لمحوّل عبر إنترنت
- تحويل صور بالجملة بين الصيغ (PNG، JPEG، WebP، HEIC، وغيرها) لموقع أو أرشيف
- تحويل ملفات صوت وفيديو بين ترميزات وحاويات لتوافق مع أجهزة أو منصات مختلفة
- توفير أداة تحويل ملفات داخلية مشتركة لفريق أو مكتب صغير دون تثبيت FFmpeg أو ImageMagick على كل جهاز
- تحويل كتب إلكترونية ومستندات بين الصيغ (EPUB، MOBI، PDF، وغيرها) باستخدام أدوات تحويل المستندات المُجمَّعة
الميزات الرئيسية
- تدعم أكثر من ألف مزيج صيغة عبر الصور والمستندات والصوت والفيديو بتغليف FFmpeg وImageMagick وlibvips وPandoc وCalibre
- واجهة ويب بسيطة بالسحب والإفلات — ارفع ملفاً، اختر صيغة الهدف، وحمّل النتيجة
- حسابات مستخدمين بمصادقة، تتيح لك التحكم بمن يمكنه التسجيل واستخدام المحوّل
- تعمل بالكامل في حاوية Docker واحدة دون تبعيات خارجية غير أدوات التحويل المُجمَّعة
- مصادقة جلسة قائمة على JWT بسر عشوائي مُولَّد لجلسات دخول آمنة
- ذاتية الاستضافة ومفتوحة المصدر، فلا تغادر الملفات بنيتك التحتية الخاصة أثناء التحويل
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:3042 وسجّل الحساب الأول بينما ACCOUNT_REGISTRATION ما زال مفعّلاً
- اضبط ACCOUNT_REGISTRATION فوراً على false بعد إنشاء الحسابات التي تحتاجها، لمنع أي شخص آخر من التسجيل
- ارفع ملفاً تجريبياً وحوّله بين الصيغ للتأكد أن أدوات التحويل الأساسية (FFmpeg، ImageMagick، Pandoc) تعمل بشكل صحيح
- ضع ConvertX خلف وكيل عكسي بشهادة TLS صالحة، ثم اضبط HTTP_ALLOWED على false مجدداً بمجرد تفعيل HTTPS
- راجع دليل ./data دورياً، لأن الملفات المُحوَّلة تتراكم فيه ويمكن أن تستهلك مساحة قرص كبيرة مع الوقت
- أنشئ حسابات فردية لكل عضو فريق بدلاً من مشاركة تسجيل دخول واحد إذا كان عدة أشخاص سيستخدمون المحوّل
أفضل ممارسات الأمان
- اضبط ACCOUNT_REGISTRATION على false فوراً بعد إنشاء حساباتك — تركه true يتيح لأي شخص يجد الرابط التسجيل واستخدام موارد محوّلك
- اضبط HTTP_ALLOWED على false بمجرد وضع ConvertX خلف وكيل عكسي منهي لـ TLS — تركه true يُبطل جزءاً من غرض إضافة HTTPS
- لا تكشف المنفذ 3042 مباشرة للإنترنت أبداً دون وكيل عكسي وشهادة TLS صالحة أمامه
- تعامل مع JWT_SECRET كمادة حساسة — تدويرها يُبطل كل جلسات الدخول الحالية، لذا خزّنها بأمان ولا تُعد توليدها عرضياً
- تنبّه أن الملفات المُحوَّلة قد تبقى في دليل ./data — طبّق صلاحيات نظام ملفات مناسبة إذا كان للسيرفر مستخدمون آخرون
- حدّث صورة ConvertX Docker بانتظام، لأنها تُجمّع عدة أدوات تحويل طرف ثالث (FFmpeg، ImageMagick، Pandoc) قد تتلقى تصحيحات أمان خاصة بها
المنافذ وإعدادات جدار الحماية
تستمع ConvertX على منفذ المضيف 3042، مُطابَق من منفذ الحاوية الداخلي 3000 — إذا رأيت إشارات للمنفذ 3000 في التوثيق الأصلي، فذلك منفذ الحاوية الداخلي، لا ما تتصل به على المضيف. لا تكشف المنفذ 3042 مباشرة للإنترنت أبداً دون وكيل عكسي يوفّر TLS، لأن HTTP_ALLOWED مفعّل افتراضياً أثناء الإعداد الأولي وستنتقل رفعات الملفات دون تشفير دون ذلك. بمجرد وضع وكيل عكسي بشهادة صالحة، اضبط HTTP_ALLOWED على false وقيّد الوصول المباشر للمنفذ 3042 بجدار ناري بحيث يصل إليه الوكيل العكسي فقط.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً دليل ./data الذي يحمل حسابات المستخدمين وبيانات المصادقة والملفات المُحوَّلة
- انسخ احتياطياً قيمة JWT_SECRET بشكل منفصل إذا أردت استمرارية الجلسات عبر إعادة نشر — إعادة توليدها ستُخرج كل المستخدمين
- نظّف دورياً الملفات المُحوَّلة القديمة في ./data إذا لم تعد مطلوبة، لأن التحويلات يمكن أن تتراكم وتستهلك مساحة قرص
- وثّق إعداد متغيرات بيئتك (ACCOUNT_REGISTRATION، HTTP_ALLOWED، JWT_SECRET) حتى تتمكن من إعادة إنشاء الإعداد بالضبط بعد الترحيل
- اختبر استعادة دليل ./data إلى حاوية ConvertX جديدة دورياً للتأكد أن الحسابات والإعدادات تعود بشكل صحيح
الأخطاء الشائعة
- ترك ACCOUNT_REGISTRATION مضبوطاً على true إلى أجل غير مسمى، مما يتيح لأي شخص يجد الرابط التسجيل واستخدام موارد تحويل سيرفرك
- ترك HTTP_ALLOWED مضبوطاً على true بعد وضع ConvertX خلف HTTPS، مما يُقوّض غرض إضافة TLS أصلاً
- كشف المنفذ 3042 مباشرة للإنترنت دون أي وكيل عكسي أو طبقة مصادقة أمامه
- افتراض أن المنفذ 3000 من التوثيق الأصلي هو ما تتصل به — يُطابقه المُثبّت لمنفذ المضيف 3042
- عدم تنظيف الملفات المُحوَّلة القديمة في ./data، مما يترك استخدام القرص ينمو دون رقابة مع الوقت
- رفع ملفات وسائط كبيرة جداً وتوقّع تحويل فوري — تحويل الفيديو خاصة يمكن أن يكون مكثف المعالج وبطيئاً على عتاد متواضع
- إعادة توليد JWT_SECRET دون تحذير المستخدمين، مما يُخرج الجميع من جلساتهم بشكل غير متوقع
استكشاف الأخطاء وإصلاحها
- تعذّر تسجيل حساب جديد — تحقق أن ACCOUNT_REGISTRATION مضبوط على true؛ ربما عُطّل بشكل صحيح بعد الإعداد الأولي
- صفحة التسجيل تُحمَّل لكن الحسابات الجديدة لا تعمل — راجع سجلات الحاوية بـ docker logs convertx لأخطاء مصادقة أو JWT
- التحويل يفشل لصيغة معينة — تحقق أن تلك الصيغة مدعومة فعلياً بمراجعة أي أداة أساسية (FFmpeg، ImageMagick، Pandoc) تتعامل معها، لأن التغطية تختلف حسب زوج الصيغ
- تحويلات بطيئة، خاصة للفيديو — ترميز الفيديو مكثف المعالج؛ تحقق من استخدام CPU للسيرفر أثناء التحويل وفكّر بمضيف أقوى للأحمال الثقيلة من الفيديو
- أخطاء محتوى مختلط أو تسجيل دخول بعد إضافة HTTPS — تأكد أن HTTP_ALLOWED ضُبط على false وأن الوكيل العكسي يُحوّل بشكل صحيح للمنفذ 3042
- القرص يمتلئ بشكل غير متوقع — تحقق من حجم دليل ./data، لأن الملفات المُحوَّلة تتراكم فيه ولا تُحذف تلقائياً
البدائل
CloudConvert واجهة برمجية سحابية مُدارة شهيرة وموقع تحويل بأوسع دعم صيغ، لكنه يعني رفع الملفات لخدمة طرف ثالث ويتضمن عادةً تسعيراً حسب الاستخدام. Stirling-PDF بديل ذاتي الاستضافة قوي إذا كانت احتياجات التحويل لديك تركّز تحديداً على PDF (دمج، تقسيم، ضغط، تحويل من/إلى PDF) بدلاً من عام الغرض. XnConvert محوّل صور دفعي مكتبي مجاني، خيار جيد إذا كنت تحتاج فقط تحويل صور محلياً على جهاز واحد دون تشغيل سيرفر. استخدام FFmpeg وImageMagick وPandoc مباشرة من سطر الأوامر يمنح تحكماً كاملاً وبلا عبء سيرفر ويب، لكنه يتطلب تعلّم صيغة كل أداة على حدة بدلاً من واجهة موحدة واحدة. لمحوّل ذاتي الاستضافة عام الغرض يغطي الصور والمستندات والصوت والفيديو من واجهة ويب واحدة، تبقى ConvertX من أكثر الخيارات مفتوحة المصدر شمولاً.
متى لا تستخدمه
تجاوز ConvertX إذا كانت احتياجات التحويل لديك تركّز ضيقاً على نوع صيغة واحد — Stirling-PDF خيار أفضل لسير عمل PDF فقط، وأداة صور مخصصة قد تكون أبسط إذا كنت تُحوّل الصور فقط دائماً. إذا احتجت تحويلاً لصيغ نادرة جداً أو مملوكة، تحقق أن أدوات ConvertX الأساسية (FFmpeg، ImageMagick، Pandoc، Calibre) تدعم فعلياً تلك الصيغة المحددة قبل الالتزام، لأن التغطية تختلف حسب زوج الصيغ. للتحويلات العرضية والمنفردة على جهاز واحد، قد تكون أداة مكتبية أو أدوات سطر الأوامر مباشرة أبسط من تشغيل سيرفر مخصص. وإذا كنت تُحوّل ملفات فيديو كبيرة جداً بانتظام، خصّص ميزانية لسيرفر بموارد CPU كافية، لأن ترميز الفيديو أكثر استهلاكاً للموارد بكثير من تحويل الصور أو المستندات.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الذي يمكن لـ ConvertX تحويله فعلياً؟
أكثر من ألف مزيج صيغة عبر الصور والمستندات والصوت والفيديو. تحصل على هذا النطاق بتجميع أدوات معيارية — FFmpeg للوسائط، وImageMagick وlibvips للصور، وPandoc للمستندات — خلف واجهة ويب واحدة، فتحصل على قدراتها مجتمعة دون تثبيت أو تعلّم أي منها منفردة.
لماذا الاستضافة الذاتية لمحوّل بدلاً من استخدام محوّل مجاني عبر الإنترنت؟
لأن المحوّلات عبر الإنترنت تستلم نسخة كاملة من كل ملف ترفعه، وغالباً ما تحتفظ بها وأحياناً تفحصها. للعقود ومسح الهوية أو أي شيء سري، هذا خطر حقيقي. تمنحك ConvertX نفس الراحة بينما لا يغادر الملف سيرفرك أبداً.
أي منفذ تستخدم؟
منفذ المضيف 3042، مُطابَق من المنفذ الداخلي 3000 للحاوية. تصفّح إلى 3042؛ المنفذ 3000 الذي قد تراه في التوثيق الأصلي هو منفذ الحاوية الداخلي.
هل يجب أن أترك التسجيل مفتوحاً؟
لا — يُضبط ACCOUNT_REGISTRATION على true حتى تتمكن من إنشاء الحساب الأول، لكن يجب ضبطه على false بعد ذلك. إذا تُرك مفتوحاً على نسخة قابلة للوصول، يمكن لأي شخص يجد الرابط التسجيل واستخدام محوّلك ومورده بحرية.
ما هو غرض HTTP_ALLOWED؟
يُضبط على true حتى تتمكن من الوصول لـ ConvertX عبر HTTP عادي أثناء الإعداد الأولي. بمجرد وضعها خلف وكيل عكسي منهي لـ TLS، اضبط HTTP_ALLOWED على false مجدداً حتى يتوقّع التطبيق اتصالات آمنة. تركه مفعّلاً يُبطل جزءاً من غرض إضافة HTTPS.