📁 تثبيت SFTPGo — خادم نقل الملفات الآمن المتعدد البروتوكولات SFTP وWebDAV على Docker
نشر خادم SFTPGo على Ubuntu باستخدام Docker — الحل مفتوح المصدر الرائد لنقل الملفات الآمن عبر بروتوكولات SFTP على المنفذ 2022، وWebDAV، ولوحة تحكم ويب وعميل متصفح على المنفذ 8154 مع دعم التخزين السحابي S3.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/sftpgo/sftpgo-ubuntu.sh
chmod +x sftpgo-ubuntu.sh
sudo bash sftpgo-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/sftpgo/sftpgo-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x sftpgo-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين للإعدادات والملفات (`./config` و`./data`) وتشغيل حاوية SFTPGo الرسمية على المنفذ 8154 (لوحة الإدارة) والمنفذ 2022 (خدمة SFTP).
sudo bash sftpgo-ubuntu.sh
4 إنشاء حساب المشرف وإضافة المستخدمين
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8154. أنشئ حساب المشرف الأول، وأضف مستخدمين افتراضيين مع تخصيص المجلدات والحصص، واختبر نقل الملفات عبر SFTP على المنفذ 2022.
http://<your-server-ip>:8154
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8154 | Web admin panel + web client (host → container 8080) |
| 2022 | SFTP endpoint |
نظرة عامة
تعد SFTPGo بوابة وخادم نقل ملفات آمن ومفتوح المصدر فائق الأداء وغني بالميزات. تم تطويره بلغة Go ليوفر دعماً متعدداً للبروتوكولات يشمل SFTP (بروتوكول نقل الملفات الآمن عبر SSH على المنفذ 2022)، وFTPS، وFTP، وWebDAV، مع عميل ويب تفاعلي حديث على المنفذ 8154 (المحول من 8080 الداخلي). وتدعم المنصة التخزين على الأقراص المحلية أو ربط حاويات التخزين السحابي (Amazon S3 وGoogle Cloud Storage وAzure Blob)، مع إمكانية تحديد حصص التخزين وسرعات النقل، وتفعيل خطافات الـ Webhooks عند رفع الملفات، والمصادقة الثنائية (2FA).
لماذا تستخدمه
يتطلب استخدام خادم OpenSSH الافتراضي في لينكس لنقل الملفات إنشاء حسابات مستخدمين حقيقية بالنظام، مما يفتح ثغرات أمنية ويزيد من مخاطر الوصول لسطر الأوامر دون توفير لوحة رسومية لإدارة الحصص وسجلات النقل. تعزل SFTPGo حسابات نقل الملفات بالكامل داخل قاعدة بيانات خفيفة: حيث تتيح إدارة آلاف المستخدمين الافتراضيين، وتحديد مساحات التخزين، وفرض مفاتيح SSH العامة، ومتابعة النقل حياً دون إنشاء مستخدم واحد على نظام لينكس.
متى تحتاجه
- تحتاج إلى خادم SFTP وWebDAV آمن للعملاء وسكريبتات النسخ الاحتياطي دون إنشاء حسابات بنظام لينكس
- تبحث عن بديل مجاني ومفتوح المصدر لبوابات SFTP التجارية باهظة الثمن (مثل AWS Transfer Family أو Globalscape)
- تحتاج إلى نقل ملفات متعدد البروتوكولات: يتيح للمستخدمين الاتصال بـ SFTP (منفذ 2022) أو WebDAV أو المتصفح
- تريد ربط عملاء SFTP مباشرة بمساحات التخزين الكائني السحابية (Amazon S3 وBackblaze B2)
- تحتاج إلى تحديد دقيق لحصص التخزين لكل مستخدم، وتقييد سرعة النقل، وتشغيل Webhooks تلقائية عند رفع الملفات
من يحتاجه
- مديرو الأنظمة لاستقبال ملفات العملاء والفواتير والتقارير المالية اليومية المؤتمتة بأمان
- مهندسو الـ DevOps لتهيئة وجهات SFTP معزولة لاستقبال النسخ الاحتياطية وقواعد البيانات دورياً
- الشركات والوكالات لتوفير بوابات رفع ملفات آمنة ومعزولة للمتعاونين والعملاء الخارجيين
- المؤسسات التي تشترط الامتثال الأمني وسجلات التدقيق والمصادقة الثنائية (2FA) لنقل البيانات
- أصحاب السيرفرات المنزلية لتوفير خدمة SFTP وWebDAV آمنة لمشاركة الملفات العائلية
حالات الاستخدام الشائعة
- توفير خادم SFTP (`sftp://ip-سيرفرك:2022`) لـ 50 شركة خارجية مع عزل مجلد كل شركة بالكامل
- ربط حاوية Amazon S3 كمجلد افتراضي يتيح للبرامج القديمة الرفع إلى S3 عبر بروتوكول SFTP مباشرة
- تشغيل سكريبت Webhook آلي لمعالجة ملفات الإكسل والـ CSV فور اكتمال رفعها من قبل العميل
- توصيل مجلد المستخدم كقرص شبكي على أنظمة Windows وmacOS عبر بروتوكول WebDAV
- تمكين المستخدمين غير التقنيين من رفع ومشاركة الملفات عبر واجهة المتصفح الويب على المنفذ 8154
الميزات الرئيسية
- دعم متعدد البروتوكولات: توافق كامل مع SFTP (منفذ 2022)، وFTPS، وFTP، وWebDAV، وعميل متصفح حديث
- عزل المستخدمين الافتراضيين: إدارة آلاف المستخدمين داخل قاعدة بيانات دون إنشاء حسابات بنظام السيرفر
- تعدد وحدات التخزين: دعم الأقراص المحلية وحاويات Amazon S3 وGoogle Cloud Storage وAzure Blob
- صلاحيات وحصص دقيقة: تقييد القراءة، والكتابة، والحذف، وسرعة النقل، وإجمالي مساحة القرص لكل مستخدم
- أتمتة الأحداث والـ Webhooks: إطلاق تنبيهات وإشعارات بريدية أو سكريبتات شل عند رفع أو تنزيل الملفات
- أمان وحماية مؤسسية: دعم مفاتيح SSH العامة، وتشفير كلمات المرور بـ Argon2، والمصادقة الثنائية (2FA)
- واجهة برمجية REST API ومؤشرات Prometheus: للتحكم البرمجي الكامل في إضافة وتعديل المستخدمين ومراقبة النقل
- نشر منظم عبر Docker مع ربط مجلد `./config` لقاعدة البيانات والإعدادات ومجلد `./data` لملفات المستخدمين
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8154 للوصول لصفحة إنشاء حساب المشرف الأولى
- أنشئ اسم المستخدم وكلمة المرور لحساب المشرف الأساسي
- انتقل إلى 'Users' ← 'Add user' وأنشئ مستخدم SFTP جديداً بكلمة مرور أو مفتاح SSH عام وحدد مجلده
- اتصل بالسيرفر عبر برامج مثل FileZilla أو WinSCP على المنفذ `2022` ببيانات المستخدم الجديد
- ضع واجهة لوحة الإدارة وعميل الويب خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- افتح المنفذ 2022/tcp في جدار حماية السيرفر (`ufw allow 2022/tcp`) لتمكين اتصالات الـ SFTP
- أعد سكريبت نسخ احتياطي دوري لمجلد الإعدادات `./config` الذي يحتوي على قاعدة بيانات المستخدمين
أفضل ممارسات الأمان
- تنبيه أمني حاسم: غيّر بيانات المشرف الافتراضية وفعل المصادقة الثنائية (2FA) لحسابات الإدارة والمستخدمين
- افرض استخدام مفاتيح SSH العامة لمستخدمي الـ SFTP وعطل تسجيل الدخول بكلمات المرور الضعيفة
- ضع واجهة لوحة الويب خلف وكيل عكسي مشفر بـ HTTPS لتأمين كلمات المرور والملفات المنقولة بالمتصفح
- احمِ منفذ SFTP 2022 واقصره على الشبكات الموثوقة أو فعل جدار الحماية التلقائي المدمج في SFTPGo Defender
- احمِ مجلدي الإعدادات `./config` والبيانات `./data` بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات البروتوكولات
المنافذ وإعدادات جدار الحماية
يستخدم SFTPGo منفذ TCP 8154 للوحة الإدارة وعميل الويب (المحول من 8080 الداخلي) ومنفذ TCP 2022 لخدمة اتصالات SFTP. يجب فتح المنفذ 2022 في جدار الحماية (`ufw allow 2022/tcp`). وفي الإنتاج، وجه حركة الويب عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 وأبقِ المنفذ 8154 مغلقاً في جدار الحماية الخارجي.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./config` احتياطياً، والذي يحتوي على ملف `sftpgo.db` (المستخدمين، والصلاحيات، والمفاتيح)
- انسخ مجلد `./data` الذي يحتوي على كافة ملفات ومجلدات المستخدمين المرفوعة
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على متغيرات البيئة والمنافذ
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من استرجاع حسابات الـ SFTP بنجاح
الأخطاء الشائعة
- محاولة اتصال عملاء SFTP بالمنفذ الافتراضي 22 بدلاً من المنفذ المخصص 2022 (المنفذ 22 مخصص لـ SSH السيرفر الأساسي)
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر لعميل الويب بدون شهادة SSL
- عدم ربط مجلدي التخزين الدائم `./config` و`./data`، مما يسبب فقدان الحسابات والملفات عند تحديث الحاوية
- عدم تحديد حصص تخزين للمستخدمين (Quotas) مما يتيح لمستخدم واحد ملء مساحة القرص الصلب بالكامل بالسيرفر
- ترك بروتوكول FTP غير المشفر مفعلاً في البيئات التي تتطلب تشفيراً صارماً بـ SFTP أو FTPS
استكشاف الأخطاء وإصلاحها
- عميل SFTP يظهر Connection Refused على المنفذ 2022 — تأكد من فتح المنفذ في جدار الحماية (`ufw status`)
- فشل الدخول بـ SFTP وظهور Authentication Failed — راجع صحة مفتاح SSH العام أو كلمة المرور في لوحة المستخدمين
- ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs sftpgo -f`
- تعذر إنشاء حساب المشرف الأول — احذف ملف `sftpgo.db` داخل `./config` إذا تم تشغيل الحاوية سابقاً دون إكمال الإعداد
- المستخدم لا يستطيع رفع الملفات — تأكد من تفعيل صلاحيات الكتابة وإنشاء المجلدات في إعدادات المستخدم
البدائل
خوادم vsftpd وProFTPD الكلاسيكية في لينكس. خدمة OpenSSH الافتراضية. برنامج Filebrowser البسيط لإدارة الملفات عبر الويب. منصة Seafile السحابية للمزامنة مع الحواسيب. خدمة AWS Transfer Family السحابية المدارة.
متى لا تستخدمه
تجنب استخدام SFTPGo إذا كنت تبحث فقط عن برنامج مزامنة ملفات مكتبي على غرار Dropbox لمزامنة المجلدات تلقائياً (حيث صُممت Seafile أو Nextcloud لتزامن الأجهزة المكتبية). وإذا كنت تريد فقط مستعرض ملفات ويب بسيطاً جداً دون الحاجة لبروتوكولات SFTP أو FTPS أو WebDAV، فإن Filebrowser أخف.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
لماذا يستخدم SFTPGo المنفذ 2022 بدلاً من المنفذ القياسي 22؟
المنفذ 22 محجوز بالفعل لخدمة OpenSSH الخاصة بسيرفر Ubuntu لإدارة النظام. ويستخدم SFTPGo المنفذ 2022 لتوفير خادم SFTP معزول تماماً دون التداخل مع وصول المشرف للسيرفر.
هل يحتاج مستخدمو SFTPGo لإنشاء حسابات مستخدمين حقيقية في نظام لينكس؟
لا! يعتمد SFTPGo على حسابات مستخدمين افتراضية مخزنة داخل قاعدة بياناته، مما يتيح لك إنشاء وإدارة وحذف المستخدمين وتحديد صلاحياتهم من لوحة الويب دون لمس نظام السيرفر.
هل يمكن لـ SFTPGo الاتصال بمساحات التخزين السحابية مثل Amazon S3؟
نعم! يدعم SFTPGo استخدام Amazon S3 وGoogle Cloud Storage وAzure Blob كوحدات تخزين خلفية للمستخدمين، مما يتيح لبرامج الـ SFTP الرفع مباشرة إلى الحاويات السحابية.
هل يدعم SFTPGo بروتوكول WebDAV والرفع من المتصفح؟
نعم! بالإضافة إلى SFTP، يحتوي SFTPGo على عميل ويب متكامل على المنفذ 8154 لرفع وإدارة الملفات من المتصفح مباشرة، مع دعم كامل لتوصيل الأقراص ببروتوكول WebDAV.
كم يستهلك SFTPGo من الذاكرة العشوائية (RAM)؟
تم تطوير SFTPGo بلغة Go وهو فائق الكفاءة، حيث يستهلك عادة ما بين 20 إلى 60 ميجابايت فقط من الذاكرة العشوائية داخل Docker.