🛠️ تثبيت Documenso — توقيع مستندات ذاتي الاستضافة
انشر Documenso على Ubuntu بـ Docker — بديل DocuSign مفتوح المصدر لإرسال وتوقيع المستندات رقمياً على سيرفرك الخاص، مدعوم بـ PostgreSQL، على المنفذ 3062.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/documenso/documenso-ubuntu.sh
chmod +x documenso-ubuntu.sh
./documenso-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/documenso/documenso-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x documenso-ubuntu.sh
3 تشغيل المثبّت
./documenso-ubuntu.sh
4 التسجيل وإنشاء حسابك
http://your-server-ip:3062
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3062 | Documenso web interface (mapped from container port 3000) |
| 5432 | PostgreSQL — internal to the Docker network, not exposed to the host |
نظرة عامة
Documenso منصة توقيع إلكتروني مفتوحة المصدر تُصدر برخصة AGPL — بديل قابل للاستضافة الذاتية لـ DocuSign وAdobe Sign. مبنية على بنية تقنية حديثة بـ TypeScript تضم Next.js وPostgreSQL وPrisma، تتيح لك رفع ملف PDF ووضع حقول التوقيع والنموذج عليه، وإرساله لمستلم واحد أو أكثر، واستعادة مستندات موقّعة رقمياً وملزمة قانونياً — كل ذلك على بنية تحتية تتحكم بها أنت، دون رسوم لكل مستند أو مغلف.
لماذا تستخدمه
خدمات التوقيع الإلكتروني التجارية تفرض رسوماً لكل مغلف أو مستخدم وتتطلب مرور كل مستند موقّع عبر سيرفرات طرف ثالث، وهو أمر غير مقبول للعقود أو أوراق الموارد البشرية أو الاتفاقيات التي تحتوي معلومات حساسة. يمنحك Documenso نفس سير عمل التوقيع الأساسي — الرفع، وضع الحقول، الإرسال، التوقيع، تنزيل PDF المكتمل — بالكامل على سيرفرك الخاص، تحت نطاقك الخاص، مع API عام لدمج التوقيع في تطبيقاتك الخاصة. ولأنه مفتوح المصدر، يمكنك أيضاً تدقيق كيفية توليد التوقيعات والتحقق منها بدلاً من الثقة بمنتج SaaS مغلق.
متى تحتاجه
- تحتاج إرسال عقود أو اتفاقيات أو أوراق موارد بشرية للتوقيع الإلكتروني دون دفع رسوم SaaS لكل مغلف
- مستنداتك تحتوي معلومات حساسة أو منظمة لا ينبغي أن تمر عبر سيرفرات مزوّد توقيع إلكتروني خارجي
- تريد تضمين سير عمل توقيع المستندات مباشرة داخل تطبيقك الخاص عبر API
- تحتاج توقيعاً متعدد الأطراف حيث يوقّع عدة مستلمين نفس المستند بترتيب متسلسل أو متوازٍ
- تريد تحكماً كاملاً وقابلية تدقيق في كيفية توليد التوقيعات وتخزينها والتحقق منها
- مؤسستك لديها متطلبات امتثال تجعل استضافة بنية التوقيع ذاتياً أفضل من منتج SaaS سحابي
من يحتاجه
- الشركات الصغيرة والمستقلون الذين يحتاجون توقيع عقود بانتظام دون تكاليف متكررة لكل مغلف
- فرق الموارد البشرية التي تجمع خطابات عروض موقّعة واتفاقيات عدم إفصاح وأوراق تعريف موظفين جدد داخلياً
- الفرق القانونية والتشغيلية التي تحتاج تحكماً كاملاً في مكان تخزين بيانات المستندات الموقّعة
- المطورون الذين يدمجون سير عمل توقيع المستندات في منتجهم الخاص عبر API الخاص بـ Documenso
- المؤسسات المهتمة بالخصوصية التي لا تريد توجيه العقود الموقّعة عبر سحابة طرف ثالث
- هواة الاستضافة الذاتية الذين يوحّدون أدوات الأعمال — المستندات والملفات والتواصل — على بنيتهم التحتية الخاصة
حالات الاستخدام الشائعة
- إرسال عقود المبيعات واتفاقيات الخدمة للعملاء للتوقيع الرقمي
- جمع اتفاقيات عدم الإفصاح الموقّعة وخطابات العروض ونماذج تعريف الموظفين الجدد
- توجيه اتفاقيات متعددة الأطراف عبر عدة موقّعين بترتيب توقيع محدد
- تضمين سير عمل توقيع داخل تطبيق داخلي أو بوابة عملاء عبر API
- الاحتفاظ بسجل تدقيق كامل لمن وقّع ماذا ومتى لأغراض الامتثال
- استبدال اشتراك DocuSign أو Adobe Sign المدفوع ببديل ذاتي الاستضافة واستخدام غير محدود
الميزات الرئيسية
- رفع أي ملف PDF ووضع حقول توقيع وأحرف أولى وتاريخ ونص وخانات اختيار في أي مكان على الصفحة
- توقيع متعدد الأطراف مع ترتيب توقيع قابل للتهيئة وتعيين حقول لكل مستلم
- قوالب مستندات قابلة لإعادة الاستخدام للعقود التي ترسلها بشكل متكرر
- REST API عام وwebhooks لدمج التوقيع في تطبيقاتك وسير عمل مؤسستك
- سجل تدقيق كامل يسجّل كل مشاهدة ووضع حقل وحدث توقيع على المستند
- مخرجات PDF موقّعة رقمياً ومقاومة للتلاعب باستخدام توقيعات معتمدة على شهادات بمعيار PAdES
- إشعارات بريد إلكتروني للمستلمين عندما يكون المستند جاهزاً للتوقيع أو مكتملاً
- دعم العلامة البيضاء (white-labeling) بحيث تحمل بوابة التوقيع هويتك الخاصة بدلاً من هوية Documenso
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:3062 وسجّل — لا يوجد حساب مسؤول افتراضي، أول مستخدم يسجّل يصبح المالك
- اضبط إعدادات SMTP في إعدادات الحساب أو المؤسسة حتى تُرسل دعوات التوقيع فعلياً للمستلمين عبر البريد
- ارفع ملف PDF وضع حقول التوقيع والتاريخ والنص حيث يحتاج كل مستلم للتفاعل
- أضف المستلمين بالبريد الإلكتروني وحدد ترتيب التوقيع إذا كان المستند يتطلب توقيعات متسلسلة
- أرسل المستند وتابع حالته — تمت المشاهدة، قيد التنفيذ، أو مكتمل — من لوحة التحكم
- نزّل PDF الموقّع رقمياً والمكتمل بمجرد انتهاء جميع المستلمين من التوقيع
- استبدل شهادة التوقيع ذاتية التوقيع المولّدة عند التثبيت بشهادة من جهة موثوقة إذا احتاج أطراف خارجيون التحقق من التوقيعات باستقلالية
- ولّد مفتاح API من الإعدادات إذا كنت تخطط لتشغيل سير عمل التوقيع برمجياً من تطبيقك الخاص
أفضل ممارسات الأمان
- لا تكشف المنفذ 3062 للإنترنت دون HTTPS — وإلا ستنتقل المستندات الموقّعة وبيانات اعتماد الحساب عبر HTTP عادي
- ضع Documenso خلف وكيل عكسي مثل Nginx Proxy Manager بشهادة TLS صالحة لأي وصول خارجي
- استبدل شهادة التوقيع ذاتية التوقيع المولّدة تلقائياً بشهادة من جهة إصدار معترف بها إذا وجب التحقق من التوقيعات باستقلالية من أطراف خارجية
- أبقِ قاعدة بيانات PostgreSQL على شبكة Docker الداخلية فقط — يجب ألا تُكشف على المضيف أو الإنترنت أبداً
- اضبط SMTP بمصادقة صحيحة، ويُفضّل بنطاق إرسال مخصص، لتجنب تصنيف دعوات التوقيع كبريد مزعج أو منتحل
- قيّد من يستطيع تسجيل حساب إذا لم يكن المثيل مخصصاً للعامة — أول تسجيل يصبح المالك بصلاحيات كاملة
- انسخ مفاتيح التشفير المولّدة عند التثبيت احتياطياً — فقدانها قد يجعل البيانات الموقّعة أو المشفّرة سابقاً غير قابلة للاستعادة
- حافظ على تحديث صورة Documenso للحصول على تصحيحات الأمان، فهو برنامج نشط التطوير يتعامل مع مستندات ذات أهمية قانونية
المنافذ وإعدادات جدار الحماية
يربط هذا النشر المنفذ المضيف 3062 بمنفذ حاوية Documenso رقم 3000 لواجهة الويب وAPI. يستمع PostgreSQL على منفذه الافتراضي 5432 لكنه يبقى داخلياً ضمن شبكة Docker — لا يُنشر على المضيف ولا يمكن الوصول إليه من خارج شبكة الحاويات، وهذا هو الوضع الصحيح ويجب عدم تغييره. يجب أن يقع المنفذ 3062 خلف وكيل عكسي يوفر HTTPS قبل وصول أي مستخدمين خارجيين، وإلا ستنتقل بيانات تسجيل الدخول والمستندات الموقّعة المكتملة بدون تشفير. احجب المضيف بجدار الحماية بحيث لا يُوصل إلى المنفذ 3062 إلا عبر الوكيل العكسي أو VPN، ولا يُفتح مباشرة للإنترنت العام أبداً.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات PostgreSQL احتياطياً — فهي تحتوي كل حساب ومستند ووضع حقل وسجل توقيع، مما يجعلها أهم قطعة بيانات يجب حمايتها
- انسخ مفاتيح التشفير المولّدة أثناء التثبيت احتياطياً، فقد تكون مطلوبة لفك تشفير أو التحقق من مستندات موقّعة سابقاً
- انسخ docker-compose.yml وأي ملفات متغيرات بيئة احتياطياً لتتمكن من إعادة إنشاء نفس النشر بالضبط على مضيف جديد
- جدول نسخاً احتياطية آلية منتظمة لقاعدة البيانات (pg_dump) بدلاً من الاعتماد على نسخ يدوية قبل التحديثات
- خزّن النسخ الاحتياطية بعيداً عن المضيف نفسه — قاعدة بيانات منصة توقيع هي بالضبط نوع البيانات التي يجب أن تنجو من فقدان السيرفر
- اختبر استعادة نسخة احتياطية من قاعدة البيانات على مثيل منفصل دورياً للتأكد أن عملية النسخ الاحتياطي تعمل فعلياً
- وثّق إعدادات SMTP وشهادة التوقيع بشكل منفصل، فمن السهل نسيانها عند إعادة البناء من نسخة قاعدة بيانات احتياطية فقط
الأخطاء الشائعة
- عدم إعداد SMTP إطلاقاً ثم التساؤل عن سبب عدم استلام المستلمين دعوات التوقيع — Documenso يوصل روابط التوقيع حصرياً عبر البريد الإلكتروني
- كشف المنفذ 3062 مباشرة للإنترنت دون وكيل عكسي وTLS
- افتراض أن شهادة التوقيع ذاتية التوقيع المولّدة عند التثبيت مناسبة لمستندات يحتاج أطراف خارجيون التحقق منها — وهي ليست كذلك دون استبدال
- ترك المثيل مفتوحاً للتسجيل العام بينما يجب أن يقتصر على مؤسستك، لأن أول مستخدم يصبح مالك الحساب
- عدم نسخ قاعدة بيانات PostgreSQL احتياطياً قبل التحديثات، مما يعرّض كل مستند مُرسَل وموقّع لخطر الفقدان
- نشر منفذ PostgreSQL على المضيف اعتقاداً أنه ضروري — يجب أن يبقى داخلياً ضمن شبكة Docker فقط
- افتراض أن توقيعاً ذاتي الاستضافة ملزم قانونياً تلقائياً مثل DocuSign في كل الولايات القضائية دون التحقق من لوائح التوقيع الإلكتروني المحلية
استكشاف الأخطاء وإصلاحها
- دعوات التوقيع لا تصل أبداً — تحقق من ضبط إعدادات SMTP واختبرها بحساب بريد يعمل فعلياً، فهذا النشر يأتي دون إعداد بريد افتراضي
- تعذر تسجيل الدخول بعد التثبيت — لا يوجد حساب مسؤول افتراضي؛ اذهب إلى http://your-server-ip:3062 وسجّل الحساب الأول الذي يصبح المالك
- فشل التحقق من التوقيع لمستلمين خارجيين — الشهادة ذاتية التوقيع الافتراضية غير موثوقة خارج مثيلك؛ استبدلها بشهادة من جهة معترف بها
- أخطاء اتصال بقاعدة البيانات عند بدء التشغيل — تأكد أن حاوية PostgreSQL سليمة وأن متغير DATABASE_URL يطابق اسم مضيف ومنفذ الحاوية الداخلي
- ملفات PDF المرفوعة تفشل في عرض الحقول بشكل صحيح — ملفات PDF الكبيرة جداً أو ذات البنية غير المعتادة قد تسبب أحياناً مشاكل عرض؛ جرب ملفاً تجريبياً أصغر لعزل المشكلة
- حاوية Documenso لا تبدأ بعد تحديث — راجع docker logs بحثاً عن أخطاء ترحيل، فترحيلات مخطط قاعدة البيانات يجب أن تكتمل بنجاح عند بدء التشغيل
- الرسائل تُصنَّف كبريد مزعج — اضبط سجلات SPF وDKIM وDMARC لنطاق الإرسال الخاص بك بالإضافة لإعدادات SMTP الأساسية
البدائل
DocuSeal هو أقرب منافس مباشر ويُعتبر حالياً، حسب معظم المقارنات، منصة التوقيع ذاتية الاستضافة مفتوحة المصدر الأكثر اكتمالاً بالميزات، مع مكونات توقيع مضمّن قوية لبناء التوقيع مباشرة داخل منتجك الخاص. OpenSign خيار آخر مجاني تماماً ومفتوح المصدر بمجموعة ميزات أبسط يجدها بعض المستخدمين أقل صقلاً واستقراراً من Documenso أو DocuSeal. على الجانب التجاري، يبقى DocuSign وAdobe Sign رائدي السوق بأوسع مجموعة ميزات مؤسسية وتكاملات واعتراف قانوني، لكن كليهما يفرض رسوماً لكل مستخدم أو مغلف ويخزّن مستنداتك على بنيته التحتية. PandaDoc وDropbox Sign (المعروف سابقاً بـ HelloSign) يقعان في المنتصف، ويقدمان تجارب مستضافة مصقولة بسعر أقل من DocuSign. لمنصة حديثة ذاتية الاستضافة بواجهة نظيفة وAPI عام، Documenso خيار قوي — جرّبه إلى جانب DocuSeal لأن كليهما مجاني للاستضافة الذاتية، وغالباً ما يعتمد الاختيار الصحيح على الواجهة وسير العمل الذي يفضّله فريقك.
متى لا تستخدمه
إذا احتجت أوسع مجموعة ميزات مؤسسية ممكنة — أتمتة سير عمل متقدمة، وتكاملات عميقة مع عشرات أدوات الأعمال، واعتراف قانوني مضمون عبر كل الولايات القضائية — فمنصة تجارية راسخة مثل DocuSign أو Adobe Sign خيار أكثر أماناً من أي أداة ذاتية الاستضافة. إذا كنت لا تريد إدارة سيرفر أو نسخ احتياطية لقاعدة البيانات أو إعداد SMTP بنفسك، فإن منتج توقيع إلكتروني SaaS مستضاف يزيل هذا العبء التشغيلي تماماً. إذا كان حجم توقيعك منخفضاً جداً — بضعة مستندات في السنة — فقد تكون الخطط المجانية للمزودين المستضافين أبسط من تشغيل خدمتك الخاصة المدعومة بـ PostgreSQL. وإذا كان تضمين أداة توقيع مباشرة داخل منتجك الخاص هو الهدف الأساسي، فقد تناسب أدوات DocuSeal المركّزة على التضمين هذه الحالة الاستخدامية تحديداً بشكل أفضل من Documenso افتراضياً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Documenso؟
Documenso منصة توقيع إلكتروني مفتوحة المصدر — بديل ذاتي الاستضافة لـ DocuSign. ترفع مستنداً، تضع حقول التوقيع وغيرها، وترسله للأشخاص للتوقيع في متصفحهم، وتستعيد PDF مكتملاً.
ما المنفذ الذي يستخدمه وكيف أسجّل الدخول؟
يعمل Documenso على المنفذ المضيف 3062، المعيَّن من منفذ الحاوية 3000. لا يوجد حساب مسؤول افتراضي — تسجّل عند أول زيارة لإنشاء حسابك الخاص. افتح http://your-server:3062 وسجّل.
لماذا لا تُرسَل دعوات التوقيع بالبريد؟
لأن هذا النشر لا يضبط SMTP. يوصل Documenso روابط التوقيع للمستلمين عبر البريد الإلكتروني، لذا حتى تضيف إعدادات بريد فعّالة، لن تُرسل الدعوات ولن يتمكن المستلمون من الوصول لمستنداتهم.
هل شهادة التوقيع جاهزة للإنتاج؟
ليست كذلك كما تُشحن. يولّد المثبّت شهادة ذاتية التوقيع، وهي مثالية لعرض واختبار سير عمل التوقيع لكنها غير صادرة عن جهة معترف بها. للتوقيعات التي يحتاج أطراف خارجيون الثقة بها والتحقق منها، يجب استبدالها بشهادة مناسبة.
كيف يُقارَن بـ DocuSeal؟
DocuSeal هو أقرب بديل ذاتي الاستضافة، ويغطي نفس مجال توقيع المستندات مفتوح المصدر. الاثنان منافسان مباشران، لذا النهج المنطقي هو تجربة كليهما ومعرفة أي واجهة وسير عمل توقيع تفضّله.