في فيدورا، كل شيء يبدأ وينتهي بالمستودعات. من تحديث النظام إلى تثبيت حزمة صغيرة، يمر كل شيء عبر نظام المستودعات. ومع ذلك، فإن كثيرين يتعاملون مع dnf كصندوق أسود: يكتبون الأمر، وينتظرون النتيجة. عندما يتعطل شيء — خطأ GPG، تعارض في الحزم، مستودع لا يستجيب — يبدأ الارتباك.

هذا الدليل يفكك النظام من الداخل. منذ أن أصبح dnf5 هو المدير الافتراضي في فيدورا 41، تغيرت أشياء كثيرة: مسارات ملفات المستودعات، وطريقة إضافة المستودعات وإزالتها، وحتى سلوك الأوامر. سنمر على بنية dnf5، وconfig-manager الجديد، وCOPR وRPM Fusion، والمستودعات المحلية عبر reposync، والأولويات، واستكشاف الأخطاء — حتى تتعامل مع المستودعات كمهندس نظام، لا كمستخدم عابر.

نظرة سريعة: خريطة إدارة المستودعات في فيدورا

الجدول التالي يلخص المفاهيم والأدوات الأساسية التي يغطيها الدليل، مع الفرق الجوهري بينها:

المفهوم / الأداة الوظيفة مثال
ملف .repo تعريف مستودع واحد أو أكثر /etc/yum.repos.d/*.repo
dnf5 config-manager إضافة، إزالة، تعديل المستودعات dnf config-manager addrepo
dnf5 copr إدارة مستودعات COPR المجتمعية dnf copr enable owner/project
RPM Fusion حزم غير حرة (Free/Nonfree) تثبيت حزمة RPM الرسمية
reposync مزامنة مستودع كامل محليًا dnf reposync --repo=fedora
setopt تعديل خيارات المستودع دون لمس الملف dnf config-manager setopt repo.enabled=0
priority ترتيب أولوية المستودعات priority=10 (أعلى أولوية)
gpgcheck التحقق من توقيع الحزم gpgcheck=1 (إلزامي)

dnf5: الثورة الهادئة في إدارة الحزم

dnf5 في فيدورا

dnf5 ليس مجرد تحديث لـdnf القديم. إنه إعادة كتابة كاملة بلغة C++ (C++20) لتحسين الأداء وتقليل الاعتماديات الخارجية. يتكون من عدة مكونات: dnf5 (سطر الأوامر)، libdnf5 (المكتبة الأساسية)، libdnf5-cli (مساعد سطر الأوامر)، ونظام إضافات (Plugins) من طبقتين، بالإضافة إلى dnf5daemon (خدمة D-Bus).

متى أصبح dnf5 هو الافتراضي؟ في فيدورا 41، أصبح /usr/bin/dnf مجرد رابط رمزي (Symlink) إلى dnf5. هذا يعني أن كل أمر تكتبه بصيغة dnf يُنفَّذ فعليًا عبر dnf5. لكن هذا التغيير لم يكن مجرد تغيير في الاسم؛ فقد جاء بتغييرات جوهرية في السلوك:

  • ملفات الحالة مختلفة: سجل المعاملات (Transaction History) في dnf5 لا يُرحَّل تلقائيًا من dnf4. إذا كنت تستخدم dnf history، فستبدأ من جديد بعد الترقية إلى dnf5.
  • الخيارات العامة مقابل الخاصة بالأمر: في dnf5، هناك تمييز واضح بين الخيارات العامة (مثل --disable-repo) التي يمكن وضعها قبل أو بعد الأمر، والخيارات الخاصة بالأمر (مثل --downloadonly) التي يجب أن تأتي بعد اسم الأمر فقط.
  • سلوك أكثر صرامة: إذا مررت معرف مستودع غير صالح إلى --disable-repo، فسيفشل الأمر بدلاً من تجاهله بصمت.
  • الأداء: في المعايير النموذجية، dnf5 أسرع 2-3 مرات في تحديث البيانات الوصفية (Metadata) وحل الاعتماديات (Dependency Resolution) مقارنة بـdnf4.

نقطة مهمة أخرى: في فيدورا 45، نُقلت ملفات المستودعات الرسمية من /etc/yum.repos.d/ إلى /usr/share/dnf5/repos.d/، ومفاتيح التوقيع من /etc/pki/rpm-gpg/ إلى /usr/share/pki/rpm-gpg/. هذا يعني أن السكربتات القديمة التي تبحث عن ملفات المستودعات في المسار القديم قد تتوقف عن العمل. المستودعات التي تضيفها أنت (عبر config-manager أو COPR) تبقى في /etc/yum.repos.d/ كما هي.

تشريح المستودع: ما هو ملف .repo؟

كل مستودع في فيدورا يُعرَّف بملف نصي بامتداد .repo. هذا الملف يخبر dnf5 بأربعة أشياء أساسية: أين يوجد المستودع، كيف يتحقق من صحة الحزم، هل هو مفعّل، وما أولويته.

البنية الأساسية لملف .repo تبدو هكذا:

[fedora]
name=Fedora $releasever - $basearch
# baseurl=http://mirror.example.com/fedora/$releasever/$basearch/
metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
priority=99

شرح الحقول الأساسية:

  • [fedora]: معرف المستودع (Repo ID). يجب أن يكون فريدًا. هذا هو الاسم الذي تستخدمه في أوامر مثل --repo=fedora.
  • name: اسم وصفي يظهر في dnf repolist.
  • baseurl أو metalink: عنوان المستودع. metalink يوجه dnf5 إلى قائمة مرايا ديناميكية، وهو المفضل للمستودعات الكبيرة.
  • enabled=1: تفعيل المستودع. enabled=0 يعني أنه معطّل.
  • gpgcheck=1: إلزامي للمستودعات الخارجية. يتحقق dnf5 من توقيع كل حزمة قبل تثبيتها.
  • gpgkey: مسار أو رابط مفتاح GPG العام للمستودع.
  • priority: اختياري. رقم أقل يعني أولوية أعلى. يُستخدم عندما تحتوي مستودعات متعددة على نفس الحزمة.

يمكنك وضع عدة أقسام في ملف .repo واحد، كل قسم لمستودع مختلف. هذا شائع في ملفات RPM Fusion التي تحتوي على أقسام [rpmfusion-free] و[rpmfusion-nonfree] معًا.

config-manager: الأداة الموحدة لإدارة المستودعات

في dnf5، أصبح dnf config-manager هو الطريقة الرسمية والموحدة لإدارة المستودعات. الأوامر القديمة مثل --add-repo و--set-enabled لم تعد مدعومة بالطريقة السابقة. بدلاً من ذلك، هناك أوامر فرعية (Subcommands) واضحة:

إضافة مستودع من ملف .repo

الطريقة الأساسية لإضافة مستودع هي عبر addrepo مع الخيار --from-repofile:

sudo dnf config-manager addrepo --from-repofile=https://example.com/repo.repo

هذا الأمر ينسخ ملف .repo من الرابط إلى /etc/yum.repos.d/ (أو أول مسار في خيار reposdir) دون تغيير محتواه. إذا أردت تحديد اسم الملف، استخدم --save-filename. وإذا كان الملف موجودًا مسبقًا وتريد استبداله، أضف --overwrite.

إضافة مستودع يدويًا عبر خيارات

يمكنك أيضًا تعريف مستودع دون ملف .repo جاهز، باستخدام --set:

sudo dnf config-manager addrepo   --id=my-repo   --set=baseurl=https://repo.example.com/fedora/   --set=gpgcheck=1   --set=gpgkey=https://repo.example.com/RPM-GPG-KEY

يجب أن تحدد واحدًا على الأقل من baseurl أو mirrorlist أو metalink. معرف المستودع (--id) اختياري؛ إذا لم تحدده، يُولَّد من الرابط.

تفعيل وتعطيل المستودعات

بدلاً من الخيارات القديمة --set-enabled و--set-disabled، يستخدم dnf5 الأمر setopt:

# تعطيل مستودع
sudo dnf config-manager setopt fedora.enabled=0

# تفعيل مستودع
sudo dnf config-manager setopt fedora.enabled=1

هذا الأمر لا يعدّل ملف .repo الأصلي. بدلاً من ذلك، يكتب التعديل في ملف 99-config_manager.repo داخل /etc/dnf/repos.override.d/. هذا الملف يُقرأ بعد ملفات المستودعات الأصلية، لذا فإن تعديله هو الذي يسري. الميزة: يمكنك تعطيل مستودع مؤقتًا دون العبث بملفه الأصلي، وهو مفيد بشكل خاص للمستودعات التي تأتي من حزم RPM (مثل RPM Fusion) والتي قد يُعاد كتابة ملفاتها عند التحديث.

إزالة مستودع

لإزالة مستودع، يمكنك ببساطة حذف ملف .repo الخاص به:

sudo rm /etc/yum.repos.d/repo-file.repo

إذا كنت لا تعرف اسم الملف، يمكنك البحث عن معرف المستودع:

grep -E "^[.*]" /etc/yum.repos.d/*.repo

هذا سيطبع قائمة بكل معرفات المستودعات وملفاتها.

المستودعات الخارجية: RPM Fusion وCOPR

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

RPM Fusion: الحزم غير الحرة

RPM Fusion هو المستودع الخارجي الأكثر شيوعًا. يوفر حزمًا لا يمكن لفيدورا تضمينها لأسباب قانونية أو ترخيصية — برامج مثل مشغلات الفيديو (codecs)، وبعض برامج الرسوميات، وأدوات multimedia. له فرعان: free (مفتوح المصدر لكن ليس في فيدورا) وnonfree (غير مفتوح المصدر).

الطريقة الموصى بها لإضافته هي عبر حزمة RPM الرسمية، وليس بكتابة ملف .repo يدويًا:

sudo dnf install   https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm   https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

هذه الحزمة تضع ملفات .repo في المكان الصحيح، وتستورد مفاتيح GPG تلقائيًا، وتتعامل مع متغير $releasever تلقائيًا. لا تحتاج إلى إعادة تشغيل؛ فقط شغّل sudo dnf upgrade --refresh لتحديث البيانات الوصفية.

COPR: مستودعات المجتمع

COPR (Cool Other Package Repo) هو خدمة بناء حزم مجتمعية تستضيفها فيدورا. أي مستخدم لديه حساب Fedora يمكنه بناء حزم ونشرها. هذا يجعله مشابهًا لـPPA في أوبونتو، لكنه يبقى داخل نظام DNF.

لتفعيل مستودع COPR، استخدم:

sudo dnf copr enable username/project-name

هذا الأمر يقوم بأمرين: ينزّل ملف .repo من خادم COPR ويضعه في /etc/yum.repos.d/، ويستورد مفتاح GPG الخاص بالمشروع تلقائيًا.

للتعامل مع COPR بأمان، يجب أن تفهم الفرق بين ثلاثة أوامر تبدو متشابهة لكنها مختلفة جذريًا:

  • dnf copr disable: يعطّل المستودع (يجعل enabled=0) لكنه يبقي الملف على القرص. يمكنك إعادة تفعيله لاحقًا.
  • dnf copr remove: يحذف الملف بالكامل من /etc/yum.repos.d/. هذا هو الخيار الأنظف إذا كنت متأكدًا أنك لن تحتاج المستودع مجددًا.
  • dnf copr list: يعرض كل مستودعات COPR المفعّلة على نظامك.

COPR بعمق: التحقق قبل التفعيل

مشكلة COPR الأساسية هي التحقق. ليس كل مشروع COPR نشطًا أو محدثًا. عندما تفرّع فيدورا إصدارًا جديدًا، يقوم COPR بنسخ آخر بناء ناجح من rawhide لكل مشروع إلى chroot الإصدار الجديد دون إعادة بناء. هذا يعني أن مشروعًا لم يُلمس منذ سنوات قد يبدو "مدعومًا" لأنه يملك chroot للإصدار الجديد، لكن الحزمة فيه قد تكون قديمة جدًا.

قبل تفعيل أي COPR، تحقق من حالة البناء الفعلية. يمكنك استخدام COPR API:

OWNER=username
PROJECT=project-name
curl -fsSL "https://copr.fedorainfracloud.org/api_3/monitor?ownername=${OWNER}&projectname=${PROJECT}"   | jq -r '.packages[] | .name as $n | .chroots | to_entries[]   | select(.key|test("fedora-(rawhide|'"$(rpm -E %fedora)"')-x86_64"))   | "($n) (.key) (.value.state) (.value.pkg_version) build (.value.build_id)"'

ابحث عن حالة succeeded (نجح البناء) وليس forked (نُسخ دون إعادة بناء). إذا كانت الحالة forked، فالحزمة قد تكون قديمة أو غير متوافقة مع إصدارك الحالي من فيدورا.

المستودعات المحلية وreposync

في البيئات المؤسسية، أو عندما تكون الشبكة محدودة، أو عندما تريد اختبار التحديثات قبل نشرها، قد تحتاج إلى مرآة محلية (Local Mirror) للمستودعات. هذا يسمح لك بتقديم تحديثات فيدورا من بنيتك التحتية الخاصة.

الأداة الأساسية هي dnf reposync، والتي تأتي من حزمة dnf5-plugins:

sudo dnf install dnf5-plugins

ثم، لمزامنة مستودعي fedora وupdates إلى مسار محلي:

sudo dnf reposync --repo=fedora --repo=updates --download-path=/var/www/html/mirror

يمكنك تقييد المزامنة بمعماريات محددة لتوفير المساحة:

sudo dnf reposync --repo=fedora --repo=updates   --download-path=/var/www/html/mirror   --arch=x86_64 --arch=noarch

ولإزالة الحزم التي لم تعد موجودة في المستودع البعيد:

sudo dnf reposync --repo=fedora --repo=updates   --download-path=/var/www/html/mirror --delete

بعد المزامنة، تحتاج إلى خادم ويب (مثل Apache أو nginx) لتقديم المحتوى. ثم، على كل جهاز عميل، أنشئ ملف .repo يشير إلى المرآة المحلية، مع تعطيل المستودعات الافتراضية.

تحذير مهم: المزامنة الأولى تنزّل المستودع كاملًا وقد تستغرق وقتًا طويلًا وتعتمد على مساحة قرص كبيرة. قد تنمو المستودعات بنسبة 30% أو أكثر خلال دورة حياة الإصدار، لذا خطط لمساحة إضافية.

الأولويات والاستثناءات: عندما تتصادم المستودعات

عندما تحتوي عدة مستودعات على نفس الحزمة (أو إصدارات مختلفة منها)، يحتاج dnf5 إلى طريقة لتحديد أيها يختار. هنا يأتي دور أولويات المستودعات (Repository Priorities).

الأولوية في فيدورا تُضبط عبر إضافة priority=N إلى قسم المستودع في ملف .repo. القاعدة بسيطة: الرقم الأصغر يعني أولوية أعلى. إذا كان لديك مستودعان يحتويان على نفس الحزمة، والمستودع A له priority=10 والمستودع B له priority=20، فسيختار dnf5 الحزمة من A.

الأولوية الافتراضية هي 99. يمكنك تغييرها عبر config-manager setopt:

sudo dnf config-manager setopt my-repo.priority=10

لكن الأولوية ليست الأداة الوحيدة. هناك أيضًا الاستثناءات (Excludes)، والتي تمنع حزمًا معينة من التثبيت أو التحديث. يمكنك استثناء حزمة من مستودع معين:

sudo dnf config-manager setopt my-repo.exclude=package-name

أو استثناء حزمة على مستوى النظام كله عبر /etc/dnf/dnf.conf:

[main]
exclude=package-name other-package

تحذير: كن حذرًا مع الاستثناءات. إذا استثنيت حزمة يعتمد عليها نظامك، فقد تمنع تحديثات أمنية مهمة أو تسبب كسر الاعتماديات.

استكشاف الأخطاء: الأخطاء الشائعة وحلولها

حتى مع الإعداد الصحيح، قد تواجه أخطاء. إليك أكثر الأخطاء شيوعًا في إدارة المستودعات وكيفية إصلاحها:

الخطأ السبب الحل
"GPG key not found" مفتاح المستودع غير مستورد تأكد من صحة gpgkey أو استورد المفتاح يدويًا
"Failed to synchronize cache" مشكلة شبكة أو رابط مستودع خاطئ sudo dnf clean all ثم sudo dnf makecache
"Repository ID is not unique" تعريف نفس المعرف في ملفين ابحث عن الملف المكرر بـ grep -r "\[repo-id\]" /etc/yum.repos.d/
"Unknown argument --add-repo" استخدام صيغة dnf4 القديمة في dnf5 استخدم config-manager addrepo --from-repofile
"Chroot not found" (COPR) المشروع لا يدعم إصدار فيدورا لديك تحقق من chroots المتاحة عبر COPR API
تعارض اعتماديات (Dependency Conflict) مستودعان يقدمان إصدارات متضاربة استخدم priority أو --allowerasing بحذر
"Nothing provides ..." حزمة مطلوبة غير موجودة في أي مستودع مفعّل فعّل المستودع الذي يحتويها (RPM Fusion غالبًا)
"Metadata expired" بيانات مستودع قديمة sudo dnf --refresh upgrade

نصيحة تشخيصية: عندما تواجه مشكلة في مستودع معين، ابدأ بـ dnf repolist --all لرؤية كل المستودعات وحالتها. ثم استخدم dnf repoinfo repo-id لرؤية تفاصيل المستودع (الحجم، آخر تحديث، الحزم). وأخيرًا، dnf --refresh makecache لإعادة بناء ذاكرة التخزين المؤقت.

أفضل الممارسات في إدارة المستودعات

  • لا تخلط بين dnf4 وdnf5: إذا كنت تستخدم فيدورا 41 أو أحدث، فاعتمد على أوامر dnf5. الصيغ القديمة مثل --add-repo قد تفشل بصمت أو برسائل خطأ غير واضحة.
  • استخدم config-manager دائمًا: بدلاً من تحرير ملفات .repo يدويًا (إلا إذا كنت تعرف ما تفعله). setopt يحفظ تعديلاتك في ملف منفصل، مما يسهل التراجع عنها.
  • تحقق من COPR قبل التفعيل: لا تفعّل مشروعًا لمجرد أنه يحتوي على chroot لإصدارك. استخدم COPR API للتحقق من حالة البناء الفعلية.
  • استخدم RPM Fusion عند الحاجة فقط: ليس كل نظام يحتاج إلى RPM Fusion. إذا كنت لا تحتاج إلى codecs أو برامج nonfree، فتجنبه.
  • اضبط الأولويات بحذر: الأولويات القوية جدًا (مثل priority=1 لمستودع خارجي) يمكن أن تمنعك من الحصول على تحديثات أمنية من فيدورا. ابدأ بقيم متحفظة (مثل 50 للمستودعات الخارجية).
  • نظّف ذاكرة التخزين المؤقت بانتظام: sudo dnf clean all يزيل البيانات القديمة ويمنع مشاكل "Metadata expired".
  • احتفظ بسجل للتغييرات: إذا أضفت مستودعات متعددة، اكتب ملاحظات عن سبب إضافة كل واحد. بعد أشهر، لن تتذكر لماذا أضفت COPR معين.
  • لا تستخدم --nogpgcheck: هذا الخيار يعطل التحقق من التوقيعات، وهو خطر أمني كبير. إذا كان مستودع لا يوفر مفاتيح GPG، فابحث عن بديل أكثر أمانًا.

قائمة تحقق نهائية

  • هل تعرف الفرق بين dnf4 وdnf5؟ ← dnf5 هو الافتراضي منذ فيدورا 41
  • هل تستخدم config-manager addrepo بدلاً من --add-repo؟ ← نعم، الصيغة القديمة لم تعد تعمل
  • هل تتحقق من COPR عبر API قبل التفعيل؟ ← ضروري لتجنب حزم قديمة
  • هل تفهم الفرق بين copr disable وcopr remove؟ ← disable يعطّل، remove يحذف
  • هل تستخدم setopt لتعطيل المستودعات بدلاً من تحرير الملفات؟ ← أفضل وأأمن
  • هل تضبط أولويات المستودعات عند وجود تعارض؟ ← نعم، لكن بحذر
  • هل تستخدم gpgcheck=1 دائمًا؟ ← إلزامي للمستودعات الخارجية
  • هل تعرف كيف تزامن مستودعًا محليًا بـreposync؟ ← مفيد للبيئات المؤسسية
  • هل تنظف ذاكرة التخزين المؤقت عند حدوث أخطاء؟ ← dnf clean all

فيما يلي الروابط الرسمية والوثائق التي يمكنك الرجوع إليها لفهم أعمق وإدارة أفضل لمستودعات فيدورا:

أسئلة شائعة

ما الفرق بين dnf وdnf5؟

dnf5 هو الجيل الجديد من مدير الحزم، مكتوب بلغة C++ لأداء أفضل. منذ فيدورا 41، أصبح /usr/bin/dnf مجرد رابط رمزي إلى dnf5، لذا كل أمر dnf يُنفَّذ عبر dnf5. الفرق ليس في الاسم فقط: هناك تغييرات في الخيارات المتاحة، ومسارات ملفات المستودعات، وسلوك الأوامر.

لماذا لا يعمل الأمر dnf config-manager --add-repo؟

لأن dnf5 غيّر واجهة الأوامر. الخيار --add-repo القديم لم يعد مدعومًا. بدلاً من ذلك، استخدم الأمر الفرعي الجديد: dnf config-manager addrepo --from-repofile=URL. هذا التغيير مقصود لجعل الأوامر أكثر وضوحًا وأقل عرضة للأخطاء.

كيف أتحقق من أن COPR معين آمن قبل تفعيله؟

لا يمكنك التأكد من "أمان" مشروع COPR بشكل مطلق، لكن يمكنك التحقق من نشاطه وحداثة بنائه. استخدم COPR API للتحقق من حالة البناء: ابحث عن succeeded بدلاً من forked. المشاريع التي حالتها forked فقط لم تُبنَ خصيصًا لإصدارك الحالي، وقد تحتوي على حزم قديمة.

ما الفرق بين dnf copr disable وdnf copr remove؟

disable يعطّل المستودع (يجعل enabled=0) لكنه يبقي ملف .repo على القرص. يمكنك إعادة تفعيله لاحقًا. أما remove فيحذف الملف بالكامل. استخدم disable إذا كنت تريد الاحتفاظ بالخيار، وremove إذا كنت متأكدًا أنك لن تحتاج المستودع مجددًا.

كيف أضيف مستودعًا محليًا (Mirror) في فيدورا؟

استخدم dnf reposync (من حزمة dnf5-plugins) لمزامنة المستودع إلى مسار محلي، ثم قدّمه عبر خادم ويب (Apache أو nginx). على العملاء، أنشئ ملف .repo يشير إلى المرآة المحلية باستخدام baseurl، وعطّل المستودعات الافتراضية بتعيين enabled=0 في ملفاتها.

ماذا أفعل عند تعارض الاعتماديات بين مستودعين؟

أولاً، حدد المستودع الذي يجب أن تكون له الأولوية. استخدم priority في ملف .repo (رقم أقل = أولوية أعلى). إذا كنت لا تريد حذف أي مستودع، يمكنك استخدام --allowerasing مع dnf install للسماح لـdnf5 بإزالة الحزم المتعارضة. لكن استخدم هذا الخيار بحذر، لأنه قد يزيل حزمًا تعتمد عليها.