التطوير
Gotenberg
واجهة API لتوليد PDF مستضافة ذاتيًا — HTML والروابط وLibreOffice إلى PDF في استدعاء REST واحد.
حول Gotenberg
Gotenberg (رخصة MIT، أكثر من 8 آلاف نجمة على GitHub) هو خدمة HTTP مصغّرة مبنية على Docker لتوليد PDF من HTML والروابط وMarkdown ومستندات Office (DOCX وXLSX وPPTX) عبر واجهة REST نظيفة. أنشئها على VPS واستبدل خدمات PDF المُحاسَبة لكل صفحة بتكلفة شهرية ثابتة. Chromium وLibreOffice مدمجان في الحاوية الواحدة — لا تبعيات إضافية. استخدمها لتوليد الفواتير والتقارير والعقود أو أي مستند من تطبيقاتك الخلفية.
ما يُثبَّت
جاهز عند تشغيل الخادم
- أنظمة التشغيل المتوافقة
- Ubuntu 24.04
- التطبيق
- Gotenberg
- الحد الأدنى من RAM
- 500 ميغابايت كحد أدنى (تصيير Chromium)، 1 غيغابايت موصى به
- الحد الأدنى من CPU
- 1 vCPU
- الوصول
- root عبر SSH
الميزات الرئيسية
- HTML إلى PDF عبر Chromium: دعم كامل لـ CSS وJavaScript وخطوط الويب.
- رابط إلى PDF: التقط أي صفحة ويب من جهة الخادم — مفيد للتقارير والأرشفة.
- تحويل LibreOffice: DOCX وXLSX وPPTX وODP والمزيد إلى PDF بدون Microsoft Office.
- دمج PDF: اجمع ملفات PDF متعددة في مستند واحد باستدعاء واحد.
- خدمة بلا حالة: بلا قاعدة بيانات وبلا طبقة مصادقة — أضف وكيلك العكسي أمامها.
- رخصة MIT — بلا فوترة لكل صفحة أو مستند.
متى تستخدم هذا الحل؟
توليد الفواتير والعقود
صيّر قوالب HTML الخاصة بفواتيرك إلى PDF من جهة الخادم وأرسلها كمرفقات بريد أو خزّنها في S3. بلا فوترة لكل مستند وبلا وصول طرف ثالث إلى بياناتك المالية.
تصدير التقارير في منتجات SaaS
أضف زر 'تحميل كـ PDF' إلى لوحة التحكم. يرسل خادمك الخلفي تقرير HTML إلى Gotenberg ويبثّ PDF للمستخدم مباشرةً — بلا مكتبة frontend وبلا امتداد متصفح.
خط أنابيب تحويل صيغ المستندات
حوّل ملفات DOCX أو XLSX المرفوعة إلى PDF للأرشفة أو المعاينة أو سير عمل التوقيع. يتولى مسار LibreOffice في Gotenberg التحويل دون تثبيت Office على خادمك.
الدليل
نشر Gotenberg على خادم VPS الخاص بك
النشر من السوق
افتح لوحة تحكم ServOrbit، اذهب إلى السوق ← التطوير ← Gotenberg، وانقر نشر. يسحب Docker صورة gotenberg/gotenberg:8 — تتضمن Chromium وLibreOffice — ويشغّل خادم HTTP على المنفذ 3000. الخدمة جاهزة في أقل من 30 ثانية.
إرسال أول طلب HTML إلى PDF
من تطبيقك أو طرفية، أرسل HTML إلى مسار Chromium:
` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/html' \ --form '[email protected]' \ -o invoice.pdf` يصيّر Gotenberg الصفحة بنسخة Chromium كاملة ويعيد PDF كتدفق ثنائي.تحويل رابط إلى PDF
لأخذ لقطة لصفحة ويب حية:
` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/url' \ --form 'url=https://صفحة-تقريرك.com' \ -o report.pdf` مفيد لأرشفة مشاهدات لوحة التحكم وتوليد التقارير الأسبوعية والتقاط الإيصالات.إضافة المصادقة
ليس لدى Gotenberg مصادقة مدمجة. احمِ الواجهة API بوضعها خلف وكيل عكسي (nginx) مع مصادقة HTTP basic أو بتقييد الوصول على شبكة داخلية فقط. النمط القياسي هو إبقاء المنفذ 3000 مرتبطًا بـ 127.0.0.1 واستدعاؤه من خادمك الخلفي.
إضافة زر النشر
هل تدير مشروعًا يستخدم Gotenberg؟ يتيح هذا الزر لقرّائك نشره على خادم VPS بنقرة واحدة، دون قراءة وثائق Docker.
[](https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg)<a href="https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Gotenberg on ServOrbit" height="40"></a>يشير الزر إلى طلب خادم VPS مع تحديد القالب مسبقًا. تُقدَّم الصورة من servorbit.com — لا شيء تستضيفه من جهتك.
حلول تكميلية
Penpot
منصة التصميم مفتوحة المصدر والقابلة للاستضافة الذاتية — بديل Figma لفرق المنتج، مع التعاون في الوقت الفعلي والنمذجة التفاعلية وتصدير CSS المباشر.
التعاون والإنتاجيةStirling PDF
تطبيق PDF رقم 1 على GitHub (87 ألف نجمة، MIT): تحويل ودمج وتقسيم وضغط وOCR وعلامة مائية وأكثر من 50 عملية — كل شيء مستضاف ذاتيًا على خادمك، بدون أي تسريب للبيانات.
بحاجة إلى مساعدة؟
تصفّح مركز المساعدة والأسئلة الشائعة، أو تواصل مع فريقنا — معاودة اتصال أو WhatsApp أو بريد إلكتروني.
راسلنا على WhatsAppيُفتح في علامة تبويب جديدة