SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

تثبيت Mealie على VPS باستخدام Docker Compose

شغّل Mealie على VPS تملكه عبر Docker Compose. ألصق رابط وصفة لاستخراج المكونات والخطوات، وأنشئ خطط وجبات وقوائم تسوق مع nginx وTLS والنسخ الاحتياطية.

ما يفعله مدير الوصفات المستضاف ذاتياً

يحتفظ مدير الوصفات المستضاف ذاتياً بوصفاتك في قاعدة بيانات على خادم تملكه، ويُعد Mealie الخيار الذي تستقر عليه معظم الأسر. تلصق عنوان صفحة وصفة، فيقرأ Mealie المكونات والخطوات وكمية الناتج ومدة الطهي منها، ثم يتجاهل القصة والإعلانات. وما يُضاف إلى مجموعتك هو الوصفة نفسها.

بقية التطبيق بسيطة. توجد خطة أسبوعية للوجبات تسحب الوصفات إليها، وقائمة تسوق تُنشأ من هذه الخطة. يحصل كل شخص يطبخ على حساب تسجيل دخول خاص به. يعمل التطبيق كله داخل حاوية واحدة، ويبقى خاملاً بين الطلبات، لذلك يستطيع VPS متواضع تشغيله دون أن تلاحظ حملاً يُذكر.

يستخدم هذا الدليل Docker Compose. إذا كان المصطلحان services: وvolumes: جديدين عليك، فاقرأ أولاً كيفية إعداد ملفات Docker Compose، لأن كل ما يلي يتكون من ملف compose واحد وأربعة أوامر.

تثبيت Mealie باستخدام Docker Compose

ينشر Mealie صوره إلى سجل الحاويات في GitHub. في 18 November 2026، تكون الوسمة المستقرة الحالية هي v3.31.0، وقد أُصدرت في 13 November. يتضمن هذا الإصدار إصلاحات أمنية، ويوصي المشروع الجميع بالتحديث. ثبّت إصداراً محدداً بدلاً من استخدام latest؛ لأن استخدام latest قد يؤدي في docker compose pull في يوم غير مرتبط إلى نقلك عبر ترحيل لقاعدة البيانات لم تكن مستعداً له.

sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.yml
services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.31.0
    container_name: mealie
    restart: always
    ports:
      - "127.0.0.1:9925:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    volumes:
      - mealie-data:/app/data/
    environment:
      ALLOW_SIGNUP: "false"
      PUID: 1000
      PGID: 1000
      TZ: Europe/Amsterdam
      BASE_URL: https://recipes.example.com

volumes:
  mealie-data:

يستحق سطران المراجعة قبل تشغيله.

يُكتب المنفذ بصيغة 127.0.0.1:9925:9000 وليس بصيغة 9925:9000. تستمع الحاوية على المنفذ 9000 داخلياً، ويربط المضيف المنفذ 9925 به. يؤدي ربط هذا التعيين بعنوان loopback إلى تمكين nginx من الوصول إلى Mealie ومنع الوصول إليه من الإنترنت. يكتب Docker قواعده الخاصة في packet filter، لذلك يمكن الوصول إلى 9925:9000 من خارج الخادم حتى عندما يشير جدارك الناري إلى أن المنفذ مغلق. من المهم فهم هذا السلوك مرة واحدة: راجع سبب تجاهل منافذ Docker المنشورة لـ ufw.

يجب أن تكون BASE_URL هي العنوان العام الدقيق الذي ستستخدمه، مع scheme ومن دون شرطة مائلة في النهاية. ينشئ Mealie روابط إعادة تعيين كلمة المرور وروابط الدعوات منها. إذا عيّنتها إلى http://localhost:9925، فستحتوي الدعوة التي ترسلها إلى شريكك على رابط لا يعمل إلا على الخادم نفسه.

شغّله وراقب الإقلاع الأول.

sudo docker compose up -d
sudo docker compose logs -f mealie

ينشئ التشغيل الأول قاعدة بيانات SQLite ويشغّل عمليات الترحيل، ويستغرق ذلك بضع ثوانٍ. عندما تستقر السجلات وتتوقف عن طباعة أسطر الترحيل، افحص التطبيق محلياً.

curl -I http://127.0.0.1:9925

تعني 200 OK أن التطبيق يعمل. إذا حصلت على Connection refused، فنفّذ sudo docker compose ps -a للتحقق من حالة الحاوية ورمز الخروج الخاص بها. الحاوية التي توقفت بالرمز 137 تلقّت SIGKILL؛ ولا يثبت هذا الرمز وحده أنها تجاوزت حد الذاكرة البالغ 1000M. يؤدي إيقاف الحاوية يدوياً أيضاً إلى إنتاج هذا الرمز.

تسجيل الدخول الأول وتعطيل التسجيل المفتوح

الحساب الافتراضي هو changeme@example.com وكلمة المرور هي MyPassword. سجّل الدخول باستخدامهما، ثم غيّرهما فوراً، لأن هذين الاعتمادين منشوران في الوثائق، ولذلك يعرفهما كل ماسح.

وجود ALLOW_SIGNUP: "false" في ملف compose مقصود. عند فتح التسجيل، يمكن لأي شخص يعثر على العنوان إنشاء حساب في صندوق وصفاتك. عند تعطيله، تضيف المستخدمين من منطقة الإدارة، التي تنشئ رابط دعوة ترسله إليهم بنفسك. يُبنى هذا الرابط من BASE_URL، ولذلك تهم هذه القيمة. إذا انتهى بك الأمر إلى تشغيل عدة تطبيقات على الخادم نفسه وأردت استخدام كلمة مرور واحدة لها جميعاً، يمكن لـMealie تمرير تسجيل الدخول إلى موفّر هوية خارجي، مثل مثيل Authentik مستضاف ذاتياً.

يضع Mealie المستخدمين في household، وتوجد كل household ضمن group. يشترك جميع أفراد household واحدة في خطة الوجبات وقائمة التسوق، وهذا ما تحتاج إليه العائلة. أما مجموعة الوصفات فهي أوسع من ذلك: تشارك households وصفاتها ووسومها وفئاتها مع كل household أخرى ضمن group نفسها. لذلك تحتفظ households المنفصلة على الخادم نفسه بخطط وقوائم منفصلة، لكنها تطهو من الوصفات نفسها. ويناسب ذلك أيضاً السكن المشترك حيث لا يتفق أحد على الأنشوجة. إذا احتاج المستخدمون إلى مجموعات منفصلة بالكامل، امنحهم groups منفصلة، لأن أياً من المحتوى لا تتم مشاركته بين groups.

المستورد، وهو سبب تشغيل هذا التطبيق

افتح مجموعة الوصفات، واختر إنشاء وصفة من عنوان URL، ثم الصق رابطاً. يجلب Mealie الصفحة ويبحث عن بيانات وصفة منظمة، وهي كتلة قابلة للقراءة آلياً تضعها معظم مواقع الوصفات لمحركات البحث. عند وجود هذه الكتلة، تكون عملية الاستيراد نظيفة وفورية.

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

تُجرى عمليات الاستيراد المجمّع من الشاشة نفسها: الصق قائمة بالعناوين، عنواناً واحداً في كل سطر، ويتعامل Mealie معها في الخلفية. يمكنك نقل مجموعة تضم مئتي إشارة مرجعية في جلسة واحدة.

خطط الوجبات وقائمة التسوق

مخطط الوجبات عبارة عن تقويم. اسحب وصفة إلى يوم لتخطيطها. أضف الوصفات المخططة إلى قائمة التسوق لجمع مكوّناتها. لدمج العناصر المتكررة، أنشئ أولاً Foods وUnits ضمن Manage Data، ثم فعّل كميات المكوّنات لكل وصفة وحلّل مكوّناتها لربطها بتلك الأطعمة والوحدات، بحيث تنتج وصفتان تحتاجان إلى البصل سطراً واحداً بدلاً من سطرين.

تظل القائمة صفحة مباشرة على هاتفك أثناء التسوق. وبما أن خادمك الخاص يحتفظ بها، يرى جميع أفراد المنزل القائمة نفسها في الوقت نفسه، وعندما يضع أحدهم علامة على الحليب، يُزال من شاشة الشخص الآخر.

ضع nginx وTLS أمام التطبيق

يستخدم Mealie بروتوكول HTTP العادي في هذا الإعداد، كما يدعم TLS عبر TLS_CERTIFICATE_PATH وTLS_PRIVATE_KEY_PATH. أنهِ TLS في nginx الموضوع أمامه. أنشئ سجل DNS من النوع A يشير إلى خادمك أولاً، لأن خطوة إصدار الشهادة تتحقق من اسم النطاق.

sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealie
server {
    listen 80;
    server_name recipes.example.com;

    client_max_body_size 64M;

    location / {
        proxy_pass http://127.0.0.1:9925;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

يُعد عرض nginx -t وsyntax is ok وtest is successful هو بوابة التحقق. أعد التحميل فقط بعد نجاحه، لأن إعادة تحميل إعداد معطوب تُبقي الإعداد القديم قيد التشغيل وتخفي الخطأ حتى إعادة التشغيل التالية.

وجود client_max_body_size 64M ضروري لأن القيمة الافتراضية في nginx هي 1 MB. يؤدي رفع صورة وصفة أو استعادة نسخة احتياطية عبر المتصفح إلى إرسال جسم طلب أكبر من ذلك. من دون هذا السطر، يعرض nginx الخطأ 413 Request Entity Too Large، وليس Mealie، ولذلك لا يظهر أي شيء في سجل التطبيق.

أصدر الشهادة بعد ذلك. تشرح إصدار شهادة Let's Encrypt لـ nginx باستخدام certbot هذه الخطوة ومؤقت التجديد الخاص بها.

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.com

يعيد Certbot كتابة كتلة الخادم للاستماع على 443، ويضيف إعادة توجيه من المنفذ 80. افتح الموقع عبر https:// وتأكد من أن المتصفح يقبل الشهادة. إذا فتح Mealie، لكن روابطه الداخلية تنقلك إلى http://، فهذا يعني أن BASE_URL لا يزال مضبوطاً على http. صححه، ثم نفّذ sudo docker compose up -d لإعادة إنشاء الحاوية بالقيمة الجديدة.

لا يعمل تشغيل Mealie ضمن مسار فرعي مثل example.com/recipes، لأن الواجهة الأمامية لا يمكن تقديمها من مسار فرعي. استخدم نطاقاً فرعياً.

النسخ الاحتياطية وما يفعله الاستعادة فعلياً

كل ما يملكه Mealie موجود في /app/data/ داخل الحاوية، وهو volume المسمى mealie-data. إذا نسخت هذا volume، فقد نسخت الوصفات والصور وقاعدة البيانات معاً. تذكر وثائق Mealie الخاصة أن إيقاف الحاوية ونسخ هذا المجلد هو أفضل طريقة لعمل نسخة احتياطية من تثبيت SQLite.

sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
  alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealie

يحمل اسم volume اسم المشروع كبادئة، واسم المشروع هو الدليل الذي يحتوي على ملف compose. انطلاقاً من /srv/mealie، يكون volume هو mealie_mealie-data، ولذلك يكون الأمر الأول هو docker volume ls: استخدم الاسم الذي يطبعه الأمر، وليس الاسم الوارد في هذا الدليل. من المهم إيقاف الحاوية أولاً، لأن SQLite يكون في منتصف عملية كتابة بما يكفي لجعل النسخة الحية غير قابلة للقراءة بعد الاستعادة.

يحتوي Mealie أيضاً على صفحة نسخ احتياطي خاصة به في منطقة الإدارة، وتكتب أرشيف zip يحتوي على قاعدة البيانات بصيغة database.json. يمكن استعادة الأرشيف إلى instance يعمل بالإصدار نفسه أو بإصدار أحدث من Mealie. لنقل البيانات بين خادمين، شغّل الإصدار نفسه المثبت على الخادم الجديد عند نسخ volume، أو استعد الأرشيف إلى الإصدار نفسه أو إلى إصدار أحدث. الاستعادة مدمّرة عن قصد: فهي تحذف قاعدة البيانات الحالية قبل تحميل الأرشيف، ولا يمكن التراجع عنها. سيتم تسجيل خروجك عند اكتمالها.

لا تُعد أي من النسختين نسخة احتياطية ما دامت موجودة على الخادم نفسه. ادفع الأرشيف إلى مكان آخر وفق جدول زمني، وهذا هو الغرض من النسخ الاحتياطية المشفّرة خارج الخادم باستخدام restic.

تحديث Mealie

cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealie

ارفع الإصدار المثبّت في الملف، ثم اسحب الصورة وأعد إنشاء الحاوية. تُنفَّذ عمليات الترحيل عند التشغيل الأول للصورة الجديدة. أنشئ نسخة من وحدة التخزين قبل تغيير الإصدار الرئيسي، لأن فشل عملية ترحيل في منتصفها يترك قاعدة بيانات لن تتمكن الصورة السابقة من فتحها. اقرأ ملاحظات الإصدار لكل الإصدارات الواقعة بين إصدارك والإصدار الجديد.

عندما يفشل المستورد

لا تنشر بعض المواقع أي بيانات وصفية منظّمة للوصفات، ولذلك يستورد Mealie عنواناً مع قائمة مكونات فارغة. لا يمكنك معالجة ذلك من خلال الإعدادات من دون موفّر AI، لذا ألصق نص الوصفة يدوياً بدلاً من ذلك. عند إعداد موفّر، يسلّم Mealie محتوى الصفحة إلى النموذج عندما لا يجد scraper شيئاً، وتحتاج النتيجة إلى المراجعة نفسها مقابل المصدر الأصلي مثل أي استيراد آخر بواسطة AI.

تأتي حالات فشل أخرى من حماية الروبوتات أمام موقع الوصفات، إذ يجيب الموقع Mealie بصفحة تحدٍّ بدلاً من الوصفة. ينتحل Mealie بالفعل سلوك المتصفح ويبدّل user agent لتقليل ذلك. عندما يظل الموقع يرفض الطلب، تتمثل الخيارات الموثقة في تمرير scraper عبر proxy ذي سمعة أفضل للعنوان، أو تشغيل نسخة FlareSolverr تحل التحدي في متصفح حقيقي. كلا الخيارين اختياري، ويُضبط كلاهما عبر متغيرات البيئة في الحاوية.

يختلف فشل الاستيراد الناتج عن عدم قدرة خادمك على الوصول إلى الموقع تماماً. اختبر ذلك من الخادم باستخدام curl -I https://the-site.example/recipe واقرأ سطر الحالة قبل إلقاء اللوم على scraper. منذ v3.26.0، يرفض Mealie أيضاً الجلب من العناوين الخاصة أو الداخلية، لذلك لن تُستورد صفحة وصفة مستضافة على شبكتك الخاصة حتى تضيف مضيفها إلى متغير البيئة HTTP_ALLOW_LIST.

موضعه

يُعد Mealie تطبيقاً ذاتي الاستضافة مناسباً للبدء في المنزل، لأن الأشخاص الذين يعيشون معك سيستخدمونه دون أن تطلب منهم ذلك. وهو يؤدي وظيفة مشابهة لوظيفة مكتبة الصور الخاصة بك مع Immich، لكنه أخف بكثير، ويندرج ضمن القائمة الأوسع لـالأشياء التي تستحق الاستضافة الذاتية هذا العام. ويمكن لخادم صغير واحد تشغيل التطبيقين معاً. ولا يُعد Immich الخيار الوحيد للوظيفة الثانية. وإذا كنت لا تزال تقرر، فإن الحد الأدنى للذاكرة وأوامر النسخ الاحتياطي في PhotoPrism وImmich يختلف بما يكفي لقراءته قبل أن تستهلك بقية مساحة القرص. إذا كانت الأسرة تحتفظ بخططها وملاحظاتها في مكان ما، إضافة إلى وصفات العشاء، فإن مساحة عمل AFFiNE ذاتية الاستضافة هي أيضاً تمرين على ملف compose نفسه، لكنها تحتاج إلى أربع حاويات وذاكرة أكبر بكثير مما يحتاجه Mealie. لذلك تحقق أولاً من الموارد المتبقية على الخادم. وإذا أرادت الأسرة تتبع تدريباتها إضافة إلى وجبات العشاء، فإن openGym يحتفظ ببيانات التمارين ويطلب الوسم المثبت وملف compose والشهادة نفسها التي أعددتها للتو. وللمساء بعد العشاء نسخته الخاصة من ذلك، إذ إن Halcyon يعيد بناء مكتبة Jellyfin الموجودة على هيئة متجر تأجير من تسعينيات القرن الماضي تتجول فيه، وهو حاوية صغيرة إضافية أمام شيء تشغّله بالفعل، وليس قاعدة بيانات أخرى تحتاج إلى نسخ احتياطي. ولا تنتمي كل التطبيقات في هذه المجموعة إلى تطبيقات منزلية. وإذا احتاجت العادة نفسها مستقبلاً إلى تشغيل شيء للعمل، فإن مكتب دعم Chatwoot ذاتي الاستضافة يستخدم الوسم المثبت والشهادة نفسيهما، مع Postgres وRedis وبريد صادر يعمل خلفه. وهذا مستأجر أثقل بكثير من صندوق وصفات، ويستحق خادماً مستقلاً.

FAQ

لماذا يفشل استيراد عنوان URL لوصفة؟

هناك سببان شائعان. إما أن الصفحة لا تنشر بيانات وصفة مهيكلة، لذلك لا يجد scraper شيئاً، وتحصل، ما لم يكن موفّر AI مهيّأً لقراءة الصفحة بدلاً من ذلك، على عنوان من دون مكونات؛ أو أن طبقة الحماية من الروبوتات أمام الموقع تعيد صفحة تحدٍّ بدلاً من الوصفة. في الحالة الثانية، يمكن توجيه Mealie إلى proxy ذي سمعة أفضل لعنوان IP، أو إلى instance مستضاف ذاتياً من FlareSolverr يحل التحدي في متصفح حقيقي. تأكد من أن خادمك يستطيع الوصول إلى الصفحة أصلاً باستخدام curl -I قبل تغيير أي شيء.

هل أحتاج إلى PostgreSQL، أم تكفي SQLite؟

تكفي SQLite للاستخدام المنزلي، وهي الإعداد الافتراضي. انتقل إلى PostgreSQL عندما يكون دليل البيانات موجوداً على network attached storage، لأن SQLite عبر نظام ملفات شبكي ينتج أخطاء قفل قاعدة البيانات وقد يتسبب في تلف الملف. تتطلب عمليات الاستعادة في PostgreSQL أن يكون مستخدم قاعدة البيانات superuser، لأن الاستعادة تحذف كل شيء قبل تحميل الأرشيف.

هل يمكنني تشغيل Mealie من دون اسم نطاق؟

نعم، على شبكتك الخاصة. عيّن BASE_URL إلى العنوان الذي ستكتبه فعلياً، مثل http://192.168.1.20:9925، وغيّر تعيين المنفذ إلى 192.168.1.20:9925:9000 باستخدام عنوان LAN الخاص بخادمك، وتجاوز nginx. نفّذ sudo docker compose up -d لتطبيق التغييرين. لا يقبل التعيين الأصلي 127.0.0.1:9925:9000 إلا الاتصالات الواردة من Docker host. تُبنى روابط الدعوات وإعادة تعيين كلمة المرور من BASE_URL، لذلك تنتج القيمة الخاطئة روابط لا يستطيع أي شخص آخر فتحها. لا تعرّضه للإنترنت عبر HTTP العادي، لأن بيانات تسجيل الدخول ستُرسل عندئذٍ من دون تشفير.

كيف أمنح أفراد عائلتي حسابات تسجيل دخول خاصة بهم؟

اترك ALLOW_SIGNUP مضبوطاً على "false"، وأضف الأشخاص من منطقة الإدارة، التي تنشئ رابط دعوة ترسله إليهم. ضع كل من يتشارك المطبخ في household نفسه لكي يتشاركوا خطة الوجبات وقائمة التسوق. تُشارك الوصفات مع كل household في المجموعة في كلتا الحالتين، لذلك يحتاج الأشخاص الذين يريدون مجموعات وصفات منفصلة إلى مجموعات منفصلة.

ماذا يحدث لو توقفت عن تشغيل Mealie؟

ستخرج بياناتك معه. تنشئ النسخة الاحتياطية من منطقة الإدارة بياناتك بصيغة JSON، ويمكن لـMealie أيضاً تصدير الوصفات كملفات JSON، وتظل هذه الملفات قابلة للقراءة في أي محرر نصوص من دون أي برنامج إضافي. أجرِ تصديراً واحداً قبل أن تحتاج إليه، وتحقق من قدرتك على فتحه.

هل كان هذا المقال مفيدًا؟