كانت مشكلة qBittorrent الأصلية مكوّنة من طبقتين. أولًا، يجب أن يحفظ qBittorrent الملفات إلى مسار موجود داخل الحاوية. ثانيًا، يجب أن تمتلك عملية qBittorrent صلاحية الكتابة إلى مجلد المضيف الموجود خلف مسار الحاوية هذا. كان المستخدم قد حل طبقة الربط بالفعل—فالمجلد كان ظاهرًا—لكن سجل التنفيذ ظل يعرض تم رفض الإذن.
أنشأ الإصلاح المجتمعي مجلد تنزيل مخصصًا واستخدم صلاحية واسعة جدًا chmod -R 777 كاختبار سريع للصلاحيات. وأكد صاحب المنشور الأصلي أن التنزيلات عملت بعد ذلك. وتثبت هذه النتيجة أن سبب العطل كان مشكلة في صلاحية الكتابة، لكن 777 لا ينبغي أن تكون هذه التوصية الدائمة على نظام حالي.
مسار المضيف ومسار qBittorrent اسمان مختلفان لنفس مساحة التخزين
/Movies-TV.استخدم المصدر:
-
المضيف:
/media/Main Storage/Media/Movies -
الحاوية:
/Movies-TV
داخل qBittorrent، يجب أن يستخدم مسار الحفظ /Movies-TV/...، وليس المسار الخام على المضيف.
أثبتت إمكانية الوصول أن الربط يعمل؛ وأثبت رفض الإذن أن عمليات الكتابة لم تنجح
وأظهر سجل تنفيذ qBittorrent لدى المستخدم تم رفض الإذنوهذا يختلف عن الملف أو الدليل غير موجود:
- الملف أو الدليل غير موجود: من المحتمل أن يكون الربط أو المسار غير صحيح.
- تم رفض الإذن: يمكن للحاوية الوصول إلى المسار، لكنها لا تستطيع الكتابة إليه.
يُسهّل مجلد تنزيل مخصص ضبط الصلاحيات بشكل صحيح
أنشأ المجتمع مجلدًا فرعيًا مثل:
/media/Main Storage/Media/Movies/qbittorrent-downloadsوضبط وجهة التنزيل داخل حاوية qBittorrent على:
/Movies-TV/qbittorrent-downloadsوهذا أفضل من منح أداة التنزيل صلاحية الكتابة إلى شجرة وسائط كاملة إذا كانت تحتاج إلى دليل تجهيز واحد فقط.
كان chmod 777 اختصارًا تشخيصيًا، وليس نموذج صلاحيات نهائيًا جيدًا
استخدم ردّ المجتمع الأمر بشكل تكراري chmod 777 وأكد صاحب المنشور الأصلي أن ذلك حل المشكلة. وهذا يثبت وجود علاقة سببية، لكن صلاحيات الكتابة للجميع تتيح لكل هوية عملية محلية الكتابة إلى الدليل.
الحل الدائم الأكثر أمانًا هو تحديد معرّف المستخدم/المجموعة (UID/GID) الذي تعمل به حاوية qBittorrent ومنح هذا المستخدم/المجموعة وحده صلاحية الكتابة المطلوبة.
تحقق من الملكية قبل تغييرها
تشمل الفحوصات المفيدة للقراءة فقط فحص مالك/مجموعة المجلد ووضعه قبل تعديل أي شيء. إذا كان qBittorrent يعمل باستخدام PUID/PGID قابلين للتهيئة، فطابق هذه القيم مع مجموعة مضيفة لديها إذن الكتابة في مجلد التنزيلات.
تجنب تغيير الملكية بشكل تكراري عبر مكتبة وسائط مشتركة بأكملها عندما يحتاج مجلد واحد فقط إلى إمكانية الكتابة.
يُظهر ZimaOS حاليًا مسارات وحدات التخزين الخاصة بالتطبيقات بوضوح
توضح وثائق IceWhale الحالية أن تطبيقات متجر التطبيقات تعمل داخل حاويات، وأن مجلداتها المهمة تُعيَّن إلى وحدة تخزين المضيف الفعلية. ويمكن عرض هذه التعيينات وتحريرها من إعدادات التطبيق.
استخدم نموذج مسارات Docker الحالي في ZimaOS قبل تعديل الأذونات.
افصل مجلد تجهيز التنزيلات عن مكتبة الوسائط النهائية
من البنى الشائعة:
- يكتب qBittorrent إلى مجلد تنزيلات مخصص؛
- يستورد Sonarr/Radarr أو أي منظّم آخر الملفات المكتملة؛
- يقرأ Jellyfin/Plex مكتبة الوسائط النهائية، وغالبًا ما يكون ذلك للقراءة فقط.
يمنح ذلك كل تطبيق الوصول الذي يحتاج إليه فقط.
اختبر أولًا بتنزيل واحد صغير
بعد تغيير التعيين أو الإذن:
- أعد تشغيل qBittorrent؛
- تأكد من أن مسار الحفظ يُحل داخل الحاوية؛
- نزّل ملف اختبار صغيرًا وقانونيًا؛
- تحقق من سجل التنفيذ؛
- تحقق من ظهور الملف في وحدة التخزين المضيفة المقصودة.
الأسئلة الشائعة حول مسار تنزيلات qBittorrent
هل كان تعيين وحدة التخزين المصدر نفسه خاطئًا؟
خلص المجتمع إلى أن المسار كان ظاهرًا وصحيحًا؛ وكان الخطأ المتبقي متعلقًا بإذن الكتابة.
هل جعل chmod 777 الحالة المصدرية تعمل؟
نعم، وأكد صاحب المنشور الأصلي نجاح ذلك. وينبغي التعامل معه كاختصار تشخيصي واسع النطاق، لا كإذن دائم مفضل.
ما المسار الذي ينبغي أن يستخدمه qBittorrent داخليًا؟
مسار جانب الحاوية المحدد في تعيين وحدة التخزين في ZimaOS، مثل /Movies-TV/qbittorrent-downloads.
