[{"data":1,"prerenderedAt":118},["ShallowReactive",2],{"seo-verification":3,"blog-استضافة-gotenberg-على-vps-واجهة-توليد-pdf-للمطورين-ar":6},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"id":7,"slug":8,"slugs":9,"title":12,"excerpt":13,"readTime":14,"views":15,"isPinned":16,"publishedAt":17,"category":18,"categories":23,"featuredImage":25,"bgImage":26,"posterImage":27,"relatedSolution":28,"intro":30,"sections":31,"ctaTitle":71,"ctaBody":72,"ctaButton":73,"ctaUrl":74,"relatedPosts":75},275,"استضافة-gotenberg-على-vps-واجهة-توليد-pdf-للمطورين",{"fr":10,"en":11,"ar":8},"heberger-gotenberg-vps","self-host-gotenberg-on-a-vps-pdf-generation-api-for-developers","استضافة Gotenberg على VPS: واجهة توليد PDF للمطورين","انشر Gotenberg على VPS للحصول على واجهة API لتوليد PDF مستضافة ذاتيًا — HTML والروابط ومستندات LibreOffice إلى PDF باستدعاء REST واحد. بدون فوترة لكل صفحة.",4,0,false,"2026-01-16T00:00:00+00:00",{"id":14,"name":19,"slug":20,"color":21,"icon":22},"التطوير","developpement","bg-warning\u002F10 text-warning","dev",[24],{"id":14,"name":19,"slug":20,"color":21,"icon":22},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fheberger-gotenberg-vps-poster.svg",{"categorySlug":19,"appSlug":29},"gotenberg","كل خدمة PDF كـ SaaS تُحاسب لكل صفحة أو مستند. Gotenberg لا تفعل ذلك — إنها خدمة HTTP مصغّرة مفتوحة المصدر برخصة MIT تُولّد PDF من HTML والروابط وMarkdown ومستندات LibreOffice، مع تضمين Chromium وLibreOffice في حاوية Docker واحدة. إليك كيفية نشرها على VPS في دقائق.",[32,36,46,49,68],{"type":33,"title":34,"body":35},"h2","لماذا استضافة واجهة API لتوليد PDF ذاتيًا؟","خدمات PDF كـ SaaS تُحاسب لكل مستند أو صفحة أو استدعاء API. بمجرد أن يُولّد تطبيقك فواتير أو تقارير أو عقودًا بكميات كبيرة، تنمو التكلفة خطيًا مع استخدامك. Gotenberg تستبدلها بتكلفة VPS شهرية ثابتة بصرف النظر عن عدد PDF التي تُولّدها. كما تبقي مستنداتك خاصة: لا شيء يغادر بنيتك التحتية أثناء التحويل.",{"type":37,"title":38,"items":39},"ul","ما يمكن لـ Gotenberg تحويله",[40,41,42,43,44,45],"HTML إلى PDF عبر نسخة Chromium كاملة — CSS وخطوط الويب وJavaScript واستفسارات وسائط الطباعة مُكرَّمة جميعها.","أي رابط إلى PDF — أرشف مشاهدات لوحة التحكم وأنشئ تقارير أسبوعية أو التقط إيصالات الدفع.","مستندات LibreOffice (DOCX وXLSX وPPTX وODT وODS وODP وأكثر من 20 صيغة) إلى PDF بدون تثبيت Microsoft Office.","Markdown إلى PDF عبر مسار Chromium مع CSS قابل للتهيئة.","دمج عدة ملفات PDF في ملف واحد باستدعاء API واحد.","الصور (PNG وJPEG وWebP وTIFF) محوَّلة إلى PDF.",{"type":33,"title":47,"body":48},"المتطلبات","خادم VPS بـ1 vCPU على الأقل و1 غيغابايت RAM (يُنصح بـ2 غيغابايت لتصيير Chromium المتزامن). Ubuntu 22.04 أو 24.04 مع Docker مثبَّت. لا يلزم نطاق — يمكنك استدعاء الواجهة API على `http:\u002F\u002F127.0.0.1:3000` من تطبيقك الخلفي على نفس الخادم.",{"type":50,"title":51,"steps":52},"steps","نشر Gotenberg خطوة بخطوة",[53,56,59,62,65],{"title":54,"body":55},"إنشاء ملف compose","اتصل بـVPS عبر SSH وأنشئ مجلدًا:\n```\nmkdir gotenberg && cd gotenberg\n```\nأنشئ `docker-compose.yml` مع خدمة gotenberg مرتبطة بـ 127.0.0.1:3000.",{"title":57,"body":58},"تشغيل الحاوية","شغّل `docker compose up -d`. يسحب Gotenberg الصورة (~1.5 غيغابايت، تشمل Chromium وLibreOffice) ويشغّل خادم HTTP. تحقق من نقطة نهاية الصحة:\n```\ncurl http:\u002F\u002F127.0.0.1:3000\u002Fhealth\n```\nاستجابة `{\"status\":\"up\"}` تؤكد أن الخدمة جاهزة.",{"title":60,"body":61},"توليد أول PDF من HTML","أنشئ ملف HTML بسيطًا (`invoice.html`) وحوّله:\n```\ncurl -s --request POST http:\u002F\u002F127.0.0.1:3000\u002Fforms\u002Fchromium\u002Fconvert\u002Fhtml \\\n  --form 'index.html=@invoice.html' \\\n  -o invoice.pdf\n```\nالاستجابة هي PDF كتدفق ثنائي.",{"title":63,"body":64},"تحويل مستند Word إلى PDF","ارفع ملف DOCX إلى مسار LibreOffice:\n```\ncurl -s --request POST http:\u002F\u002F127.0.0.1:3000\u002Fforms\u002Flibreoffice\u002Fconvert \\\n  --form 'files=@contract.docx' \\\n  -o contract.pdf\n```",{"title":66,"body":67},"إضافة المصادقة (مستحسن)","ليس لدى Gotenberg مصادقة مدمجة. النهج المستحسن: ثبّت nginx، أنشئ وكيلًا عكسيًا من `https:\u002F\u002Fgotenberg.your-domain.com` إلى `http:\u002F\u002F127.0.0.1:3000`، وأضف مصادقة HTTP basic.",{"type":33,"title":69,"body":70},"التكامل مع تطبيقك","Gotenberg محايد للغة — أي عميل HTTP يعمل. توجد مكتبات لـ PHP وNode.js وPython وGo وغيرها. لـ Laravel توجد حزمة رسمية تُغلّف الواجهة API. في Node.js يمكنك استدعاؤها بـ axios أو fetch الأصلية بإرسال كائن FormData مع محتوى HTML أو الملف.","انشر Gotenberg على VPS Cloud من ServOrbit في دقائق","مع VPS Cloud من ServOrbit تحصل على Docker مُهيأ مسبقًا وRAM قابلة للتوسع — القاعدة الصحيحة لـ Gotenberg للتعامل مع تصيير Chromium وتحويل LibreOffice بدون تنازع على الموارد.","أطلق VPS الخاص بي","\u002Fmarketplace\u002Fالتطوير\u002Fgotenberg",[76,98],{"id":77,"slug":78,"slugs":79,"title":82,"excerpt":83,"readTime":84,"views":15,"isPinned":16,"publishedAt":85,"category":86,"categories":92,"featuredImage":25,"bgImage":26,"posterImage":94,"relatedSolution":95},178,"استضافة-stirling-pdf-على-vps-أكثر-من-50-عملية-بلا-سحابة",{"fr":80,"en":81,"ar":78},"self-host-stirling-pdf-vps","self-host-stirling-pdf-on-a-vps-50-pdf-operations-no-cloud","استضافة Stirling PDF على VPS: أكثر من 50 عملية بلا سحابة","استضف Stirling PDF ذاتيًا على خادم VPS — تطبيق PDF رقم 1 على GitHub (87 ألف نجمة، MIT). دمج وتقسيم وضغط وتحويل وOCR وأكثر من 50 عملية. بلا رفع سحابي، بلا اشتراك.",6,"2026-07-13T00:00:00+00:00",{"id":87,"name":88,"slug":89,"color":90,"icon":91},7,"الاستضافة الذاتية","self-hosting","bg-indigo-500\u002F10 text-indigo-400","cloud",[93],{"id":87,"name":88,"slug":89,"color":90,"icon":91},"\u002Fblog\u002Fcovers\u002Fself-host-stirling-pdf-vps-poster.svg",{"categorySlug":96,"appSlug":97},"التعاون-والإنتاجية","stirling-pdf",{"id":99,"slug":100,"slugs":101,"title":104,"excerpt":105,"readTime":14,"views":15,"isPinned":16,"publishedAt":106,"category":107,"categories":112,"featuredImage":25,"bgImage":26,"posterImage":114,"relatedSolution":115},61,"استضافة-appwrite-على-خادم-vps",{"fr":102,"en":103,"ar":100},"heberger-appwrite-vps","hosting-appwrite-on-a-vps","استضافة Appwrite على خادم VPS","استضِف Appwrite ذاتيًا على خادم VPS السحابي الخاص بك: خلفية BaaS كاملة في Docker لتطبيقات الويب والجوال، مقارنةً بـ Supabase.","2026-04-20T00:00:00+00:00",{"id":84,"name":108,"slug":109,"color":110,"icon":111},"قواعد البيانات","bases-de-donnees","bg-teal-500\u002F10 text-teal-400","database",[113],{"id":84,"name":108,"slug":109,"color":110,"icon":111},"\u002Fblog\u002Fcovers\u002Fheberger-appwrite-vps-poster.svg",{"categorySlug":116,"appSlug":117},"قواعد-البيانات","appwrite",1787580937609]