البدء
- افتح
http://<SERVER-IP>في متصفحك. - قد يستغرق التشغيل الأول بعض الوقت.
- عند أول زيارة، سيحوّلك RomM إلى معالج الإعداد.
- أكمل معالج الإعداد.
- أنشئ اسم المستخدم وكلمة المرور للمسؤول.
- يصبح أول حساب يتم إنشاؤه هو حساب المسؤول.
مكتبة ROM
- ضع ملفات ROM الخاصة بك في:
/root/romm/library/roms - ضع ملفات BIOS في:
/root/romm/library/bios - بعد إضافة الألعاب، شغّل فحص المكتبة من واجهة الويب في RomM.
البيانات الوصفية
- Hasheous metadata support lets RomM retrieve game metadata without requiring an API key.
- يمكن إعداد مزوّدي بيانات وصفية إضافيين في:
/root/romm/.env
الملفات والمجلدات المهمة
- مسار التثبيت:
/root/romm - ملف Compose:
/root/romm/docker-compose.yml - ملف البيئة:
/root/romm/.env - مكتبة ROM:
/root/romm/library - ملفات ROM:
/root/romm/library/roms - BIOS:
/root/romm/library/bios - الأصول:
/root/romm/assets - الإعدادات:
/root/romm/config - إعدادات Caddy:
/etc/caddy/Caddyfile - بيانات MariaDB:
/var/lib/docker/volumes/romm_mysql_data
إدارة Docker
اعرض الحالة:
docker ps
عرض السجلات:
cd /root/romm
docker compose logs -f
إعادة تشغيل الخدمات:
cd /root/romm
docker compose restart
أوقف الخدمات:
cd /root/romm
docker compose down
ابدأ الخدمات:
cd /root/romm
docker compose up -d
النطاق وHTTPS (Caddy)
ملاحظة: لا يمكن إصدار شهادات TLS من Let's Encrypt لعناوين IP. يلزم اسم نطاق.
1. وجّه نطاقًا (مثل example.com) إلى عنوان IP الخاص بخادمك.
٢. تحرير /root/romm/.env وحدّث ROMM_BASE_URL:
BASE_URL=https://example.com
3. أعد إنشاء الخدمات:
docker compose -f /root/romm/docker-compose.yml up -d
4. Update the site address in /etc/caddy/Caddyfile من http://<SERVER_IP> بنطاقك. أبقِ إعدادات الضغط والترويسات والوكيل العكسي كما هي.
vim /etc/caddy/Caddyfile
غيّر:
http://<SERVER_IP> {
لكي:
example.com {
5. أعد تحميل Caddy:
systemctl reload caddy
6. سيحصل Caddy تلقائيًا على شهادة Let's Encrypt ويجدّدها.
7. ادخل إلى RomM عبر: https://example.com
