🎬 تثبيت Miniflux — قارئ RSS ذاتي الاستضافة بسيط وسريع
انشر Miniflux على Ubuntu بـ Docker وPostgreSQL — قارئ RSS سريع وبسيط يُدار بلوحة المفاتيح، يُبقي أخبارك على سيرفرك الخاص، على المنفذ 8215.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/miniflux/miniflux-ubuntu.sh
chmod +x miniflux-ubuntu.sh
sudo bash miniflux-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/miniflux/miniflux-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x miniflux-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، يولّد كلمة مرور لقاعدة البيانات، ويُشغّل Miniflux مع PostgreSQL 16 على المنفذ 8215، منشئاً حساب مسؤول بكلمة مرور مولّدة.
sudo bash miniflux-ubuntu.sh
4 تسجيل الدخول
افتح Miniflux وسجّل الدخول كمسؤول بكلمة المرور المولّدة التي يطبعها المثبّت:
http://<your-server-ip>:8215
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8215 | Web UI (host → container 8080) — admin + generated password |
| internal | PostgreSQL 16 (miniflux-db, not published) |
| ./db | Feeds, categories, and read state |
نظرة عامة
Miniflux قارئ خلاصات RSS وAtom بسيط ومفتوح المصدر مكتوب بلغة Go ويعتمد حصرياً على PostgreSQL كقاعدة بيانات. يأتي كثنائي واحد ثابت بدون أي اعتماديات خارجية، ويركّز على السرعة وتجربة قراءة خالية من التشتيت، ويتجنّب عمداً تضخم الميزات — لا سمات، لا إضافات، لا تتبع للعملاء. يُطوَّر منذ عام 2013 برخصة Apache 2.0 ومتاح مجاناً للاستضافة الذاتية أو كاشتراك مستضاف منخفض التكلفة.
لماذا تستخدمه
صُمم Miniflux لمن يقرأ عدداً كبيراً من الخلاصات ويريد أسرع طريق ممكن من المقال غير المقروء إلى المقروء، دون واجهات مثقلة بجافاسكريبت أو إعلانات أو ترتيب خوارزمي. ولأنه يتحدث بواجهتي Fever وGoogle Reader API، يعمل فوراً مع عشرات تطبيقات RSS الحالية للجوال وسطح المكتب، فتحصل على تجربة عميل مألوفة مع امتلاك كامل لبيانات اشتراكاتك على سيرفرك الخاص.
متى تحتاجه
- تشترك في عشرات أو مئات خلاصات RSS/Atom وتريد طريقة سريعة وخالية من التشتيت لفرزها يومياً
- تريد الاستمرار في استخدام تطبيق RSS المفضل لديك على الجوال (Reeder وNetNewsWire وFluent Reader وغيرها) دون الاعتماد على خدمة مزامنة سحابية من طرف ثالث
- سئمت القرّاء المثقلين بالميزات وتريد شيئاً بسيطاً يبدأ بسرعة ولا يعيقك أبداً
- تحتاج خدمة ذاتية الاستضافة خفيفة ومنخفضة الموارد تعمل بسلاسة حتى على VPS صغير بجانب أدوات أخرى
- تريد امتلاكاً كاملاً لتاريخ قراءتك وقائمة اشتراكاتك دون أن تجمع شركة بياناتك
من يحتاجه
- الباحثون والصحفيون الذين يتابعون عشرات المصادر الإخبارية والمدونات يومياً ويحتاجون فرزاً سريعاً لا لوحة تحكم مثقلة بالميزات
- المطورون الذين يُشغّلون بالفعل خدمات تعتمد على PostgreSQL ويريدون إضافة خفيفة دون إدارة محرك قاعدة بيانات إضافي
- القرّاء المهتمون بالخصوصية الذين يكرهون خدمات RSS السحابية التي تجمع عادات القراءة وقوائم الاشتراك
- المستخدمون المتقدمون لتطبيقات RSS الحالية (Reeder وNetNewsWire وFluent Reader وUnread) الذين يريدون خادم Fever/Google Reader API ذاتي الاستضافة
- مُشغّلو المختبرات المنزلية الذين يريدون خدمة سريعة قليلة الصيانة لا تحتاج انتباهاً متكرراً بعد نشرها
- الفرق التي تريد تجميع مدونات داخلية وسجلات تغييرات وصفحات حالة في قارئ خلاصات مشترك وذاتي الاستضافة
- المستخدمون المهاجرون من خدمات RSS السحابية المتوقفة أو المدفوعة الذين يريدون بديلاً دائماً وتحت سيطرتهم
- كل من يُقدّر القراءة المدارة بلوحة المفاتيح والخالية من التشتيت على تجربة قراءة مُثقلة بالسمات أو الطابع الاجتماعي
حالات الاستخدام الشائعة
- تجميع الأخبار والمدونات وسجلات التغييرات من عشرات المصادر في قائمة قراءة موحدة وسريعة
- ربط تطبيقات RSS الحالية للجوال عبر واجهة Fever أو Google Reader API لتجربة تطبيق مألوفة
- الاقتران مع RSS-Bridge لتوليد خلاصات لمواقع وحسابات تواصل اجتماعي لا تنشر RSS أصلياً
- استخدام قواعد الخلاصات وقواعد إعادة الكتابة لتنظيف الإعلانات وبكسلات التتبع أو المحتوى غير المرغوب من المقالات الواردة
- تشغيل webhooks أو تكاملات طرف ثالث (Discord وApprise وInstapaper وأكثر من 25 أخرى) عند وصول مقالات جديدة
- تصدير قائمة اشتراكاتك بصيغة OPML دورياً كنسخة احتياطية قابلة للنقل ومستقلة عن السيرفر
الميزات الرئيسية
- ثنائي Go واحد وثابت بدون أي اعتماديات وقت تشغيل عدا PostgreSQL — سهل النشر والتحديث
- توافق مع واجهتي Fever وGoogle Reader API، فتعمل معظم تطبيقات RSS الحالية للجوال وسطح المكتب مباشرة
- واجهة REST API كاملة مع مكتبات عميل رسمية بلغتي Go وPython لبناء تكاملات مخصصة
- مستخلص محتوى مدمج يجلب النص الكامل للمقالات في الخلاصات التي تنشر ملخصات قصيرة فقط
- قواعد خلاصات وقواعد إعادة كتابة لتصفية وإزالة التكرار وتنظيف المدخلات الواردة تلقائياً
- أكثر من 25 تكاملاً مع أطراف ثالثة تشمل Discord وApprise وInstapaper وPocket وTelegram وWebhooks
- طرق مصادقة متعددة: حسابات محلية، وOpenID Connect، وGoogle OAuth2، ومفاتيح المرور Passkeys/WebAuthn، ومصادقة عبر وكيل عكسي
- واجهة تعتمد على لوحة المفاتيح أولاً باختصارات بأسلوب Gmail/Google Reader لفرز سريع لقوائم خلاصات كبيرة
كيفية الاستخدام بعد التثبيت
- سجّل الدخول باسم المستخدم admin وكلمة المرور المولّدة التي يطبعها المثبّت، ثم غيّرها فوراً تحت Settings
- أضف خلاصاتك الأولى من Feeds → Add Feed بلصق رابط الموقع أو رابط الخلاصة مباشرة — يكتشف Miniflux الخلاصات تلقائياً من معظم المواقع
- استورد اشتراكاتك الحالية دفعة واحدة من Settings → Import إذا كان لديك ملف OPML من قارئ آخر
- نظّم الخلاصات في تصنيفات من Feeds → Categories لإبقاء المواضيع منفصلة في واجهة القراءة
- فعّل واجهة Fever أو Google Reader API تحت Settings → API Keys إذا أردت ربط تطبيق جوال
- اضبط قواعد إعادة كتابة أو قواعد استخلاص خاصة بكل خلاصة تحت إعداداتها إذا ظهرت المقالات مبتورة
- أعدّ التكاملات (Webhooks وDiscord وTelegram وغيرها) تحت Settings → Integrations لتوجيه المدخلات الجديدة إلى أماكن أخرى
- اضبط تردد الفحص وعدد العمال (workers) تحت Settings → General إذا كنت مشتركاً في عدد كبير جداً من الخلاصات
أفضل ممارسات الأمان
- غيّر كلمة مرور المسؤول الافتراضية فوراً بعد أول تسجيل دخول — كلمة المرور المولّدة تُطبع مرة واحدة فقط
- ضع Miniflux خلف وكيل عكسي مع HTTPS إذا كنت تصل إليه من خارج شبكتك المحلية — وإلا تُرسل بيانات الاعتماد بنص عادي HTTP
- لا تكشف منفذ حاوية PostgreSQL للإنترنت أبداً — أبقه على شبكة Docker الداخلية فقط، كما يفعل سكريبت هذا الدرس افتراضياً
- فعّل OpenID Connect أو Google OAuth2 لنشر الفرق بدلاً من مشاركة بيانات اعتماد المسؤول المحلية بين عدة مستخدمين
- قيّد التسجيل إذا كان Miniflux متاحاً للعامة — عطّل إنشاء الحسابات العامة إلا إذا كنت تنوي تشغيل نسخة متعددة المستخدمين
- دوّر مفاتيح API دورياً تحت Settings → API Keys، خصوصاً بعد إزالة عميل جوال أو تكامل
- أبقِ صورة Miniflux Docker محدّثة لتحصل على تصحيحات الأمان — راجع صفحة إصدارات GitHub دورياً
- احفظ نسخة احتياطية من حجم PostgreSQL قبل ترقيات الإصدار الكبرى تحسباً للحاجة إلى التراجع لصورة سابقة
المنافذ وإعدادات جدار الحماية
يستمع Miniflux على المنفذ 8080 داخل الحاوية؛ سكريبت هذا الدرس ينشره على المنفذ 8215 على المضيف. تتواصل PostgreSQL داخلياً فقط على شبكة Docker ولا تُنشر أبداً للمضيف أو للخارج. إذا أردت كشف Miniflux على الإنترنت، ضعه خلف وكيل عكسي مثل Nginx Proxy Manager على المنفذ 443 بشهادة TLS صالحة، واحظر الوصول المباشر للمنفذ 8215 في الجدار الناري لحركة المرور الخارجية.
النسخ الاحتياطي والصيانة
- احفظ نسخة احتياطية من حجم Docker ./db الذي يحتوي قاعدة بيانات PostgreSQL بأكملها — الخلاصات والتصنيفات والمدخلات وحالة القراءة
- صدّر قائمة اشتراكاتك بصيغة OPML دورياً من Settings → Export كنسخة احتياطية قابلة للقراءة والنقل
- احفظ نسخة من docker-compose.yml وأي متغيرات بيئة مخصصة حتى يمكن إعادة إنشاء الإعداد بدقة
- جدول نسخاً احتياطية آلية لـ PostgreSQL بـ pg_dump بالإضافة إلى نسخ الحجم كطبقة استعادة إضافية
- خزّن النسخ الاحتياطية خارج جهاز المضيف — Miniflux نفسه عديم الحالة، لذا فقط حجم قاعدة البيانات يحتاج للحماية
- اختبر استعادة حجم ./db على نسخة منفصلة دورياً للتأكد من عودة الخلاصات وتاريخ القراءة سليمين
الأخطاء الشائعة
- كشف المنفذ 8215 مباشرة للإنترنت دون وكيل عكسي وTLS، ما يُرسل بيانات تسجيل الدخول بنص عادي
- فقدان كلمة مرور المسؤول المولّدة لأنها ظهرت مرة واحدة فقط في مخرجات المثبّت ولم تُحفظ
- نسيان أن Miniflux يدعم PostgreSQL حصرياً — محاولة توجيهه لـ MySQL أو SQLite لن تعمل ببساطة
- عدم عمل نسخة احتياطية من حجم ./db، وهو نقطة الفشل الوحيدة التي تحمل كل خلاصة وحالة قراءة
- افتراض أن Miniflux يستطيع استخلاص أي موقع بدون خلاصة RSS — يحتاج RSS-Bridge أو أداة مشابهة لذلك
- الاشتراك في عدد مفرط من الخلاصات دون تعديل تردد الفحص، ما يسبب حملاً غير ضروري على المواقع المصدر
- تجاهل تنبيهات أخطاء الخلاصات في الواجهة، والتي غالباً ما تشير إلى تغيّر رابط الخلاصة أو حظر الموقع لأداة الجلب
- تشغيل الحاوية بدون restart: unless-stopped، فتبقى Miniflux غير متصلة بعد إعادة تشغيل السيرفر حتى إعادة تشغيلها يدوياً
استكشاف الأخطاء وإصلاحها
- لا يمكن تسجيل الدخول — تأكد من استخدام كلمة مرور المسؤول بالضبط كما طبعها المثبّت؛ أعد ضبطها عبر سطر الأوامر بـ miniflux -reset-password إذا فُقدت
- فشل تحديث خلاصة — راجع رسالة الخطأ الخاصة بالخلاصة في الواجهة؛ غالباً ما يكون السبب تغيّر الرابط أو حظر الموقع لأدوات الجلب الآلية
- لا يستطيع تطبيق الجوال الاتصال — تأكد من تفعيل واجهة Fever أو Google Reader API تحت Settings → API Keys وأن التطبيق يشير لعنوان السيرفر الصحيح
- الحاوية لا تبدأ — تحقق أولاً من سلامة PostgreSQL بـ docker logs على حاوية قاعدة البيانات قبل تشخيص Miniflux نفسه
- تظهر المقالات كملخص قصير فقط — فعّل مستخلص المحتوى لتلك الخلاصة تحت إعداداتها الخاصة لجلب النص الكامل
- تحديث بطيء للخلاصات مع عدد كبير من الاشتراكات — زد عدد العمال (workers) في الخلفية وقلّل تردد الفحص تحت Settings → General
- تكامل (Discord أو Webhook إلخ) لا يعمل — تأكد من تفعيل التكامل وصحة رابط/رمز النهاية تحت Settings → Integrations
- فشل استيراد OPML — تأكد أن الملف بصيغة OPML XML صالحة مُصدّرة من قارئ آخر وغير تالف أو منزّل جزئياً
البدائل
FreshRSS هو أقرب بديل ذاتي الاستضافة — أكثر قابلية للتخصيص، بسمات وإضافات، مقابل تعقيد أكبر. يقدّم Tiny Tiny RSS (TT-RSS) دعم إضافات وحزمة PHP/قاعدة بيانات مشابهة لكن بمنحنى تعلّم أصعب. يدعم كل من FreshRSS وMiniflux واجهتي Fever وGoogle Reader API لتوافق العملاء. NextCloud News خيار جيد إذا كنت تُشغّل Nextcloud بالفعل وتريد الخلاصات كتطبيق إضافي بدلاً من خدمة مستقلة. كقارئ سريع وحاسم قليل الإعدادات، Miniflux هو الخيار الأبسط.
متى لا تستخدمه
Miniflux ليس الخيار الصحيح إذا أردت تخصيصاً واسعاً — سمات وإضافات وCSS مخصص أو واجهة قابلة للتهيئة بعمق، لأن Miniflux يتعمّد عدم توفير أي من ذلك؛ FreshRSS يناسب هذه الحاجة أكثر. كما يتطلب PostgreSQL تحديداً، فإذا أردت قارئاً أخف يعتمد على SQLite فابحث عن بديل آخر. إذا احتجت متابعة مواقع بلا خلاصات RSS، لا يستطيع Miniflux وحده توليد خلاصات — اقرنه بـ RSS-Bridge، أو اختر قارئاً بقدرة استخلاص ويب مدمجة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي بيانات تسجيل الدخول؟
ينشئ المثبّت حساب مسؤول باسم المستخدم admin وكلمة مرور مولّدة يطبعها في رسالة الاكتمال. سجّل الدخول بها ثم غيّر كلمة المرور من الإعدادات بمجرد دخولك. احتفظ ببيانات الاعتماد في مكان آمن.
ما المنفذ الذي يستخدمه؟
المنفذ 8215 على المضيف، معيّن من المنفذ الداخلي 8080 للحاوية. تصفّح 8215؛ 8080 هو المنفذ داخل الحاوية. إذا وصلت إليه عن بُعد، ضعه خلف وكيل عكسي بـ TLS.
كيف يقارن بـ FreshRSS؟
هما القارئان ذاتيا الاستضافة الرائدان، بفلسفتين متعاكستين. FreshRSS غني بالميزات وقابل للتهيئة بعمق، بسمات وإضافات. أما Miniflux فبسيط عمداً — سريع، مباشر، حاسم، بخيارات أقل.
هل يمكنني متابعة مواقع لا تملك خلاصة RSS؟
ليس مباشرة، لكن هذا بالضبط ما صُمم من أجله RSS-Bridge. شغّل RSS-Bridge بجانب Miniflux، استخدمه لتوليد خلاصة لموقع لا يملك واحدة، ثم اشترك في تلك الخلاصة المولّدة داخل Miniflux. الأداتان تتكاملان جيداً، وRSS-Bridge موجود أيضاً في هذا الكتالوج.
ما الذي أحتاج نسخه احتياطياً؟
حجم ./db، الذي يحمل بيانات PostgreSQL بخلاصاتك وتصنيفاتك وحالة القراءة. Miniflux نفسه ثنائي واحد عديم الحالة، لذا قاعدة البيانات هي الشيء الوحيد المهم. يستحق الأمر أيضاً تصدير اشتراكاتك بصيغة OPML دورياً كنسخة قابلة للنقل يمكن استيرادها في أي مكان.