حلّ المجتمع

عيّن مجلد التنزيل الصحيح لـ qBittorrent على ZimaOS

A ZimaOS user mapped qBittorrent downloads to a second drive but kept entering the ZimaOS host path inside qBittorrent. The confirmed fix was to use the Docker container path /downloads instead.

إذا استمر qBittorrent في حفظ التنزيلات على محرك نظام ZimaOS حتى بعد اختيار قرص صلب آخر في إعدادات التطبيق، فتحقق من المسار الذي أدخلته داخل qBittorrent نفسه. في موضوع مجتمع IceWhale المنشور في نوفمبر 2025، كان محرك الأقراص الثانوي قد أُضيف بالفعل إلى حاوية qBittorrent، لكن المستخدم أدخل مسار مضيف ZimaOS بدلًا من مسار حاوية Docker.

كان الحل المؤكد بسيطًا: استخدم /downloads داخل qBittorrent، وليس مسار مضيف ZimaOS مثل /media/GERAL/downloads. لم يؤدِّ تغيير PUID/PGID إلى 0/0 لم يحل المشكلة الأصلية؛ أما تصحيح المسار فحلّها، وقد أكد صاحب المنشور الأصلي أن التنزيلات عملت بعد ذلك.

الفرق الأساسي: مسار المضيف مقابل مسار الحاوية

يتكون تعيين وحدة تخزين Docker من جانبين:

HOST_PATH:CONTAINER_PATH

على سبيل المثال:

/media/GERAL/downloads:/downloads

يرى ZimaOS الجانب الأيسر. ويعمل qBittorrent داخل الحاوية، لذا ينبغي له عادةً استخدام الجانب الأيمن.

الصحيح داخل qBittorrent: /downloads
الخاطئ داخل qBittorrent:   /media/GERAL/downloads

ما الذي كان المستخدم الأصلي قد أعدّه

إعدادات qBittorrent في ZimaOS التي توضح تعيين التنزيلات إلى محرك GERAL الثانوي
يوضح المنشور الأصلي أن qBittorrent كان مُهيأً لاستخدام التخزين على محرك GERAL الثانوي.
إعدادات تنزيل qBittorrent التي تستخدم مسار مضيف ZimaOS بدلًا من مسار Docker
كان إعداد qBittorrent يستخدم مسارًا من جهة المضيف بدلًا من مسار الحاوية المُحمَّل.
مسار تخزين ZimaOS لمحرك GERAL المستخدم بواسطة حاوية qBittorrent
يكشف ZimaOS مسار المضيف الفعلي، لكن qBittorrent لا يحتاج إلى استخدام سلسلة المسار نفسها داخليًا.
حقل مجلد تنزيلات qBittorrent من موضوع استكشاف أخطاء ZimaOS وإصلاحها
كان الحل المؤكد هو استخدام مسار الحاوية المُحمَّل /downloads.

لماذا لم يؤدِّ تغيير PUID وPGID إلى حل هذه الحالة

اقترحت إحدى ردود المجتمع أولًا اختبار إعدادات مختلفة PUID/PGID القيم، بما في ذلك 0/0جرّب المؤلف الأصلي ذلك وأفاد بأنه لم ينجح.

هذا مهم لأنه يميّز هذه الحالة عن مشكلة أذونات. امتيازات الجذر لا تجعل مسار مضيف غير مُعيّن يصبح مسار الحاوية الصحيح.

يستخدم qBittorrent الحالي من LinuxServer النمط نفسه

تستخدم وثائق Docker الحالية الخاصة بـ qBittorrent من LinuxServer ما يلي:

/path/to/downloads:/downloads

ويعرّف /downloads باعتباره موقع التنزيل داخل الحاوية. وهذا يطابق إصلاح المجتمع تمامًا.

وثائق Docker الخاصة بـ qBittorrent من LinuxServer

كيفية إصلاح مجلد التنزيلات

  1. افتح إعدادات تطبيق qBittorrent في ZimaOS.
  2. اعثر على تعيين وحدة التخزين الخاصة بالتنزيلات.
  3. تأكد من وجود مجلد محرك الأقراص الثانوي المطلوب على جانب المضيف في ZimaOS.
  4. تأكد من أن جانب الحاوية يستخدم مسارًا ثابتًا مثل /downloads.
  5. احفظ الإعدادات وأعد تشغيل التطبيق إذا تغيّر تعيين Docker.
  6. افتح واجهة qBittorrent على الويب.
  7. انتقل إلى الأدوات ← الخيارات ← التنزيلات.
  8. اضبط مسار الحفظ الافتراضي على /downloads أو مجلدًا فرعيًا مثل /downloads/complete.
  9. ابدأ تنزيل تورنت تجريبي صغيرًا وتحقّق من محرك الأقراص الفعلي الذي تُحفظ فيه البيانات.

متى تكون أذونات PUID/PGID مهمة

إذا /downloads صحيح، لكن سجلات qBittorrent تُظهر تم رفض الإذن، ثم تحقّق من الملكية والأذونات. تدعم صورة LinuxServer PUID و PGID تحديدًا لأذونات الربط المباشر لمسار المضيف.

هذا فشل مختلف عن موضوع المصدر. شخّص صحة المسار أولًا، ثم الأذونات.

الأسئلة الشائعة حول مجلد تنزيلات qBittorrent في ZimaOS

لماذا لا يزال qBittorrent يستخدم محرك النظام في ZimaOS؟

في الحالة المصدرية، تم إعداد qBittorrent باستخدام مسار المضيف بدلًا من مسار الحاوية المُركّب.

ما المسار الذي أصلح المشكلة في الموضوع الأصلي؟

/downloadsأكد المؤلف أنه نجح.

هل ينبغي أن أضبط PUID وPGID على 0؟

ليس لهذه المشكلة. لقد جرّب المؤلف الأصلي ذلك دون نجاح. استخدم مسار الحاوية الصحيح أولًا.