🎮 تثبيت RomM — مدير مكتبات ألعاب الـ Retro ومحاكي الألعاب في المتصفح على Docker
نشر منصة RomM على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لإدارة مكتبات ألعاب الفيديو الكلاسيكية (ROMs) وجلب الأغلفة تلقائياً من IGDB ولعب الألعاب مباشرة داخل المتصفح عبر EmulatorJS.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/romm/romm-ubuntu.sh
chmod +x romm-ubuntu.sh
sudo bash romm-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/romm/romm-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x romm-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين للألعاب والأصول وقاعدة البيانات (`./library` و`./assets` و`./config` و`./resources` و`./db`) وتشغيل حاويتي RomM وMariaDB على المنفذ 8186 (المحول من 8080 الداخلي).
sudo bash romm-ubuntu.sh
4 فحص الألعاب واللعب في المتصفح
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8186. أنشئ حساب المشرف الأول، وافحص مجلدات الألعاب لجلب الملصقات والمعلومات، والعب ألعابك الكلاسيكية المفضلة في المتصفح فوراً.
http://<your-server-ip>:8186
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8186 | Web UI (host → container 8080) — admin created on first visit |
| internal | MariaDB 10.11 (romm-db, not published) |
| ./library | Your ROMs (also ./db, ./assets, ./config, ./resources) |
نظرة عامة
تعد RomM (ROM Manager) منصة ويب مذهلة وعصرية مفتوحة المصدر لإدارة وأرشفة وتشغيل مكتبات ألعاب الفيديو الكلاسيكية (Retro Games) لهواة الألعاب والمحاكيات. تعمل المنصة على المنفذ 8186 (المحول من 8080 الداخلي) وتعتمد على قاعدة بيانات MariaDB، وتقوم بفحص مكتبات الألعاب لعشرات المنصات العريقة (مثل NES وSNES وGenesis وGBA وN64 وPS1 وPS2 وGameCube وSwitch). وتجلب تلقائياً الأغلفة ثلاثية الأبعاد ولقطات الشاشة وتواريخ الإصدار من قواعد بيانات IGDB وScreenScraper، مع دعم مزامنة ملفات الحفظ السحابي، وتشغيل الألعاب الكلاسيكية مباشرة داخل المتصفح عبر محاكي EmulatorJS المدمج.
لماذا تستخدمه
يؤدي تخزين آلاف ملفات الألعاب في مجلدات عشوائية على الحواسيب أو وحدات الفلاش إلى فوضى عارمة وغياب الأغلفة وفقدان ملفات تقدم الحفظ (Save States) بين الأجهزة المختلفة. تعمل منصة RomM بمثابة 'Jellyfin أو Plex لألعاب الفيديو القديمة': حيث تنظم ألعابك في معرض بصري ساحر، وتدمج أسطوانات الألعاب المتعددة، وتزامن الحفظ مع محاكيات سطح المكتب والأجهزة المحمولة، وتتيح لك تشغيل أي لعبة فورياً من أي متصفح ويب.
متى تحتاجه
- تمتلك مكتبة من ألعاب الفيديو الكلاسيكية (ROMs) وتريد معرض ويب فائق الأناقة يعرض الأغلفة والمعلومات وتفاصيل الألعاب
- تريد لعب ألعابك الكلاسيكية المفضلة مباشرة داخل متصفح الإنترنت باستخدام أذرع التحكم دون الحاجة لتثبيت محاكيات محلية
- تبحث عن بديل مجاني ومفتوح المصدر لـ RetroPie أو LaunchBox يمكن الوصول إليه عبر المتصفح من أي جهاز
- تريد جلب ملصقات الألعاب والتقييمات وتاريخ الإصدار تلقائياً من IGDB (Twitch API) أو ScreenScraper
- تريد إدارة ومزامنة ملفات الحفظ (Save Games وSave States) مركزياً بين كافة أجهزتك المحمولة ومحاكي RetroArch
من يحتاجه
- عشاق ألعاب الزمن الجميل (Retro Gamers) وهواة أرشفة وتوثيق مكتبات الألعاب الكلاسيكية
- أصحاب السيرفرات المنزلية لتوفير منصة ألعاب سحابية عائلية متاحة على الشاشات الذكية والأجهزة اللوحية والحواسيب
- مستخدمو أجهزة المحاكاة المحمولة (Steam Deck وMiyoo Mini وAnbernic) لمزامنة الألعاب والحفظ
- اللاعبون الذين يرغبون في تجربة ألعاب الطفولة بسرعة في المتصفح أثناء فترات الاستراحة دون أي تعقيدات
- جامعو الألعاب لتصنيف الألعاب المعربة والمعدلة (ROM Hacks) وتوحيد أسطوانات الألعاب
حالات الاستخدام الشائعة
- استعراض مكتبة تضم أكثر من 500 لعبة لأجهزة SNES وGBA وPS1 بأغلفة ثلاثية الأبعاد ونصوص تعريفية كاملة
- توصيل ذراع تحكم لاسلكي (PlayStation أو Xbox) باللابتوب ولعب Super Mario 64 مباشرة في المتصفح
- مزامنة ملفات حفظ الألعاب بين سيرفر RomM المنزلي وجهاز Steam Deck المحمول تلقائياً
- التحقق من صحة نسخ الألعاب ومطابقة بصماتها الرقمية مع قواعد بيانات No-Intro وRedump
- مشاركة بوابة ألعاب كلاسيكية متعددة المستخدمين مع الأصدقاء والعائلة على شبكتك المنزلية
الميزات الرئيسية
- واجهة مستخدم ويب فائقة العصرية مع دعم الوضع الداكن والتأثيرات الحركية السلسة وعروض الفيديو الترويجية
- محاكي ألعاب مدمج بالمتصفح: تشغيل الألعاب الكلاسيكية مباشرة عبر تقنيات WebAssembly وEmulatorJS
- جلب بيانات تلقائي شامل: تنزيل الأغلفة، والتقييمات، وتفاصيل المطورين، وسنة الإصدار من IGDB وScreenScraper
- دعم أكثر من 50 منصة ألعاب تشمل منصات Nintendo وSega وSony PlayStation وأجهزة الصالات (Arcade)
- إدارة ملفات الحفظ (Save States): رفع وتنزيل ومزامنة تقدم الألعاب بين جلسات اللعب المختلفة
- دمج الألعاب متعددة الأسطوانات والملفات (`.cue`/`.bin` و`.iso`) تلقائياً في بطاقة لعبة واحدة
- دعم أصلي لأذرع التحكم (Gamepads): التعرف التلقائي على أذرع التحكم وتخصيص الأزرار عبر المتصفح
- معمارية Docker Compose تجمع RomM مع قاعدة بيانات MariaDB 10.11 ومجلدات الحفظ الدائم للألعاب والأصول
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8186 للوصول إلى واجهة RomM الرئيسية
- أنشئ حساب المشرف الأول وكلمة المرور عند الزيارة الأولى
- انتقل إلى Settings ← Metadata Providers وأدخل بيانات حساب IGDB (معرف وعميل Twitch) أو ScreenScraper
- ارفع ملفات الألعاب في المجلدات المخصصة لكل جهاز على السيرفر (مثل `./library/roms/snes/` أو `./library/roms/gba/`)
- انتقل لتبويب Library واضغط على 'Scan Library' لفحص الألعاب وتنزيل الملصقات والبيانات آلياً
- اضغط على أي بطاقة لعبة واختر 'Play' لاختبار تشغيل المحاكي في المتصفح بالماوس أو ذراع التحكم
- ضع RomM خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) للوصول الآمن من أي جهاز
أفضل ممارسات الأمان
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي في الإنتاج — حيث تتطلب المتصفحات اتصالاً آمناً لأذرع التحكم وواجهات WebGL
- أبقِ منفذ قاعدة البيانات MariaDB 3306 معزولاً داخل شبكة Docker ولا تكشفه للإنترنت العام
- عيّن كلمات مرور معقدة لقاعدة البيانات في ملف `docker-compose.yml` (`DB_PASS` و`MYSQL_ROOT_PASSWORD`)
- عيّن شفرة عشوائية قوية لمتغير `ROMM_AUTH_SECRET_KEY` في متغيرات البيئة لتشفير الجلسات
- احمِ مجلدات الألعاب `./library` وقاعدة البيانات `./db` بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وتطويرات المحاكيات المدمجة
المنافذ وإعدادات جدار الحماية
يقدم تطبيق RomM واجهته ومحاكي الألعاب عبر منفذ TCP 8186 (المحول من 8080 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8186، مع إبقاء المنفذ 8186 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 للزوار.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./library` احتياطياً، والذي يحتوي على كافة ملفات وأرشيفات ألعاب الفيديو الكلاسيكية المنظمة
- انسخ مجلد `./assets` الذي يحتوي على الملصقات ولقطات الشاشة وملفات حفظ الألعاب المنزلة
- انسخ مجلد `./db` الذي يحتوي على قاعدة بيانات MariaDB الكاملة بكافة بيانات الألعاب والمستخدمين والوسوم
- استخرج نسخة احتياطية دورية لقاعدة البيانات عبر mysqldump: `docker exec romm-db mysqldump -u romm -p<password> romm > romm_backup.sql`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
الأخطاء الشائعة
- وضع ملفات الألعاب في المجلد الرئيسي مباشرة دون وضعها داخل مجلدات الأجهزة المخصصة (مثل `/roms/snes` و`/roms/gba`)
- التشغيل بدون مفاتيح IGDB API مما يحرم المنصة من جلب الملصقات والمعلومات تلقائياً ويتطلب إدخالها يدوياً
- عدم ربط مجلدي التخزين الدائم `./library` و`./assets`، مما يسبب فقدان الملصقات والألعاب عند تحديث الحاوية
- توقع تشغيل ألعاب الأجهزة الحديثة المعقدة ثلاثية الأبعاد (مثل PS3 أو PS4) داخل المتصفح (حيث يقتصر محاكي الويب على ألعاب 8-bit إلى 32-bit)
- كشف منفذ قاعدة البيانات MariaDB 3306 للإنترنت العام مباشرة
استكشاف الأخطاء وإصلاحها
- فحص المكتبة لا يعثر على أي ألعاب — تأكد من وضع ملفات الألعاب في مجلدات بأسماء الأجهزة الصحيحة (مثل `snes` و`gba` و`psx` و`n64`)
- فشل جلب الملصقات والبيانات — تأكد من صحة بيانات IGDB Twitch Client ID وSecret في Settings ← Metadata Providers
- المحاكي يظهر شاشة سوداء في المتصفح — تأكد من دعم EmulatorJS لصيغة ملف اللعبة (مثل فك ضغط ملفات `.sfc` أو `.gba`)
- ظهور خطأ HTTP 500 في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs romm -f`
- خطأ الاتصال بقاعدة البيانات عند بدء التشغيل — تأكد من عمل حاوية MariaDB وصحة كلمة المرور في `DB_PASS`
البدائل
نظام RetroPie لأجهزة رازباري باي. تطبيق LaunchBox المكتبي التجاري لإدارة الألعاب. نظام Batocera المستقل للألعاب. محرك RetroArch الشامل للمحاكاة. مكتبة EmulatorJS المدمجة في المتصفحات.
متى لا تستخدمه
تجنب استخدام RomM إذا كنت تلعب حصرياً ألعاب المحاكيات الحديثة الضخمة ثلاثية الأبعاد (مثل محاكي RPCS3 للـ PS3 أو Yuzu للـ Switch) التي تتطلب كروت شاشة حاسوبية قوية ومحاكيات سطح مكتب أصلية. وإذا كنت تريد تجربة ألعاب مخصصة للشاشات المنزلية مع الاتصال المباشر بمنفذ HDMI وأذرع التحكم على جهاز رازباري باي، فإن Batocera أو RetroPie أكثر ملاءمة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل يمكنني تشغيل ولعب الألعاب مباشرة داخل متصفح الإنترنت دون تثبيت برامج؟
نعم! يدمج تطبيق RomM محاكي EmulatorJS، مما يتيح لك تشغيل ألعاب الأجهزة الكلاسيكية (NES وSNES وGame Boy وGenesis وGBA وPS1) مباشرة داخل المتصفح باستخدام الكيبورد أو أذرع التحكم USB.
كيف يجب تنظيم مجلدات الألعاب (ROMs) على السيرفر؟
ضع ملفات الألعاب داخل مجلدات فرعية بأسماء الأجهزة داخل المسار `./library/roms/` بالسيرفر (مثل `./library/roms/nes/` و`./library/roms/snes/` و`./library/roms/gba/` و`./library/roms/n64/` و`./library/roms/psx/`).
كيف يجلب RomM أغلفة وملصقات الألعاب وتفاصيلها؟
يتصل RomM بالواجهة البرمجية المجانية لمنصة IGDB (عبر حساب Twitch المطورين) ومنصة ScreenScraper لتنزيل الأغلفة الرسمية ثلاثية الأبعاد، والملصقات، ونبذة عن القصة، وسنة الإصدار آلياً.
هل يدعم RomM أذرع التحكم وأيدي الألعاب (Gamepads)؟
نعم! تدعم المتصفحات الحديثة واجهة Gamepad API. بمجرد توصيل ذراع تحكم Xbox أو PlayStation أو أذرع USB العادية يتعرف عليها المحاكي فوراً ويتيح تخصيص الأزرار بسلاسة.
كم يستهلك RomM من الذاكرة العشوائية (RAM)؟
يستهلك تطبيق RomM مع قاعدة بيانات MariaDB حوالي 200 إلى 350 ميجابايت فقط من الذاكرة العشوائية داخل Docker مجتمعة.