إذا كان qBittorrent يستطيع رؤية مجلد في ZimaOS، لكن كل مهمة تورنت تفشل فورًا، فلن يكفي تغيير مسار التنزيل داخل qBittorrent وحده. يجب أولًا تركيب مجلد المضيف داخل حاوية Docker، كما يجب أن يمتلك المستخدم الذي يشغّل qBittorrent داخل تلك الحاوية صلاحية الكتابة إلى دليل المضيف المركّب.
هذا ما حدث في نقاش مجتمع IceWhale في يناير 2026. عيّن صاحب المنشور الأصلي مجلد وسائط إلى /Movies-TV، لكن سجل تنفيذ qBittorrent أظهر الخطأ Permission denied. وقد حلّ إنشاء مجلد فرعي مخصص، إلى جانب منح المضيف صلاحيات قابلة للكتابة، المشكلة في الحالة الأصلية. استخدم المجتمع الأمر chmod -R 777 كحل سريع، لكن إرشادات LinuxServer الحالية تفضّل مطابقة PUID/PGID مع ملكية المضيف بدل ترك الدليل متاحًا للكتابة من الجميع.
مسار المضيف مقابل مسار الحاوية
لا يصبح مسار ZimaOS مرئيًا تلقائيًا داخل qBittorrent. يكون التعيين المعتاد كما يلي:
Host: /DATA/Downloads
Container: /downloadsبعد ذلك، يجب أن يحفظ qBittorrent الملفات في مسار داخل الحاوية، مثل /downloads/qbittorrent.
التعيين الأصلي
Host: /media/Main Storage/Media/Movies
Container: /Movies-TV
إنشاء مجلد تنزيل مخصص
أنشأ الترتيب الذي نجح في نقاش المجتمع:
/media/Main Storage/Media/Movies/qbittorrent-downloadsواستخدم هذا المسار داخل qBittorrent:
/Movies-TV/qbittorrent-downloadsفحص الصلاحيات
ls -ld "/media/Main Storage/Media/Movies"
ls -ld "/media/Main Storage/Media/Movies/qbittorrent-downloads"إذا كان الدليل موجودًا، لكن السجل يعرض Permission denied، فهذا يعني أن هوية الحاوية لا تملك صلاحية الكتابة.
الحل السريع الذي أكده المجتمع
chmod -R 777 "/media/Main Storage/Media/Movies/qbittorrent-downloads"أكد صاحب المنشور الأصلي أن هذا الحل نجح. ومع ذلك، يمنح 777 صلاحيات القراءة والكتابة والتنفيذ على نطاق واسع، لذا يُفضّل استخدامه للتشخيص أو كحل مؤقت، وليس كنموذج الصلاحيات الدائم المثالي.
الحل طويل الأمد المفضّل: مطابقة PUID وPGID
تدعم صورة qBittorrent الحالية من LinuxServer المتغيرين PUID وPGID تحديدًا لتجنب تعارضات صلاحيات الربط. وتوصي وثائقها بجعل ملكية دليل المضيف متوافقة مع المعرّفات المقدمة إلى الحاوية.
وثائق qBittorrent من LinuxServer
PUID=1000
PGID=1000هذه القيم أمثلة فقط. تحقّق من حساب المضيف المقصود باستخدام id USERNAME، واستخدم المعرّفات الفعلية أو مجموعة مشتركة متوافقة.
إعادة التشغيل والاختبار
- احفظ تعيين وحدة التخزين.
- أعد تشغيل qBittorrent أو أنشئه من جديد.
- عيّن مسار الحفظ الافتراضي إلى مسار الحاوية المركّب.
- ابدأ تنزيلًا تجريبيًا صغيرًا.
- اقرأ Tools → Execution Log إذا استمر الفشل.
ما الذي تعنيه الأخطاء؟
- Permission denied: المسار موجود، لكنه غير قابل للكتابة.
- No such file or directory: مسار الحاوية مفقود أو معيّن بطريقة غير صحيحة.
الأسئلة الشائعة حول مسار تنزيل qBittorrent
هل ينبغي أن يستخدم qBittorrent مسار مضيف ZimaOS؟
لا. ينبغي عادةً أن يستخدم مسار جانب الحاوية المحدد في تعيين وحدة التخزين.
هل حل chmod 777 المشكلة في النقاش الأصلي؟
نعم. أكد صاحب المنشور أنه نجح، لكن استخدام PUID/PGID أو صلاحيات مجموعة أضيق أكثر أمانًا على المدى الطويل.
لماذا يستطيع qBittorrent رؤية مجلد لكنه لا يستطيع الكتابة إليه؟
تختلف إمكانية رؤية نقطة تركيب Docker عن صلاحية الكتابة في نظام الملفات. فقد يكون المجلد المعيّن قابلًا للقراءة، لكنه غير قابل للكتابة من جانب مستخدم الحاوية.
