أذونات مجلدات Docker: الإصلاح في 3 أوامر

الآلية: لماذا يرفض Docker الكتابة

التطبيقات الأكثر تأثراً ومعرّفات المستخدم الخاصة بها

• ‏Paperless-ngx‏ — ‏UID 1000‏ (المستخدم ‏paperless‏): يدير مجلدات ‏consume‏ و‏export‏ و‏media‏ و‏data
• ‏Grafana‏ — ‏UID 472‏ (المستخدم ‏grafana‏): يكتب قاعدة بيانات ‏SQLite‏ والإضافات في ‏/var/lib/grafana
• ‏Nextcloud‏ (صورة ‏Debian‏) — ‏UID 33‏ (المستخدم ‏www-data‏): مجلد البيانات والإعدادات والسجلات
• ‏Immich‏ — ‏UID 1000‏ (المستخدم ‏node‏): مكتبة الصور والصور المصغّرة وقاعدة بيانات الذكاء الاصطناعي
• ‏Gitea‏ — ‏UID 1000‏ (المستخدم ‏git‏): المستودعات ومفاتيح ‏SSH‏ والسجلات وقاعدة بيانات ‏SQLite‏ الافتراضية

التشخيص: تحديد المشكلة في أقل من دقيقتين

1. 01

   قراءة رسالة الخطأ الدقيقة

   راجع سجلات الحاوية المُشكِلة:

   docker logs <اسم-الحاوية> 2>&1 | grep -i 'permission\|denied\|cannot\|mkdir'

   رسالة ‏permission denied‏ أو ‏cannot create directory‏ تؤكد التشخيص.

2. 02

   تحديد UID العملية داخل الحاوية

   docker exec <اسم-الحاوية> id

   مثال على الناتج: ‏uid=472(grafana) gid=0(root)‏. لاحظ ‏UID‏ — هنا ‏472‏.

3. 03

   التحقق من مالك مجلد المضيف

   ls -ln /opt/grafana/data

   ناتج ‏drwxr-xr-x 2 0 0 ...‏ يعني أن المجلد يملكه ‏root (UID 0)‏. ‏UID 472‏ لديه فقط صلاحيات «other» — القراءة والتنفيذ، لا الكتابة.

4. 04

   استخدام stat للتشخيص الكامل

   stat /opt/grafana/data

   تحقق من سطري ‏Uid:‏ و‏Gid:‏. إذا أظهرا ‏(0/root)‏ بينما تعمل الحاوية بـ‏472‏، تأكدت المشكلة.

5. 05

   فحص إعدادات الحاوية

   docker inspect <اسم-الحاوية> | grep -A5 'Mounts'

   يسرد هذا الأمر كل ‏bind-mounts‏ والمجلدات المُسمّاة النشطة.

الإصلاح حالة بحالة: chown على مجلد المضيف

1. 06

   ‏Grafana‏ (UID 472)

   mkdir -p /opt/grafana/data
   chown -R 472:472 /opt/grafana/data

   في ‏compose.yml‏ الخاص بك:

   volumes:
     - /opt/grafana/data:/var/lib/grafana

2. 07

   ‏Nextcloud‏ (UID 33، صورة Debian)

   mkdir -p /opt/nextcloud/{data,config,apps}
   chown -R 33:33 /opt/nextcloud/data
   chown -R 33:33 /opt/nextcloud/config

   تنبيه: صورة ‏Alpine‏ تستخدم ‏UID 82‏. تحقق بـ‏docker exec <حاوية> id www-data‏ إذا لم تكن متأكداً.

3. 08

   ‏Paperless-ngx‏ (UID 1000)

   mkdir -p /opt/paperless/{consume,export,media,data}
   chown -R 1000:1000 /opt/paperless/consume
   chown -R 1000:1000 /opt/paperless/export
   chown -R 1000:1000 /opt/paperless/media
   chown -R 1000:1000 /opt/paperless/data

4. 09

   ‏Immich‏ (UID 1000)

   mkdir -p /opt/immich/{library,thumbnails,encoded-video,profile}
   chown -R 1000:1000 /opt/immich

   تنبيه: متغيرات البيئة ‏PUID/PGID‏ لا تعمل مع صور ‏Immich‏ الرسمية.

5. 10

   التحقق بعد الإصلاح

   ls -ln /opt/grafana/data

   يجب أن يُظهر ‏drwxr-xr-x 2 472 472 ...‏. ثم أعد تشغيل الحاوية:

   docker compose restart grafana
   docker logs grafana --tail 20

الأنواع المختلفة: bind-mounts والمجلدات المُسمّاة و user:

services:
  app:
    image: my-image
    user: "1000:1000"
    volumes:
      - /home/user/data:/app/data

حالات NFS والتثبيتات البعيدة

//server/share /opt/nextcloud/data cifs uid=33,gid=33,credentials=/etc/cifs-creds,iocharset=utf8 0 0

مقارنة طرق الإصلاح

مرّر الجدول أفقيًا

استكشاف الأخطاء: 4 أخطاء كلاسيكية مع رسائلها الدقيقة

• ‏mkdir: cannot create directory '/var/lib/grafana/plugins': Permission denied‏ ← مجلد المضيف لا يملكه ‏UID 472‏. طبّق ‏chown -R 472:472 /opt/grafana/data‏.
• ‏[Errno 13] Permission denied: '/usr/src/paperless/media'‏ ← ‏Paperless-ngx‏ لا يمكنه الكتابة في مجلد ‏media‏. تحقق أن ‏bind-mount‏ يملكه ‏UID 1000‏ على المضيف.
• ‏Could not create lock file /var/lib/grafana/.~lock.grafana.db‏ ← ‏Grafana‏ يقرأ المجلد لكنه لا يستطيع الكتابة. مشكلة أذونات على الملفات الموجودة: احذف ملف القفل.
• ‏chown: changing ownership of '/data': Operation not permitted‏ (عند بدء الحاوية) ← الصورة تحاول إصلاح الأذونات لكنها لا تعمل بـ‏root‏. نفّذ ‏chown‏ يدوياً على المضيف قبل تشغيل الحاوية.

الخلاصة