إنشاء مستودعات حزم خاصة Private Repositories بـ reprepro وتوقيع GPG
إنشاء مستودعات حزم خاصة Private Repositories لإدارة برمجياتك داخل المؤسسة يحل مشكلة تظهر مع ثالث سيرفر: أداة داخلية أو سكربت مراقبة أو نسخة معدلة من برنامج، تُنسخ يدوياً بأمر scp إلى كل سيرفر، فتنتهي كل سيرفرات المؤسسة بإصدارات مختلفة لا يعرفها أحد. والحل أن تعامل برمجياتك كما تعامل أوبونتو برمجياتها: حزمة deb بإصدار، في مستودع موقّع، تُثبت وتُحدث بالأمر apt نفسه. وفي هذا الدليل نبني ذلك كاملاً على مختبر: نصنع حزمة، وننشئ مستودعاً موقعاً بالأداة reprepro، ونقدمه عبر HTTP، ونثبت منه، ثم ننشر إصداراً جديداً ونحدّث، ونجرب ما يحدث مع مستودع بلا مفتاح ومع حزمة عُدلت بعد التوقيع.
نمر بصنع الحزمة، وإنشاء المستودع والأخطاء التي واجهتنا، والتوقيع والتثبيت، والتحديث، واختبار التلاعب، ثم البدائل.
صنع الحزمة

pkg/qtool_1.0.0/DEBIAN/control
Package: qtool
Version: 1.0.0
Architecture: all
Section: admin
Priority: optional
Maintainer: Ops Team <ops@example.com>
Description: internal health check tool
pkg/qtool_1.0.0/usr/local/bin/qtool (the script, mode 755)
$ dpkg-deb --build --root-owner-group pkg/qtool_1.0.0 -> qtool_1.0.0.deb (592 bytes)
الحزمة مجلد بشجرة الملفات كما ستكون على السيرفر، ومعه مجلد DEBIAN فيه ملف الوصف. والخيار root-owner-group يجعل الملفات مملوكة للجذر داخل الحزمة، وإلا فتُثبت بملكية من بناها. وإدارة الحزم وأدواتها بتفصيل في إدارة الحزم في لينكس.
المستودع والأخطاء التي واجهتنا
# www/conf/distributions
Codename: noble
Components: main
Architectures: amd64
SignWith: FDAE5C53F116A8CA22C52D380D133B4AF545AECE
attempt 1 (Architectures: amd64 all) -> Error: Distribution noble contains an architecture called 'all'.
attempt 2 (no Section in control) -> No section given for 'qtool', skipping.
attempt 3 -> Exporting indices...
www/dists/noble/InRelease www/dists/noble/Release.gpg www/pool/main/q/qtool/qtool_1.0.0_all.deb

الأداة reprepro تبني بنية المستودع التي يفهمها apt، وتوقعها بمفتاح GPG. وواجهنا خطأين حقيقيين يتكرران عند كل من يبدأ: كتابة المعمارية all في قائمة المستودع، وهي غير مسموحة لأن الحزم المستقلة عن المعمارية تُضاف تلقائياً لكل معمارية، ونسيان حقل القسم في ملف الحزمة، فتُتجاهل الحزمة كلها. وبعد التصحيح خرج المستودع بملف InRelease الموقع وفهرس الحزم ومجلد pool.
التوقيع والتثبيت
== without key
Err:1 http://127.0.0.1:8095 noble InRelease
NO_PUBKEY 0D133B4AF545AECE
E: The repository 'http://127.0.0.1:8095 noble InRelease' is not signed.
== with signed-by
# /etc/apt/sources.list.d/internal.list
deb [signed-by=/etc/apt/keyrings/internal.gpg] http://repo.internal noble main
Get:1 http://127.0.0.1:8095 noble InRelease [1097 B]
Setting up qtool (1.0.0) ...
بلا المفتاح العام، رفض apt المستودع كله. ومع المفتاح المحدد بالخيار signed-by للمستودع وحده، ثبتت الحزمة في ثلاث ثوانٍ. وربط المفتاح بمستودعه بدل إضافته للنظام كله مهم: المفتاح لا يصلح إلا لتوقيع هذا المستودع، فلو سُرب لا يستطيع أحد به توقيع حزم تنتحل مستودعات أوبونتو. والمفاتيح والتوقيع بالتفصيل في الشهادات الرقمية والتشفير.
التحديث
installed: qtool 1.0.0 - internal health check
$ reprepro -b www includedeb noble qtool_1.0.1.deb
Deleting files no longer referenced...
upgradable: Inst qtool [1.0.0] (1.0.1 127.0.0.1 [all])
after upgrade: qtool 1.0.1 - internal health check

نشر الإصدار الجديد أمر واحد، وبعد apt update ظهر قابلاً للتحديث مع الإصدار القديم المثبت، وحُدّث كأي حزمة. فالتحديثات الأمنية التلقائية التي تعمل على السيرفر تشمل أدواتك الداخلية أيضاً. وملاحظة: reprepro يحتفظ افتراضياً بإصدار واحد لكل حزمة في التوزيعة، وحذف الملف القديم، فإن احتجت التراجع فاحتفظ بالحزم في مكان آخر أو استخدم أداة تدعم إصدارات متعددة.
اختبار التلاعب
== same-size tamper (one bit flipped in the .deb on the server)
Hash Sum mismatch
Hashes of expected file: ...
== size change (one byte appended)
E: Failed to fetch .../qtool_1.0.1_all.deb File has unexpected size (593 != 592).
غيرنا بتاً واحداً في ملف الحزمة على الخادم دون تحديث الفهرس، فرفض apt التثبيت لأن البصمة لا تطابق الفهرس الموقع. وأضفنا بايتاً فرفضه بسبب الحجم. فمن يخترق خادم المستودع لا يستطيع استبدال حزمة دون مفتاح التوقيع، ولذلك يُحفظ المفتاح الخاص بعيداً عن خادم المستودع.
البدائل

للمؤسسات الأكبر، أدوات مثل aptly تدعم اللقطات والإصدارات المتعددة ونسخ المستودعات الرسمية، وأدوات إدارة المستودعات الشاملة تخدم deb وrpm وحزم Python وnpm وصور الحاويات في مكان واحد. ولتوزيعات Red Hat، المستودع مجلد حزم rpm مع فهرس تبنيه الأداة createrepo. والمبدأ في كلها واحد: حزم بإصدارات، وفهرس موقع، ومفتاح محمي.
أخطاء شائعة
المعمارية all في المستودع
رفضها reprepro صراحة.
حزمة بلا حقل القسم
تُتجاهل بصمت تقريباً.
الخيار trusted=yes لتجاوز التوقيع
يلغي الحماية التي رأيناها.
المفتاح الخاص على خادم المستودع
اختراق الخادم يعني توقيع أي شيء.
أسئلة يطرحها الناس
هل أحتاج HTTPS للمستودع؟
التوقيع يحمي سلامة الحزم، وHTTPS يضيف الخصوصية ويخفي ما تثبته.
كيف أحدّث كل السيرفرات بعد النشر؟
بالتحديثات التلقائية، أو بأداة إدارة مثل Ansible تشغل apt على المجموعة.
الخلاصة
صنعنا حزمة deb ومستودعاً موقعاً بـ reprepro بعد خطأين يتكرران عند كل مبتدئ، فرفض apt المستودع بلا مفتاح، وثبت الحزمة مع signed-by، وحدّثها إلى الإصدار الجديد بأمر نشر واحد، ورفض حزمة غُيّر فيها بت واحد. فأدواتك الداخلية صارت تُدار كحزم النظام.


