المجلدات (الأقراص)

تعرف على كيفية تعيين (Map) المجلدات من نظام التشغيل الخاص بك إلى خادم RoqueOS، مما يجعلها تظهر كأقراص حقيقية في مدير ملفات سطح مكتب الويب.

---

كيف تعمل؟

يعمل خادم RoqueOS داخل حاوية Docker معزولة. ولأسباب أمنية، لا يتمتع بوصول تلقائي إلى الملفات الموجودة على الكمبيوتر أو الخادم المضيف الخاص بك.

لكي يتمكن مدير الملفات من عرض وتحرير وتنظيم مجلدات التنزيلات أو المستندات أو الوسائط الخاصة بك، تحتاج إلى "تركيب" (Mount) هذه المجلدات في Docker — تمامًا مثل توصيل محرك أقراص USB.

---

كيفية التكوين

قم بتعديل ملف docker-compose.yml بإضافة أسطر في قسم volumes:.

الصيغة:

المسار-على-كمبيوترك : /app/disks/اسم_القرص

قاعدة هامة

يجب أن يبدأ المسار الموجود على اليمين (داخل RoqueOS) دائمًا بـ /app/disks/ حتى يتمكن مدير الملفات من اكتشاف المجلد وعرضه كقرص.

أمثلة عملية

📁 المستندات

# Linux/macOS
volumes:
  - /home/user/Documents:/app/disks/Documents

# Windows
volumes:
  - C:\Users\user\Documents:/app/disks/Documents

🎬 الوسائط / الأفلام

# Linux/macOS
volumes:
  - /mnt/external-hd/PlexMedia:/app/disks/Media

# Windows
volumes:
  - D:\PlexMedia:/app/disks/Media

⬇️ التنزيلات

# Linux/macOS
volumes:
  - /home/user/Downloads:/app/disks/Downloads

# Windows
volumes:
  - C:\Users\user\Downloads:/app/disks/Downloads

---

مثال كامل لملف docker-compose.yml

version: '3.8'

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    container_name: roqueos-server
    restart: unless-stopped
    ports:
      - '27021:27021'
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      # الأقراص المخصصة الخاصة بك:
      - /mnt/external-hd/Movies:/app/disks/Movies
      - /home/user/Downloads:/app/disks/Downloads
      - /home/user/Projects:/app/disks/Projects
    environment:
      - TZ=Asia/Riyadh

---

بعد التكوين

إعادة تشغيل الخادم

في كل مرة تقوم فيها بتغيير docker-compose.yml لإضافة أو إزالة مجلد، تحتاج إلى إعادة إنشاء الحاوية:

docker compose down && docker compose up -d

التحقق من الأقراص في الواجهة الأمامية

بمجرد إعادة تشغيل الخادم، افتح مدير الملفات في RoqueOS. سترى محركات أقراص افتراضية جديدة تظهر في اللوحة اليسرى، بالاسم الدقيق الذي اخترته في /app/disks/NAME.

---

المشاكل الشائعة

خطأ "تم رفض الوصول" (Access Denied) عند تعديل الملفات

إذا تلقيت خطأ في الأذونات عند محاولة إنشاء أو حذف ملفات داخل قرص معين (Mapped disk)، فإن حاوية Docker ليس لديها إذن بالكتابة إلى المجلد المحلي. في الوحدة الطرفية (Terminal) للخادم المضيف:

# إذن القراءة والكتابة للمالك
chmod -R 755 /path/to/your/local/folder

# إذا كنت بحاجة إلى وصول كامل (كن حذراً)
chmod -R 777 /path/to/your/local/folder

القرص لا يظهر في مدير الملفات

تحقق مما يلي:

1. هل المسار داخل الحاوية يبدأ بـ /app/disks/
2. هل تمت إعادة تشغيل الحاوية بعد تغيير ملف compose
3. هل المسار المضيف (Host path) موجود ولديه أذونات القراءة