هل يدعم Gotenberg الخطوط المخصصة وCSS؟

نعم. يصيّر مسار Chromium HTML بمحرك متصفح كامل، لذا خطوط الويب وCSS وJavaScript والمحتوى المُشغَّل بـ JavaScript مدعومة بالكامل.

هل يمكنه تحويل ملفات Word أو Excel إلى PDF؟

نعم. يقبل مسار LibreOffice (POST /forms/libreoffice/convert) ملفات DOCX وXLSX وPPTX وODT وODS وODP وأكثر من 20 صيغة أخرى. LibreOffice مدمج في صورة gotenberg/gotenberg:8.

هل يحتفظ Gotenberg بالملفات المرفوعة؟

لا. Gotenberg خدمة بلا حالة. تُعالَج الملفات في الذاكرة أثناء الطلب ويُبثّ PDF مباشرةً إلى الاستجابة. لا شيء يُحفظ على القرص بعد اكتمال الاستجابة.

ما مقدار RAM المطلوب؟

في وضع الخمول، تستخدم حاوية Gotenberg أقل من 200 ميغابايت. أثناء تصيير Chromium النشط، توقع 300-500 ميغابايت لكل تحويل متزامن. خادم 1 غيغابايت يتعامل مع أعباء العمل الخفيفة؛ يُنصح بـ 2 غيغابايت لتوليد المستندات المستمر.

بدء مشروع برمجي بسرعة.

Gotenberg

واجهة API لتوليد PDF مستضافة ذاتيًا — HTML والروابط وLibreOffice إلى PDF في استدعاء REST واحد.

500 ميغابايت كحد أدنى (تصيير Chromium)، 1 غيغابايت موصى به ذاكرة عشوائية 1 vCPU متاح

Gotenberg (رخصة MIT، أكثر من 8 آلاف نجمة على GitHub) هو خدمة HTTP مصغّرة مبنية على Docker لتوليد PDF من HTML والروابط وMarkdown ومستندات Office (DOCX وXLSX وPPTX) عبر واجهة REST نظيفة. أنشئها على VPS واستبدل خدمات PDF المُحاسَبة لكل صفحة بتكلفة شهرية ثابتة. Chromium وLibreOffice مدمجان في الحاوية الواحدة — لا تبعيات إضافية. استخدمها لتوليد الفواتير والتقارير والعقود أو أي مستند من تطبيقاتك الخلفية.

الميزات الرئيسية

HTML إلى PDF عبر Chromium: دعم كامل لـ CSS وJavaScript وخطوط الويب.

رابط إلى PDF: التقط أي صفحة ويب من جهة الخادم — مفيد للتقارير والأرشفة.

تحويل LibreOffice: DOCX وXLSX وPPTX وODP والمزيد إلى PDF بدون Microsoft Office.

دمج PDF: اجمع ملفات PDF متعددة في مستند واحد باستدعاء واحد.

خدمة بلا حالة: بلا قاعدة بيانات وبلا طبقة مصادقة — أضف وكيلك العكسي أمامها.

رخصة MIT — بلا فوترة لكل صفحة أو مستند.

متى تستخدم هذا الحل؟

1

توليد الفواتير والعقود

صيّر قوالب HTML الخاصة بفواتيرك إلى PDF من جهة الخادم وأرسلها كمرفقات بريد أو خزّنها في S3. بلا فوترة لكل مستند وبلا وصول طرف ثالث إلى بياناتك المالية.

2

تصدير التقارير في منتجات SaaS

أضف زر 'تحميل كـ PDF' إلى لوحة التحكم. يرسل خادمك الخلفي تقرير HTML إلى Gotenberg ويبثّ PDF للمستخدم مباشرةً — بلا مكتبة frontend وبلا امتداد متصفح.

3

خط أنابيب تحويل صيغ المستندات

حوّل ملفات DOCX أو XLSX المرفوعة إلى PDF للأرشفة أو المعاينة أو سير عمل التوقيع. يتولى مسار LibreOffice في Gotenberg التحويل دون تثبيت Office على خادمك.

نشر Gotenberg على خادم VPS الخاص بك

دليل محسّن لخوادم VPS Cloud من ServOrbit.

01

النشر من السوق

افتح لوحة تحكم ServOrbit، اذهب إلى السوق ← التطوير ← Gotenberg، وانقر نشر. يسحب Docker صورة gotenberg/gotenberg:8 — تتضمن Chromium وLibreOffice — ويشغّل خادم HTTP على المنفذ 3000. الخدمة جاهزة في أقل من 30 ثانية.

02

إرسال أول طلب 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 كتدفق ثنائي.

03

تحويل رابط إلى PDF

لأخذ لقطة لصفحة ويب حية: ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/url' \ --form 'url=https://صفحة-تقريرك.com' \ -o report.pdf` مفيد لأرشفة مشاهدات لوحة التحكم وتوليد التقارير الأسبوعية والتقاط الإيصالات.

04

إضافة المصادقة

ليس لدى Gotenberg مصادقة مدمجة. احمِ الواجهة API بوضعها خلف وكيل عكسي (nginx) مع مصادقة HTTP basic أو بتقييد الوصول على شبكة داخلية فقط. النمط القياسي هو إبقاء المنفذ 3000 مرتبطًا بـ 127.0.0.1 واستدعاؤه من خادمك الخلفي.

الأسئلة الشائعة

نعم. Gotenberg بلا حالة وقابل للتوسع أفقيًا. حاوية واحدة تتعامل مع عشرات الطلبات المتزامنة؛ أضف المزيد من الحاويات خلف موزع أحمال لأعباء العمل عالية الإنتاجية.

إضافة زر النشر

هل تدير مشروعًا يستخدم Gotenberg؟ يتيح هذا الزر لقرّائك نشره على خادم VPS بنقرة واحدة، دون قراءة وثائق Docker.

Markdown

[![Deploy Gotenberg on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg)

HTML

<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 المباشر.