دليل التثبيت المحلي (On-prem)

ثبّت Mobilteg Saha على خادمك الخاص

يثبّت برنامج التثبيت ذو الملف الواحد على خادم Windows لديك التطبيقَ وخدمة Windows وPostgreSQL (أو يستخدم خادمك الحالي إن شئت)، ويضيف قاعدة جدار الحماية ويفعّل الترخيص. بعد التثبيت تتصل لوحة الويب والتطبيق الميداني بهذا الخادم.

تنزيل حزمة التثبيتجرّب مجانًا لمدة 7 يومًا

متطلبات النظام

يتحقق برنامج التثبيت من هذه المتطلبات بنفسه في الخطوة الأولى؛ ويمكنك أيضًا رؤيتها دون كتابة أي شيء عبر «افحص أولًا».

Windows Server 2019 / Windows 10 بنظام 64 بت (الإصدار 1809، البنية 17763) أو أحدث.
تشغيل برنامج التثبيت بصلاحيات المسؤول.
مساحة فارغة لا تقل عن 4 GB على محرك أقراص مجلدات البرنامج والبيانات.
منافذ متاحة: HTTPS العام (الافتراضي 443) وHTTP اختياري (80)؛ وداخل الخادم: API على 3001 وHost على 47801 وPostgreSQL المضمّن في الحزمة (الافتراضي 5433). إذا كان أحد المنافذ مشغولًا (مثل IIS) ينبّهك الفحص المسبق.
لـ HTTPS: شهادة خادم سارية الصلاحية ولها مفتاح خاص في مخزن LocalMachine\My. وإن لم تتوفر: HTTP غير مشفّر فقط في شبكة محلية معزولة عن الإنترنت مع تأكيد التحذير.
قاعدة البيانات: PostgreSQL 16 المضمّن في الحزمة (يثبّته برنامج التثبيت) أو خادم PostgreSQL موجود يُتصل به بمستخدم فائق (اختُبر مع الإصدار 16؛ ويظهر تحذير مع الإصدارات الأقدم).
حزمة Microsoft Visual C++ 2015–2022 (x64) القابلة لإعادة التوزيع لأجل PostgreSQL المضمّن؛ وإن كانت مفقودة تنبّه خطوة PostgreSQL إلى ذلك.
اتصال بالإنترنت إلى خادم التراخيص في خطوة التفعيل؛ إذ لا يتحوّل الرمز التجريبي إلى ترخيص إلا عبر هذا الاتصال. في التثبيت بمفتاح الترخيص دون إنترنت يكتمل التثبيت مع ذلك، ويتم التفعيل من اللوحة بملف تفعيل دون اتصال.

التثبيت خطوة بخطوة

انقر على الصورة لفتحها بالحجم الكامل.

1
نوع التثبيت
يطلب برنامج التثبيت صلاحيات المسؤول عند فتحه. في الشاشة الأولى يُختار «تثبيت جديد (بمفتاح الترخيص)» أو «تثبيت تجريبي (برمز تجريبي، 7 يومًا)».
لا يمكن اختيار «تحديث»: يحدّث النظام المثبّت نفسه من لوحة الويب. وإذا كان على الخادم تثبيت لم يكتمل، يقترح البرنامج أولًا متابعته أو التراجع عنه.
2
الترخيص
في التثبيت الجديد يُدخَل مفتاح الترخيص بصيغة MBTS-XXXX-XXXX-XXXX-XXXX، وفي التجريبي يُدخَل الرمز التجريبي والبريد الإلكتروني الذي كتبته في طلب النسخة التجريبية.
يُتحقَّق في هذه الشاشة من صيغة المفتاح فقط. يُتحقَّق من المفتاح لدى خادم التراخيص في خطوة التفعيل بعد تثبيت النظام وتشغيله؛ وإذا رُفض تذكر تلك الخطوة السبب، فتصحّحه وتتابع. لا تغيّر حقل «خادم التراخيص».
3
العميل والشركة
يُدخَل اسم المؤسسة والاسم المختصر واسم الشركة الأولى. يُقترح الاسم المختصر من الاسم، ويُكتب عند الدخول كرمز المؤسسة (أحرف صغيرة وأرقام وشرطة).
الشركة الأولى هي الكيان القانوني الذي تصدر باسمه الفواتير؛ ويمكن تعديل الشركات لاحقًا من لوحة الويب.
4
العنوان وHTTPS
يُحدَّد الاسم الذي سيكتبه المستخدمون في المتصفح وتطبيق الجوال (مثل saha.firma.local أو 192.168.1.20)، ومنفذ HTTPS، والشهادة من مخزن LocalMachine\My. لا يمكن اختيار شهادة منتهية الصلاحية؛ وتُميَّز الشهادة التي بقي على انتهائها أقل من 30 يومًا أو التي لا تغطي العنوان.
يمكن أيضًا فتح منفذ HTTP إن رغبت، ليعيد التوجيه إلى HTTPS. ولا يتقدّم خيار «HTTP غير مشفّر فقط» دون شهادة إلا بعد تأكيد تحذير أمني صريح.
5
قاعدة البيانات
الموصى به: يُثبَّت PostgreSQL 16 المضمّن في الحزمة على هذا الخادم (مجلد البرنامج والبيانات والمنفذ؛ الافتراضي 5433). تُولَّد كلمة مرور المستخدم الفائق عشوائيًا وتُحفظ محمية بـ DPAPI؛ ولا يستمع الخادم إلا على 127.0.0.1.
يمكن أيضًا استخدام خادم PostgreSQL موجود: يُدخَل الخادم والمنفذ والمستخدم الفائق وكلمة المرور واسم قاعدة البيانات، ولا يمكن المتابعة قبل نجاح «اختبار الاتصال». لا تُكتب كلمة المرور في أي مكان.
6
المسؤول الأول
يُدخَل الاسم الكامل والبريد الإلكتروني (اسم الدخول) وكلمة المرور. يجب ألا تقل كلمة المرور عن 8 أحرف وأن تحتوي على ثلاثة على الأقل من: حرف كبير، حرف صغير، رقم، رمز؛ ولا تُقبل كلمات المرور الشائعة. يُتحقَّق من القاعدة أثناء الكتابة.
لا تُكتب كلمة المرور في أي ملف أو سجل أو تقرير.
7
الأمان
تُضاف في جدار حماية Windows قاعدة للمنفذ العام فقط (HTTPS/HTTP)؛ ويُختار ملف التعريف. لا تُفتح منافذ API (3001) والمنفذ المحلي لـ Host (47801) وPostgreSQL، بل تستمع على 127.0.0.1 فقط.
يمكن تغيير مجلد البرنامج هنا. تعمل الخدمة بحساب NT SERVICE\MobiltegSahaHost وليس بحساب LocalSystem.
8
الملخص
تظهر جميع الخيارات في شاشة واحدة. يشغّل «افحص أولًا» الفحوص المسبقة دون كتابة أي شيء؛ وإن لم توجد مشكلة يبدأ التثبيت بـ «تثبيت».
9
التثبيت
تُنفَّذ الخطوات بالترتيب: المتطلبات المسبقة، الملفات والتحقق بـ SHA-256، الإعداد، PostgreSQL، قاعدة البيانات والمخطط، الشركة والمسؤول، خدمة Windows، الأذونات، جدار الحماية، التشغيل، فحص السلامة، تفعيل الترخيص وتقرير التثبيت.
تُسجَّل كل خطوة. إذا توقّف التثبيت في منتصفه، يتابع البرنامج من حيث توقّف عند إعادة فتحه، أو يزيل عبر «تراجع» ما أنشأه هذا التثبيت فقط؛ وتُترك قاعدة البيانات التي تحتوي على بيانات.
10
اكتمل التثبيت
تعرض الشاشة الأخيرة عنوان لوحة الويب، وعنوان الخادم الذي يُكتب في تطبيق الجوال (…/api)، وبيانات الدخول (بريد المسؤول ورمز المؤسسة)، وموقع تقرير التثبيت؛ وتُدرج هنا التحذيرات إن وُجدت.
تدخل إلى اللوحة عبر «فتح اللوحة». في التثبيت بمفتاح الترخيص، إذا تعذّر الوصول إلى خادم التراخيص في تلك اللحظة يكتمل التثبيت مع ذلك، وتفعّل المفتاح لاحقًا من اللوحة.

بعد التثبيت

الإعدادات ← الترخيص والتثبيت

تظهر هنا حالة الترخيص ونوعه وباقته وتاريخ انتهائه وانتهاء الصيانة واستخدام الحدود وآخر فحص والأيام المتبقية دون اتصال. إذا لم يُفعَّل التثبيت يُدخَل مفتاح الترخيص هنا ويُضغط «تفعيل»؛ وبعد تغيير الوحدات أو المدة يجلب «تجديد الترخيص الآن» الترخيص الجديد فورًا.

إذا لم يكن للخادم اتصال بالإنترنت: نزّل الملف عبر «تنزيل ملف الطلب»، وأرسله إلى Mobilteg من حاسوب متصل بالإنترنت، ثم ارفع ملف الرد الوارد عبر «رفع ملف الرد». يحمل ملف الطلب مفتاح الترخيص؛ فاحمِه كما تحمي المفتاح.

الإعدادات ← التحديثات

يُختار الوضع «تلقائي (في نافذة الصيانة)» أو «يدوي»؛ وتُدخَل نافذة الصيانة بتوقيت الخادم وتُختار القناة (مستقرة/تجريبية). في الوضع اليدوي تثبّت الإصدار بنفسك عبر «ثبّت الآن»؛ أما الإصدارات الإلزامية فتُثبَّت في نافذة الصيانة في كلا الوضعين. يستعلم «افحص الآن» عن إصدار جديد فورًا.

في كل تحديث يُوقَف التطبيق، وتُؤخذ نسخة احتياطية من قاعدة البيانات (pg_dump) ونسخة من مجلدات البرنامج؛ وتُحفظ آخر ثلاث نسخ احتياطية. إذا فشلت خطوة تُستعاد الملفات وقاعدة البيانات ويُعاد تشغيل الإصدار السابق. يُتحقَّق على خادمك من توقيع بيان الإصدار ومن بصمة SHA-256 للحزمة قبل التثبيت؛ ويُعرض السجل في هذه الشاشة.

الإعدادات ← اتصال الجوال

ثبّت تطبيق Saha على الهاتف (يفتح رابط «تنزيل التطبيق» في هذه الشاشة صفحة التنزيل)، واضغط «الاتصال عبر QR» في شاشة الدخول وامسح رمز QR. يحفظ التطبيق العنوان بعد التحقق من توقيع ترخيص الخادم ومعرّف التثبيت؛ ثم يتم الدخول بالاسم المختصر للمؤسسة والبريد الإلكتروني وكلمة المرور.

لا يحتوي رمز QR على كلمة مرور أو مفتاح؛ بل على عنوان الخادم ومعرّف التثبيت فقط. لا تتصل الهواتف إلا بتثبيت مفعَّل. وإذا تعذّر مسح رمز QR يُكتب العنوان يدويًا في «إعداد الخادم» بشاشة الدخول.

النسخة التجريبية والترخيص والدعم

من التجريبي إلى المدفوع

مدة النسخة التجريبية 7 يومًا، وتبدأ لحظة التفعيل وفق ساعة خادم التراخيص. عند الانتقال إلى النسخة المدفوعة تحوّل Mobilteg الترخيص نفسه (المفتاح نفسه) إلى اشتراك أو شراء؛ ويستلم التثبيت الترخيص الجديد في الفحص التالي أو عبر «تجديد الترخيص الآن». لا حاجة لإعادة التثبيت، وتبقى بياناتك في مكانها.

العمل دون اتصال ومدة الترخيص

يجدّد التثبيت ترخيصه بانتظام مع خادم التراخيص. إذا تعذّر الوصول إلى الخادم يعمل بكامل وظائفه طوال مدة العمل دون اتصال المحددة في الترخيص (افتراضيًا 30 يومًا للترخيص المدفوع و7 أيام للتجريبي)؛ وتنبّه اللوحة في آخر 3 أيام.

إذا تجاوزت المدة أو انتهى الترخيص أو عُلّق، ينتقل التثبيت إلى وضع القراءة فقط: يمكن عرض السجلات وتصديرها ونسخها احتياطيًا، لكن لا يمكن إجراء تغييرات. ولا تُقفَل بياناتك في أي حال.

الدعم

يُرسَل الطلب الذي تفتحه من شاشة طلبات الدعم في اللوحة إلى مكتب دعم Mobilteg؛ ويُرفق به معرّف التثبيت والإصدار والوحدات وآخر 4 أحرف من مفتاح الترخيص، دون أي كلمة مرور أو بيانات شخصية. ويمكن للمستخدم المخوّل إرفاق تقرير تشخيص مُقنَّع إن شاء.

إذا تعذّر الوصول إلى مركز Mobilteg في تلك اللحظة، ينتظر الطلب بحالة «تعذّر الإرسال إلى المركز، ستُعاد المحاولة» ويُعاد إرساله تلقائيًا. والدعم متاح أيضًا في وضع القراءة فقط.

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

هل يعمل دون اتصال الخادم بالإنترنت؟

نعم. تعمل وحدات الأعمال ولوحة الويب وتطبيق الجوال مع الخادم المحلي. لا يلزم الإنترنت إلا للتفعيل وتجديد الترخيص وتنزيل التحديثات وإرسال طلبات الدعم؛ ويمكن أيضًا تفعيل مفتاح الترخيص بملف تفعيل دون اتصال. وإذا تعذّر تجديد الترخيص لمدة طويلة ينتقل التثبيت إلى وضع القراءة فقط.

ماذا يحدث لبياناتي عند الانتقال من التجريبي إلى المدفوع؟

تبقى في مكانها. تحوّل Mobilteg الترخيص نفسه إلى مدفوع؛ ويستلم التثبيت الترخيص الجديد في الفحص التالي أو عبر «تجديد الترخيص الآن». لا حاجة لإعادة التثبيت.

هل يمكنني استخدام خادم PostgreSQL الخاص بي؟

نعم. اختر «استخدام خادم PostgreSQL موجود»؛ يجب أن يكون المستخدم المتصل مستخدمًا فائقًا (superuser)، و«اختبار الاتصال» إلزامي. ينشئ التثبيت قاعدة البيانات والدورين mobilteg / mobilteg_app؛ وإن كانا موجودين على الخادم يتركهما دون تغيير.

ليست لدي شهادة؛ هل يمكنني التثبيت رغم ذلك؟

فقط في شبكة محلية موثوقة معزولة عن الإنترنت، باستخدام خيار «HTTP غير مشفّر فقط»؛ ولأن كلمات المرور ستنتقل في الشبكة دون تشفير يطلب المعالج تأكيدًا صريحًا. لا يتصل تطبيق الجوال بعنوان http إلا في الشبكة المحلية ومع تحذير. احصل على شهادة وانتقل إلى HTTPS في أقرب فرصة.

ماذا يحدث إذا توقّف التثبيت في منتصفه؟

أعد فتح برنامج التثبيت: يُتحقَّق من الخطوات المكتملة وتُتخطّى ويتابع من حيث توقّف. ويمكنك التراجع إن شئت؛ فتُزال فقط الخدمات وقاعدة جدار الحماية وقاعدة البيانات الفارغة والمجلدات التي أنشأها هذا التثبيت، ولا يُمسّ أي شيء كان موجودًا من قبل.

هل أجري التحديث ببرنامج التثبيت؟

لا. يحدّث النظام المثبّت نفسه من اللوحة (الإعدادات ← التحديثات)؛ وبرنامج التثبيت مخصّص للتثبيت الأول فقط.

هل يتوفر تثبيت صامت (من سطر الأوامر)؟

نعم: عبر ‎--sessiz --yanit yanit.json. يُخرج ‎--ornek-yanit ملف رد نموذجيًا، ويُجري ‎--denetle الفحص المسبق فقط. لا يُكتب مفتاح الترخيص وكلمات المرور في ملف الرد، بل تُقرأ من متغيرات البيئة.

سلامة الحزمة

جارٍ تحميل معلومات الحزمة…

إذا كان لديك سؤال راسلنا.

ثبّت Mobilteg Saha على خادمك الخاص

متطلبات النظام

Windows Server 2019 / Windows 10 بنظام 64 بت (الإصدار 1809، البنية 17763) أو أحدث.

تشغيل برنامج التثبيت بصلاحيات المسؤول.

مساحة فارغة لا تقل عن 4 GB على محرك أقراص مجلدات البرنامج والبيانات.

منافذ متاحة: HTTPS العام (الافتراضي 443) وHTTP اختياري (80)؛ وداخل الخادم: API على 3001 وHost على 47801 وPostgreSQL المضمّن في الحزمة (الافتراضي 5433). إذا كان أحد المنافذ مشغولًا (مثل IIS) ينبّهك الفحص المسبق.

لـ HTTPS: شهادة خادم سارية الصلاحية ولها مفتاح خاص في مخزن LocalMachine\My. وإن لم تتوفر: HTTP غير مشفّر فقط في شبكة محلية معزولة عن الإنترنت مع تأكيد التحذير.

قاعدة البيانات: PostgreSQL 16 المضمّن في الحزمة (يثبّته برنامج التثبيت) أو خادم PostgreSQL موجود يُتصل به بمستخدم فائق (اختُبر مع الإصدار 16؛ ويظهر تحذير مع الإصدارات الأقدم).

حزمة Microsoft Visual C++ 2015–2022 (x64) القابلة لإعادة التوزيع لأجل PostgreSQL المضمّن؛ وإن كانت مفقودة تنبّه خطوة PostgreSQL إلى ذلك.

اتصال بالإنترنت إلى خادم التراخيص في خطوة التفعيل؛ إذ لا يتحوّل الرمز التجريبي إلى ترخيص إلا عبر هذا الاتصال. في التثبيت بمفتاح الترخيص دون إنترنت يكتمل التثبيت مع ذلك، ويتم التفعيل من اللوحة بملف تفعيل دون اتصال.

التثبيت خطوة بخطوة

انقر على الصورة لفتحها بالحجم الكامل.

نوع التثبيت

يطلب برنامج التثبيت صلاحيات المسؤول عند فتحه. في الشاشة الأولى يُختار «تثبيت جديد (بمفتاح الترخيص)» أو «تثبيت تجريبي (برمز تجريبي، 7 يومًا)».

لا يمكن اختيار «تحديث»: يحدّث النظام المثبّت نفسه من لوحة الويب. وإذا كان على الخادم تثبيت لم يكتمل، يقترح البرنامج أولًا متابعته أو التراجع عنه.

الترخيص

في التثبيت الجديد يُدخَل مفتاح الترخيص بصيغة MBTS-XXXX-XXXX-XXXX-XXXX، وفي التجريبي يُدخَل الرمز التجريبي والبريد الإلكتروني الذي كتبته في طلب النسخة التجريبية.

يُتحقَّق في هذه الشاشة من صيغة المفتاح فقط. يُتحقَّق من المفتاح لدى خادم التراخيص في خطوة التفعيل بعد تثبيت النظام وتشغيله؛ وإذا رُفض تذكر تلك الخطوة السبب، فتصحّحه وتتابع. لا تغيّر حقل «خادم التراخيص».

العميل والشركة

يُدخَل اسم المؤسسة والاسم المختصر واسم الشركة الأولى. يُقترح الاسم المختصر من الاسم، ويُكتب عند الدخول كرمز المؤسسة (أحرف صغيرة وأرقام وشرطة).

الشركة الأولى هي الكيان القانوني الذي تصدر باسمه الفواتير؛ ويمكن تعديل الشركات لاحقًا من لوحة الويب.

العنوان وHTTPS

يُحدَّد الاسم الذي سيكتبه المستخدمون في المتصفح وتطبيق الجوال (مثل saha.firma.local أو 192.168.1.20)، ومنفذ HTTPS، والشهادة من مخزن LocalMachine\My. لا يمكن اختيار شهادة منتهية الصلاحية؛ وتُميَّز الشهادة التي بقي على انتهائها أقل من 30 يومًا أو التي لا تغطي العنوان.

يمكن أيضًا فتح منفذ HTTP إن رغبت، ليعيد التوجيه إلى HTTPS. ولا يتقدّم خيار «HTTP غير مشفّر فقط» دون شهادة إلا بعد تأكيد تحذير أمني صريح.

قاعدة البيانات

الموصى به: يُثبَّت PostgreSQL 16 المضمّن في الحزمة على هذا الخادم (مجلد البرنامج والبيانات والمنفذ؛ الافتراضي 5433). تُولَّد كلمة مرور المستخدم الفائق عشوائيًا وتُحفظ محمية بـ DPAPI؛ ولا يستمع الخادم إلا على 127.0.0.1.

يمكن أيضًا استخدام خادم PostgreSQL موجود: يُدخَل الخادم والمنفذ والمستخدم الفائق وكلمة المرور واسم قاعدة البيانات، ولا يمكن المتابعة قبل نجاح «اختبار الاتصال». لا تُكتب كلمة المرور في أي مكان.

المسؤول الأول

يُدخَل الاسم الكامل والبريد الإلكتروني (اسم الدخول) وكلمة المرور. يجب ألا تقل كلمة المرور عن 8 أحرف وأن تحتوي على ثلاثة على الأقل من: حرف كبير، حرف صغير، رقم، رمز؛ ولا تُقبل كلمات المرور الشائعة. يُتحقَّق من القاعدة أثناء الكتابة.

لا تُكتب كلمة المرور في أي ملف أو سجل أو تقرير.

الأمان

تُضاف في جدار حماية Windows قاعدة للمنفذ العام فقط (HTTPS/HTTP)؛ ويُختار ملف التعريف. لا تُفتح منافذ API (3001) والمنفذ المحلي لـ Host (47801) وPostgreSQL، بل تستمع على 127.0.0.1 فقط.

يمكن تغيير مجلد البرنامج هنا. تعمل الخدمة بحساب NT SERVICE\MobiltegSahaHost وليس بحساب LocalSystem.

الملخص

تظهر جميع الخيارات في شاشة واحدة. يشغّل «افحص أولًا» الفحوص المسبقة دون كتابة أي شيء؛ وإن لم توجد مشكلة يبدأ التثبيت بـ «تثبيت».

التثبيت

تُنفَّذ الخطوات بالترتيب: المتطلبات المسبقة، الملفات والتحقق بـ SHA-256، الإعداد، PostgreSQL، قاعدة البيانات والمخطط، الشركة والمسؤول، خدمة Windows، الأذونات، جدار الحماية، التشغيل، فحص السلامة، تفعيل الترخيص وتقرير التثبيت.

تُسجَّل كل خطوة. إذا توقّف التثبيت في منتصفه، يتابع البرنامج من حيث توقّف عند إعادة فتحه، أو يزيل عبر «تراجع» ما أنشأه هذا التثبيت فقط؛ وتُترك قاعدة البيانات التي تحتوي على بيانات.

اكتمل التثبيت

تعرض الشاشة الأخيرة عنوان لوحة الويب، وعنوان الخادم الذي يُكتب في تطبيق الجوال (…/api)، وبيانات الدخول (بريد المسؤول ورمز المؤسسة)، وموقع تقرير التثبيت؛ وتُدرج هنا التحذيرات إن وُجدت.

تدخل إلى اللوحة عبر «فتح اللوحة». في التثبيت بمفتاح الترخيص، إذا تعذّر الوصول إلى خادم التراخيص في تلك اللحظة يكتمل التثبيت مع ذلك، وتفعّل المفتاح لاحقًا من اللوحة.