[{"data":1,"prerenderedAt":163},["ShallowReactive",2],{"seo-verification":3,"blog-كيفية-استضافة-umami-على-خادم-vps-ma-ar":6,"promo-bar-likely":162},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"key":7,"data":8},"blog-كيفية-استضافة-umami-على-خادم-vps-ma-ar",{"id":9,"slug":10,"slugs":11,"title":15,"excerpt":16,"readTime":17,"views":18,"isPinned":19,"noindex":19,"publishedAt":20,"updatedAt":21,"category":22,"categories":27,"featuredImage":29,"bgImage":30,"posterImage":31,"relatedSolution":32,"intro":35,"sections":36,"ctaTitle":102,"ctaBody":103,"ctaButton":104,"ctaUrl":105,"relatedPosts":106},152,"كيفية-استضافة-umami-على-خادم-vps",{"fr":12,"en":13,"ar":10,"es":14},"heberger-umami-vps","how-to-host-umami-on-a-vps","como-alojar-umami-en-un-vps","كيفية استضافة Umami على خادم VPS","انشر Umami على خادم VPS: تحليلات ويب خفيفة وتحترم الخصوصية دون ملفات تعريف ارتباط، مستضافة ذاتيًا بـ Docker وHTTPS. دليل شامل مع استكشاف الأخطاء.",7,1,false,"2026-07-15T00:00:00+00:00","2026-10-09T22:36:10+00:00",{"id":17,"name":23,"slug":24,"color":25,"icon":26},"الاستضافة الذاتية","self-hosting","bg-indigo-500\u002F10 text-indigo-400","cloud",[28],{"id":17,"name":23,"slug":24,"color":25,"icon":26},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fheberger-umami-vps-poster.svg",{"categorySlug":33,"appSlug":34},"التحليلات-والجمهور","analytics-umami","‏Umami أداة تحليلات ويب مفتوحة المصدر، خفيفة وتحترم الخصوصية: تقيس جمهورك دون ملفات تعريف ارتباط ودون جمع بيانات شخصية. باستضافتها ذاتيًا على خادم VPS الخاص بك، تصبح مالكًا لإحصاءات زياراتك دون أن تعهد بها إلى وكالة إعلانات. إليك كيفية نشرها باستخدام Docker وقاعدة بيانات PostgreSQL ووكيل عكسي وشهادة TLS — وكيفية حل المشكلات الثلاث الأكثر شيوعًا عند التشغيل.",[37,41,50,53,72,75,93,97,99],{"type":38,"title":39,"body":40},"h2","لماذا تستضيف Umami ذاتيًا على خادم VPS","‎Umami بديل خفيف لـ ‎Google Analytics: مفتوح المصدر، بدون ملفات تتبع، ودون نقل بيانات إلى جهات خارجية. على ‎VPS، تحتفظ بالتحكم الكامل — لا حساب ‎SaaS، ولا حدود على عدد المواقع، ولا بيانات مشتركة. حزمة ‎Docker بسيطة: حاوية ‎Node.js للتطبيق وحاوية ‎PostgreSQL لقاعدة البيانات. يكتمل الإعداد في أقل من عشر دقائق على ‎VM عادي بصلاحيات الجذر، وتبقى بياناتك على خادمك.\n\nمقارنةً بـ ‎Google Analytics 4، لا تتطلب ‎Umami موافقة على الإحصاءات المجهولة في معظم الدول الأوروبية. ومقارنةً بـ ‎Matomo، فإن بصمتها في الذاكرة أقل بكثير، وإعداد ‎Docker لا يتجاوز ملف `docker-compose.yml` واحدًا. بالنسبة لوكالة تدير عشرة عملاء، تكفي نسخة ‎Umami واحدة بعشرة مواقع عوضًا عن اشتراك ‎SaaS مدفوع لكل مستخدم أو نطاق. أضاف الإصدار ‎2.14 (يوليو 2026) دعمًا أصليًا للأحداث المخصصة ولوحة تحكم قابلة للتصدير بتنسيق ‎CSV — ميزتان طال انتظارهما من فرق التسويق.",{"type":42,"title":43,"items":44},"ul","الفوائد الملموسة لـ Umami المستضاف ذاتيًا",[45,46,47,48,49],"متوافق مع الخصوصية: لا ملفات تعريف ارتباط، ولا بيانات شخصية، وغالبًا دون الحاجة إلى لافتة موافقة.","تبقى إحصاءات جمهورك على خادمك، دون مشاركتها مع أي طرف ثالث.","سكربت تتبّع فائق الخفّة، دون أثر ملحوظ على سرعة الصفحات.","لوحة تحكّم واضحة ومتعدّدة المواقع من نسخة واحدة.","تكلفة ثابتة مهما كان حجم مشاهدات الصفحات.",{"type":38,"title":51,"body":52},"المتطلبات العتادية والبرمجية","تعمل ‎Umami على أي ‎VPS مثبَّت عليه ‎Docker. الحد الأدنى الموصى به هو ‎1 vCPU و512 ميغابايت ذاكرة وصول عشوائي للاستخدام الشخصي أو للشركات الصغيرة؛ فوق ‎200,000 مشاهدة صفحة شهريًا، يتجنب ‎1 جيجابايت تباطؤ ‎PostgreSQL. ستحتاج إلى: ‎Docker Engine (≥‎ 20.10) وDocker Compose V2 (`docker compose`، وليس `docker-compose`)، ونطاق أو نطاق فرعي يشير إلى ‎VPS الخاص بك، وخادم وكيل عكسي (nginx أو Caddy) لتقديم ‎Umami عبر ‎HTTPS. ‎Debian 12 وUbuntu 22 هما التوزيعتان المرجعيتان؛ تفترض الأوامر التالية الوصول بصلاحيات الجذر.\n\nعلى جانب الخادم، افتح المنفذين ‎80 و‎443 في جدار الحماية (`ufw allow 80\u002Ftcp && ufw allow 443\u002Ftcp`). تحتاج ‎Umami فقط إلى ‎HTTPS مكشوفًا للخارج؛ منفذ التطبيق (‎3000 افتراضيًا) يبقى داخليًا ولا يُفتح مباشرةً. إذا كنت تستخدم ‎VPS من ‎ServOrbit، فإن مجموعة الأمان الافتراضية تسمح بالفعل بـ ‎80 و‎443.",{"type":54,"title":55,"steps":56},"steps","نشر Umami باستخدام Docker وHTTPS",[57,60,63,66,69],{"title":58,"body":59},"تهيئة خادم VPS وDocker","‏عبر SSH، حدّث النظام وثبّت Docker عبر `curl -fsSL https:\u002F\u002Fget.docker.com | sh`. أنشئ `mkdir -p \u002Fopt\u002Fumami && cd \u002Fopt\u002Fumami`.",{"title":61,"body":62},"كتابة ملف docker-compose.yml","‏عرّف خدمتين: `ghcr.io\u002Fumami-software\u002Fumami:postgresql-latest` وقاعدة بيانات `postgres`. أدخل `DATABASE_URL` و`APP_SECRET` عشوائيًا.",{"title":64,"body":65},"تشغيل الحاويات","‏نفّذ `docker compose up -d`. يستمع Umami محليًا على المنفذ 3000؛ وتُهيَّأ قاعدة البيانات تلقائيًا عند أول تشغيل.",{"title":67,"body":68},"إعداد الوكيل العكسي","‏مع Caddy: `stats.your-domain.com { reverse_proxy localhost:3000 }`. يتم الحصول على شهادة Let's Encrypt وتجديدها تلقائيًا.",{"title":70,"body":71},"إضافة موقعك والسكربت","‏سجّل الدخول (admin\u002Fumami افتراضيًا، غيّرها فورًا)، أضف موقعك والصق مقتطف التتبّع المُقدَّم في `\u003Chead>` صفحاتك.",{"type":38,"title":73,"body":74},"مشكلات شائعة عند التشغيل","‏ثلاثة أسباب رئيسية تُفسّر الغالبية العظمى من حالات الفشل المُبلَّغ عنها في أدلة المجتمع لعام 2026. إليك التشخيص والحل لكل منها.\n\n**‏1. حلقة إعادة تشغيل «Can't reach database server» — `DATABASE_URL` لا يطابق `POSTGRES_PASSWORD`**\n\n‏هذا هو الفخ الأكثر شيوعًا عند النسخ واللصق: تحتوي `DATABASE_URL` على كلمة المرور بنص صريح ضمن سلسلة الاتصال، ويجب أن تكون هذه الكلمة **مطابقة تمامًا** لقيمة `POSTGRES_PASSWORD` في خدمة `db`. إذا غيّرت إحداهما دون الأخرى، يبدأ Umami، ويفشل في الوصول إلى قاعدة البيانات، ويُعيد التشغيل في حلقة لا نهاية لها — دون رسالة خطأ واضحة في سجلات Docker.\n\n‏تحقّق من تطابق المتغيّرين:\n\n```\n# في .env أو في ملف الـ compose\nPOSTGRES_PASSWORD=كلمة_مرور_قوية\n\n# في DATABASE_URL، نفس كلمة المرور في الموضع الثالث\nDATABASE_URL=postgresql:\u002F\u002Fumami:كلمة_مرور_قوية@db:5432\u002Fumami\n```\n\n‏إذا كنت تستخدم متغيّر الاستيفاء (`${POSTGRES_PASSWORD}`)، تأكّد من أن Docker Compose يُحمّل ملف `.env` فعلًا.\n\n**‏2. توقّف Umami بعد 5 إلى 10 ثوانٍ من التشغيل — `depends_on` بدون `healthcheck`**\n\n‏بشكل افتراضي، لا ينتظر `depends_on: db` سوى **بدء** حاوية PostgreSQL، وليس **استعدادها لقبول الاتصالات**. يحاول Umami الاتصال بينما تزال PostgreSQL تُهيّئ ملفات بياناتها، فيفشل ويتوقّف.\n\n‏أضف `healthcheck` على خدمة `db` وشرطًا `condition: service_healthy` في `depends_on` الخاص بـ Umami:\n\n```\nservices:\n  db:\n    image: postgres:15-alpine\n    healthcheck:\n      test: [\"CMD-SHELL\", \"pg_isready -U umami\"]\n      interval: 10s\n      timeout: 5s\n      retries: 5\n  umami:\n    image: ghcr.io\u002Fumami-software\u002Fumami:postgresql-latest\n    depends_on:\n      db:\n        condition: service_healthy\n```\n\n‏بهذا الإعداد، لن يبدأ Umami إلا بعد أن يستجيب PostgreSQL على المنفذ الخاص به.\n\n**‏3. خطأ 502 بعد `docker compose pull` — تغيّر المنفذ المنشور**\n\n‏بعد التحديث (`docker compose pull` ثم `docker compose up -d`)، قد يُعيد nginx خطأ 502 إذا تغيّرت الإعدادات بين إصدارات الصورة: قد يُعاد تعيين المنفذ الداخلي أو يتغيّر ارتباط المضيف. تحقّق أولًا من الحالة الفعلية للحاويات:\n\n```\ndocker compose ps\n```\n\n‏انظر إلى عمود **PORTS** للتأكد من أن حاوية Umami تنشر على المنفذ المتوقع (3000 افتراضيًا). إذا تغيّر المنفذ، حدّث توجيه `proxy_pass` (أو `reverse_proxy`) في nginx أو Caddy ليعكس المنفذ الجديد، ثم أعد تحميل الخدمة (`nginx -s reload` أو `systemctl reload caddy`).\n\n**4. ‎`docker-compose` (v1) مقابل `docker compose` (v2) — صمت بدون رسالة خطأ**\n\nكثير من الأدلة المنشورة قبل ‎2025 تستخدم `docker-compose` (بشرطة)، وهو عميل ‎Python القديم غير المُصان. على تثبيت جديد لـ ‎Docker Engine، هذا الأمر غير موجود: يرجع الطرفية `command not found` ببساطة دون أن تشير إلى أن الإصدار ‎v2 يُسمّى `docker compose` (بمسافة). تحقق بـ `docker compose version` — إذا استجابت، فأنت تستخدم ‎v2. جميع الأمثلة في هذا الدليل تستخدم `docker compose` (v2).",{"type":54,"title":76,"steps":77},"تحديث Umami",[78,81,84,87,90],{"title":79,"body":80},"احتفظ بنسخة احتياطية من قاعدة البيانات","قبل أي تحديث: `docker compose exec db pg_dump -U umami umami > umami-backup-$(date +%F).sql`. احفظ الملف خارج وحدة ‎Docker — لن يُحفظ عند حذف الوحدة.",{"title":82,"body":83},"اسحب أحدث صورة","`docker compose pull`. تنشر ‎Umami إصداراتها على ‎GitHub (github.com\u002Fumami-software\u002Fumami\u002Freleases) — راجع ملاحظات الإصدار للترحيلات وتغييرات متغيرات البيئة.",{"title":85,"body":86},"أعد تشغيل الحاويات","`docker compose up -d`. تطبّق ‎Umami الترحيلات تلقائيًا. تحقق من السجلات: `docker compose logs -f app` وانتظر رسالة `Listening on port 3000`.",{"title":88,"body":89},"تحقق من الإصدار في الواجهة","الإعدادات ← حول. إذا لم يتغير الإصدار، ربما لم تُسحَب الصورة: `docker compose images` يعرض ملخّص كل صورة قيد التشغيل.",{"title":91,"body":92},"اختبر التتبع","افتح موقعًا متتبَّعًا في نافذة خاصة وانتظر 30 ثانية — يجب أن تُسجّل صفحة «الوقت الفعلي» الزيارة. الصفر الثابت بعد إعادة التشغيل يشير عادةً إلى مشكلة في سكريبت التتبع على الواجهة الأمامية.",{"type":94,"title":95,"body":96},"tip","‎Umami Cloud مقابل الاستضافة الذاتية","تقدم ‎Umami خططًا سحابية مُدارة (umami.is\u002Fpricing) بدءًا من ‎9 دولارات شهريًا للفرق التي لا تريد إدارة البنية التحتية. يُعدّ الاستضافة الذاتية على ‎VPS خيارًا مناسبًا إذا كان لديك بالفعل ‎VM، أو تديرعدة مواقع، أو إذا كانت سياسة بيانات مؤسستك تمنع إرسال البيانات إلى ‎SaaS خارجي — حتى الممتثل للائحة ‎RGPD. كلا الخيارين يتشاركان الكود المصدري والميزات وتنسيق التصدير.",{"type":94,"body":98},"‏غيّر كلمة مرور المسؤول الافتراضية عند أول تسجيل دخول، وانسخ قاعدة بيانات PostgreSQL احتياطيًا بانتظام: فهي التي تحتوي كامل سجلّ جمهورك.",{"type":94,"title":100,"body":101},"الوثائق الرسمية","‏للإعداد المتقدّم والخيارات الخاصة بالأداة، ارجع إلى \u003Ca href=\"https:\u002F\u002Fumami.is\u002Fdocs\" target=\"_blank\" rel=\"noopener noreferrer\">الوثائق الرسمية لـ Umami\u003C\u002Fa>. يغطّي هذا الدليل النشر على خادم VPS؛ وتبقى وثائق المُطوِّر المرجعَ للإعدادات الدقيقة والتحديثات الكبرى وحالات الاستخدام الخاصة.","انشر نسختك على خادم VPS Cloud من ServOrbit","يتيح لك خادم VPS Cloud من ServOrbit مع Docker مُهيَّأ مسبقًا وموارد قابلة للتوسّع تثبيت هذه الأداة دون عناء، وضبط ذاكرة RAM وعدد vCPU مع تزايد الاستخدام.","أطلق خادم VPS Cloud الخاص بي","\u002Fvps-cloud",[107,125,141],{"id":108,"slug":109,"slugs":110,"title":114,"excerpt":115,"readTime":116,"views":18,"isPinned":19,"noindex":19,"publishedAt":117,"updatedAt":118,"category":119,"categories":120,"featuredImage":29,"bgImage":30,"posterImage":122,"relatedSolution":123},153,"كيفية-استضافة-plausible-analytics-على-خادم-vps",{"fr":111,"en":112,"ar":109,"es":113},"heberger-plausible-vps","how-to-host-plausible-analytics-on-a-vps","como-alojar-plausible-analytics-en-un-vps","كيفية استضافة Plausible Analytics على خادم VPS","انشر Plausible Analytics على خادم VPS: تحليلات خفيفة، دون ملفات تعريف ارتباط، ومتوافقة مع اللائحة العامة لحماية البيانات، عبر Docker وClickHouse وHTTPS. دليل خطوة بخطوة.",2,"2026-01-24T00:00:00+00:00","2026-09-07T11:26:10+00:00",{"id":17,"name":23,"slug":24,"color":25,"icon":26},[121],{"id":17,"name":23,"slug":24,"color":25,"icon":26},"\u002Fblog\u002Fcovers\u002Fheberger-plausible-vps-poster.svg",{"categorySlug":33,"appSlug":124},"analytics-plausible",{"id":126,"slug":127,"slugs":128,"title":132,"excerpt":133,"readTime":116,"views":18,"isPinned":19,"noindex":19,"publishedAt":134,"updatedAt":118,"category":135,"categories":136,"featuredImage":29,"bgImage":30,"posterImage":138,"relatedSolution":139},154,"كيفية-استضافة-matomo-على-خادم-vps",{"fr":129,"en":130,"ar":127,"es":131},"heberger-matomo-vps","how-to-host-matomo-on-a-vps","como-alojar-matomo-en-un-vps","كيفية استضافة Matomo على خادم VPS","انشر Matomo على خادم VPS الخاص بك: بديل كامل عن Google Analytics، مع ملكية بياناتك بنسبة 100%، مستضاف ذاتيًا باستخدام Docker وHTTPS. دليل خطوة بخطوة.","2026-01-23T00:00:00+00:00",{"id":17,"name":23,"slug":24,"color":25,"icon":26},[137],{"id":17,"name":23,"slug":24,"color":25,"icon":26},"\u002Fblog\u002Fcovers\u002Fheberger-matomo-vps-poster.svg",{"categorySlug":33,"appSlug":140},"analytics-matomo",{"id":142,"slug":143,"slugs":144,"title":148,"excerpt":149,"readTime":150,"views":18,"isPinned":19,"noindex":19,"publishedAt":151,"updatedAt":152,"category":153,"categories":158,"featuredImage":29,"bgImage":30,"posterImage":160,"relatedSolution":161},97,"plausible-مقابل-umami-أي-أداة-تحليلات-مستضافة-ذاتيا-تختار",{"fr":145,"en":146,"ar":143,"es":147},"plausible-vs-umami","plausible-vs-umami-which-self-hosted-analytics-to-choose","plausible-vs-umami-que-analitica-self-hosted-elegir","Plausible مقابل Umami: أي أداة تحليل ذاتية الاستضافة تختار؟","مقارنة شاملة بين Plausible وUmami في 2026: التثبيت، الامتثال لـ GDPR، مسارات التحويل، واجهة برمجة الأحداث المخصصة، الانتقال من GA4، وشجرة القرار للاختيار الصحيح.",9,"2026-03-15T00:00:00+00:00","2026-11-08T01:13:15+00:00",{"id":154,"name":155,"slug":156,"color":157,"icon":156},5,"مقارنات","comparatif","bg-info\u002F10 text-info",[159],{"id":154,"name":155,"slug":156,"color":157,"icon":156},"\u002Fblog\u002Fcovers\u002Fplausible-vs-umami-poster.svg",{"categorySlug":33,"appSlug":124},true,1794270302682]