📁 تثبيت Filestash — واجهة ويب واحدة لكل تخزينك

انشر Filestash على Ubuntu بـ Docker — مدير ملفات ويب واحد يتصل بـ S3 وFTP وSFTP وSMB وWebDAV والمزيد، ليمنح كل تخزينك واجهة نظيفة واحدة، على المنفذ 8334.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر Filestash على المنفذ 8334. عيّن كلمة مرور المسؤول عند أول زيارة، ثم اربط خلفيات التخزين لديك (S3، FTP، SFTP، SMB، WebDAV).
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/filestash/filestash-ubuntu.sh
chmod +x filestash-ubuntu.sh
sudo bash filestash-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/filestash/filestash-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x filestash-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم ويُشغّل Filestash على المنفذ 8334، مع تخزين حالته في ./data. لا يحمل Filestash نفسه أي ملفات — بل يتصل بخلفيات التخزين التي تضبطها.

sudo bash filestash-ubuntu.sh

4 فتح واجهة الويب وتعيين كلمة مرور المسؤول

افتح Filestash في متصفحك، عيّن كلمة مرور المسؤول عند أول زيارة، ثم أضف اتصالات التخزين الخاصة بك:

http://<your-server-ip>:8334

المنافذ المستخدمة

المنفذالغرض
8334Web UI — set the admin password on first visit
backendsConnects to S3, FTP, SFTP, SMB, WebDAV — stores no files itself
./dataFilestash config and backend connections (holds credentials)

نظرة عامة

Filestash مدير ملفات ويب شامل مفتوح المصدر وذاتي الاستضافة. بدلاً من تخزين الملفات بنفسه، فهو واجهة أمامية واحدة ومصقولة فوق تخزين يعيش بالفعل في مكان آخر — Amazon S3 وتخزين كائنات متوافق مع S3، سيرفرات FTP وSFTP، مشاركات SMB/Windows، نقاط نهاية WebDAV، مستودعات Git، وأنواع خلفيات أخرى عديدة. تستطيع تصفح وتحميل ومشاركة وإدارة الملفات عبر كل هذه الأنظمة من خلال واجهة ويب واحدة متسقة.

لماذا تستخدمه

تنتهي معظم البنى التحتية بتخزين مبعثر عبر عدة أنظمة — حاوية S3 هنا، سيرفر SFTP هناك، مشاركة NAS في مكان آخر — وكل منها عادة ما يتطلب عميله الخاص وبيانات اعتماده وسير عمله. يضع Filestash واجهة واحدة قائمة على المتصفح أمام كل هذه الأنظمة، بحيث تستطيع أنت أو فريقك تصفح حاوية S3 كأنها مجلد، أو منح شخص وصول SFTP دون تثبيت عميل SFTP، أو منح واجهة ودودة لمشاركة NAS، كل ذلك من أداة واحدة ذاتية الاستضافة تتحكم بها.

متى تحتاجه

  • تدير ملفات عبر خلفيات تخزين متعددة — S3، SFTP، SMB، WebDAV — وتريد واجهة واحدة بدلاً من التنقل بين عملاء منفصلين
  • تريد منح مستخدمين غير تقنيين واجهة ويب بسيطة لتصفح حاوية S3 أو سيرفر SFTP دون تثبيت برامج مخصصة
  • تحتاج مشاركة وصول لتخزين معيّن دون تسليم بيانات اعتماد خام للأنظمة الأساسية
  • تريد بديلاً ذاتي الاستضافة لواجهة ويب Dropbox أو Google Drive لتخزين تملكه بالفعل
  • تحتاج طريقة خفيفة لتصفح وإدارة الملفات على NAS أو مخزن كائنات من أي جهاز بمتصفح
  • تريد تكامل SSO (LDAP وSAML وOIDC) أمام خلفيات تخزين لا تدعمه أصلاً

من يحتاجه

  • عشاق الاستضافة الذاتية والمختبرات المنزلية الذين يُشغّلون خلفيات تخزين متعددة ويريدون واجهة أمامية واحدة قائمة على المتصفح
  • مديرو الأنظمة الذين يمنحون زملاء غير تقنيين وصولاً بسيطاً عبر المتصفح لتخزين S3 أو SFTP أو SMB
  • الشركات الصغيرة التي تريد واجهة ويب شبيهة بـ Dropbox فوق بنيتها التحتية الخاصة بدلاً من خطة سحابية مدفوعة
  • فرق DevOps التي تحتاج وصولاً عبر المتصفح لحاويات S3 بين الحين والآخر دون تثبيت وضبط أدوات CLI في كل مكان
  • المؤسسات التي تستخدم LDAP أو SAML أو OIDC وتريد SSO أمام أنظمة تخزين قديمة مثل FTP أو SMB
  • المستشارون والوكالات الذين يحتاجون مشاركة وصول محدد لتخزين عميل معيّن دون كشف بيانات اعتماد الخلفية الكاملة

حالات الاستخدام الشائعة

  • تصفح وإدارة حاوية S3 عبر واجهة ويب نظيفة بدلاً من لوحة AWS أو أداة CLI
  • منح عضو فريق وصول SFTP أو SMB عبر المتصفح دون تثبيت أي برنامج عميل
  • توحيد الوصول للملفات المبعثرة عبر خلفيات تخزين متعددة في رابط واحد محفوظ
  • معاينة وتحرير ومشاركة ملفات مخزّنة في مستودعات Git أو نقاط WebDAV من المتصفح
  • منح العملاء وصولاً محدوداً عبر المتصفح لمجلدات معيّنة على بنيتك التحتية
  • استبدال واجهة ويب تخزين سحابي تجاري بمكافئ ذاتي الاستضافة فوق تخزين تتحكم به بالفعل

الميزات الرئيسية

  • دعم واسع للخلفيات — تخزين كائنات متوافق مع S3، وFTP، وSFTP، ومشاركات SMB/Windows، وWebDAV، وGit، والمزيد
  • لا يخزّن أي ملفات خاصة به — يحتفظ Filestash فقط بالإعدادات وبيانات اعتماد الخلفيات التي تربطها
  • تكامل SSO مع LDAP وSAML وOIDC لمصادقة على طراز المؤسسات أمام أي خلفية
  • معاينة وتحرير الملفات داخل المتصفح لأنواع الملفات الشائعة دون تحميلها أولاً
  • روابط مشاركة لملفات أو مجلدات معيّنة دون كشف بيانات اعتماد الخلفية الخام
  • بنية إضافات قابلة للتوسيع لمصادقة مخصصة أو خلفيات تخزين أو تكاملات سير عمل
  • نشر ذاتي الاستضافة بترخيص AGPLv3، مع فئة Enterprise مدفوعة اختيارية للمؤسسات الأكبر

كيفية الاستخدام بعد التثبيت

  • افتح http://your-server-ip:8334 مباشرة بعد التثبيت وعيّن كلمة مرور المسؤول قبل أن يتمكن أي شخص آخر
  • أضف أول اتصال تخزين لديك — S3، SFTP، FTP، SMB، أو WebDAV — ببيانات اعتماد تلك الخلفية
  • اختبر التصفح والتحميل والتنزيل على الاتصال الجديد قبل الاعتماد عليه لعمل حقيقي
  • أضف خلفيات تخزين إضافية حسب الحاجة — كل اتصال يُضبط بشكل مستقل
  • اضبط SSO (LDAP أو SAML أو OIDC) ضمن إعدادات المسؤول إذا أردت مصادقة مركزية بدلاً من حسابات محلية
  • أعدّ روابط المشاركة بعناية، مراجعاً إعدادات الانتهاء والوصول قبل إرسالها خارجياً
  • ضع Filestash خلف وكيل عكسي مع HTTPS قبل منح الوصول لأي شخص خارج شبكتك المحلية

أفضل ممارسات الأمان

  • عيّن كلمة مرور المسؤول فوراً عند أول زيارة — أي نسخة غير مُطالَب بها على المنفذ 8334 يمكن لأول شخص يصل إليها ضبطها
  • لا تكشف المنفذ 8334 مباشرة للإنترنت أبداً دون TLS أمامه — تُدخَل بيانات اعتماد التخزين وتُستخدم عبر هذه الواجهة
  • خزّن بيانات اعتماد الخلفية فقط لمستوى الوصول المطلوب فعلياً — استخدم مستخدمي IAM محدودي الصلاحية لـ S3 بدلاً من مفاتيح حساب جذر
  • راجع وقيّد أوقات انتهاء روابط المشاركة، لأن رابطاً عاماً منسياً يمكن أن يكشف الملفات إلى أجل غير مسمى
  • فعّل SSO (LDAP أو SAML أو OIDC) للتحكم المركزي بالوصول وإلغاء الصلاحيات بسهولة عند مغادرة شخص للمؤسسة
  • أبقِ دليل ./data منسوخاً احتياطياً ومقيّد الوصول، لأنه يخزّن بيانات اعتماد اتصالات الخلفية
  • حدّث صورة Filestash Docker بانتظام لتحصل على تصحيحات أمان للتطبيق وتبعياته

المنافذ وإعدادات جدار الحماية

يستمع Filestash على المنفذ 8334 لواجهته على الويب، وهو المكان الذي تُعيَّن فيه كلمة مرور المسؤول عند أول زيارة وحيث تُضبط كل اتصالات التخزين. يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت العام دون وكيل عكسي ينهي TLS أمامه، لأن بيانات اعتماد التخزين الأساسية تُدخَل وتُنقَل عبر هذه الواجهة. تُوصَل خلفيات التخزين نفسها — S3، FTP، SFTP، SMB، WebDAV — بشكل صادر من حاوية Filestash باستخدام أي منافذ وبروتوكولات تتطلبها، ولا يخزّن Filestash أي ملفات محلياً بخلاف إعداداته الخاصة في دليل ./data.

النسخ الاحتياطي والصيانة

  • انسخ دليل ./data احتياطياً — فهو يحمل إعدادات Filestash وبيانات اعتماد كل خلفية تخزين متصلة
  • خزّن هذه النسخة الاحتياطية مشفّرة، لأنها تحمل فعلياً مفاتيح كل أنظمة التخزين المتصلة
  • وثّق الخلفيات المتصلة وإعداداتها، في حال احتجت إعادة ربطها يدوياً بعد إعادة بناء
  • تذكّر أن Filestash نفسه لا يحمل بيانات ملفات — تُنسَخ ملفاتك الفعلية احتياطياً بشكل منفصل عند خلفية التخزين، وليس عبر Filestash
  • اختبر استعادة دليل ./data على نسخة جديدة للتأكد أن اتصالات التخزين تعود للعمل
  • انسخ ملف docker-compose.yml أو إعدادات التثبيت احتياطياً حتى يمكن إعادة نشر الحاوية بنفس الإعدادات

الأخطاء الشائعة

  • ترك النسخة غير مُطالَب بها بعد التثبيت — أول زائر للمنفذ 8334 يستطيع تعيين كلمة مرور المسؤول
  • كشف المنفذ 8334 مباشرة للإنترنت دون وكيل عكسي وTLS أمامه
  • استخدام بيانات اعتماد جذر أو كاملة الصلاحية لخلفية تخزين بينما مستخدم محدود الصلاحية سيكون أكثر أماناً
  • إنشاء روابط مشاركة دون تاريخ انتهاء ونسيان وجودها، ما يترك الملفات مكشوفة إلى أجل غير مسمى
  • افتراض أن Filestash ينسخ ملفاتك احتياطياً — فهو يدير الوصول فقط؛ الملفات نفسها تعيش عند الخلفية ويجب نسخها احتياطياً هناك
  • عدم نسخ دليل ./data احتياطياً، ما يفقد كل اتصال تخزين مُعدّ ويتطلب إعادة ربط كل شيء يدوياً

استكشاف الأخطاء وإصلاحها

  • تعذّر الوصول لواجهة الويب — تأكد أن الحاوية تعمل بأمر docker ps وأن المنفذ 8334 مُعيَّن وغير محظور بجدار الحماية
  • فشل اتصال التخزين — تحقق مرتين من بيانات الاعتماد وعناوين نقطة النهاية وأن الخلفية قابلة للوصول فعلياً من مضيف Filestash
  • حاوية S3 لا تُتصفَّح بشكل صحيح — تحقق أن صلاحيات IAM المرفقة ببيانات الاعتماد تتضمن وصول list وread للحاوية
  • انتهاء مهلة اتصال SFTP أو FTP — تحقق أن جدار حماية سيرفر الخلفية يسمح باتصالات من IP مضيف Filestash
  • فشل تسجيل الدخول عبر SSO — تحقق أن إعدادات LDAP أو SAML أو OIDC تطابق بالضبط إعدادات مزوّد الهوية وروابط إعادة التوجيه
  • فشل رفع الملفات الكبيرة — تحقق من إعداد الحد الأقصى لحجم الجسم في أي وكيل عكسي، فقد يكون يحدّ حجم الرفع قبل وصوله لـ Filestash

البدائل

Cyberduck وWinSCP عميلان مكتبيان شائعان يدعمان الكثير من نفس الخلفيات (S3، SFTP، FTP، WebDAV)، لكنهما يتطلبان تثبيت وضبط برنامج على كل جهاز بدلاً من منح وصول قائم على المتصفح من أي مكان. يستطيع Nextcloud أيضاً ربط تخزين خارجي لكنه أساساً منصة تعاون ومزامنة كاملة بعبء أكبر بكثير إذا كان كل ما تحتاجه هو متصفح ملفات موحّد. Cloud Commander وelFinder مديرا ملفات ويب آخران، لكنهما يركّزان عموماً على نظام ملفات السيرفر المحلي بدلاً من اتساع دعم الخلفيات البعيدة الذي يقدّمه Filestash. كواجهة أمامية خفيفة وذاتية الاستضافة وقائمة على المتصفح مبنية خصيصاً لتوحيد خلفيات تخزين مختلفة عديدة خلف واجهة واحدة، لدى Filestash منافسون مفتوحو المصدر مباشرون قليلون.

متى لا تستخدمه

إذا كنت تصل دائماً لخلفية تخزين واحدة فقط ولديك بالفعل عميل أصلي جيد لها — لوحة AWS لـ S3، تطبيق SFTP لـ SFTP — فإن تشغيل واجهة أمامية ويب منفصلة يضيف مكوّناً للصيانة بفائدة قليلة. Filestash أيضاً ليس حل نسخ احتياطي أو تخزين ملفات بحد ذاته — فهو لا يخزّن ملفات، فقط إعدادات الاتصال، لذا فهو لا يُغني عن نسخ بياناتك الفعلية احتياطياً عند خلفيتها الأصلية. وإذا احتجت ميزات تعاون عميقة مثل تحرير المستندات في الوقت الفعلي، والإصدارات، وسير عمل مشاركة الفريق، فإن منصة كاملة مثل Nextcloud تذهب أبعد من تركيز Filestash على التصفح والنقل.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو Filestash؟

إنه مدير ملفات ويب شامل. بدلاً من تخزين الملفات بنفسه، فهو واجهة أمامية واحدة ومصقولة فوق تخزين يعيش في مكان آخر — S3، FTP، SFTP، مشاركات SMB/Windows، WebDAV، والمزيد — يمنحك واجهة واحدة لتصفح وتحميل ومشاركة الملفات عبر كل هذه الأنظمة.

ما خلفيات التخزين التي يدعمها؟

نطاق واسع: تخزين كائنات متوافق مع S3، سيرفرات FTP وSFTP، مشاركات SMB/Windows، نقاط نهاية WebDAV، مستودعات Git، والمزيد. هذا الاتساع هو صلب الفكرة — تستطيع تصفح حاوية S3 كأنها مجلد، أو منح شخص وصول SFTP دون تطبيق SFTP، أو وضع واجهة ودودة على مشاركة NAS، كل ذلك من نفس الواجهة.

ما المنفذ الذي يستخدمه وما بيانات الدخول؟

يعمل Filestash على المنفذ 8334. لا توجد كلمة مرور مُعدّة مسبقاً — تُعيّن كلمة مرور المسؤول عند أول زيارة لك، لذا افعل ذلك فوراً قبل أن يتمكن أي شخص آخر على الشبكة من المطالبة بالحساب.

هل يخزّن Filestash ملفاتي؟

لا — هذه نقطة أساسية. لا يخزّن Filestash أي ملفات خاصة به؛ يخزّن فقط الإعدادات وبيانات اعتماد الخلفيات التي تربطها. تبقى ملفاتك الفعلية دائماً على تلك الخلفيات (حاوية S3، سيرفر SFTP، مشاركة SMB، وهكذا).

ما الفرق بينه وبين Filebrowser؟

Filebrowser مدير ملفات ويب خفيف لنظام الملفات المحلي الخاص بالسيرفر نفسه. أما Filestash فيتصل خارجياً بخلفيات تخزين بعيدة مثل S3 وSFTP وSMB ويعرضها في واجهة موحّدة واحدة، بدلاً من إدارة ملفات مخزّنة محلياً على سيرفر Filestash نفسه.