Own Ebookدليل التثبيت
دليل عملي للمبتدئين

ثبّت Own Ebook على Hero، خطوة بخطوة

هذا المسار مخصص لـ Hostbas Hero مع Node.js 24 وقاعدة MongoDB Atlas خارجية. ترفع الحزمة، تجهّز التطبيق مرة واحدة، ثم تكمل التثبيت من متصفحك. لا تحتاج إلى شراء VPS.

استخدم أحدث إصدار: 1.0.15 أو أحدث صور فعلية من اختبار التثبيت

تحديث إعداد OpenRouter: 11 نوفمبر 2026. آخر تحقق من التثبيت على الخادم الفعلي مع Atlas: 9 نوفمبر 2026. صور Atlas ولوحة Webuzo من حساب اختبار مستقل، وصور المثبّت من معاينة واجهته الفعلية. مراجعة الدليل: 12 نوفمبر 2026؛ أرقام الإصدارات القديمة في الصور أمثلة تاريخية وليست الإصدار الموصى به. أسماء الحساب والدومين وقاعدة البيانات أمثلة. اضغط أي صورة لعرضها بحجمها الكامل. يمكنك استخدام أمر الطباعة في متصفحك لحفظ الدليل بصيغة PDF.

قبل البدء: استخدم دومينًا فارغًا وحساب Hero مهيّأ لـ Node.js وTerminal ومكتبات Chromium وخطوط عربية وإنجليزية مرئية داخل حسابك والاتصال بـ Atlas. أكّد مع الاستضافة الذاكرة المتاحة وحد العمليات والخيوط لحسابك. حدث نفاد موارد على حساب بذاكرة 1 GB وحدّ 100 عملية؛ لذلك لا تكفي أرقام الخطة وحدها لضمان تشغيل الكتب والتصدير. لا يغيّر المثبّت حدود الحساب أو باقته. الواجهة ومكتبات تشغيلها مجهّزة داخل الحزمة، فلا تحتاج إلى بناء Next.js في حسابك. الصور القديمة التي تُظهر رقم إصدار آخر تشرح موضع الأزرار فقط؛ استخدم حزمة 1.0.15 أو أحدث.
هل جهّزت الاستضافة المثبّت لك؟

إذا أرسل لك مزود الاستضافة رابط المثبّت ومفتاح Setup key، افتح الرابط وابدأ من التثبيت في المتصفح. لا تنشئ تطبيق Node.js آخر ولا تكرر رفع الحزمة. جهّز حساب Atlas وقاعدة جديدة فارغة ومستخدمًا بصلاحية readWrite خاصة بها لإدخالها عندما يطلبها المثبّت.

إذا كنت تجهّز الاستضافة بنفسك، اتبع المراحل التالية. إذا لم تتوفر إدارة التطبيقات أو نسخة Node.js المناسبة، اطلب من المزود تجهيز التشغيل أولًا.

في مراجعة حساب myaton.shop في 12 نوفمبر، شمل الفحص شاشة المثبّت ومتطلبات الاستضافة وحماية الجلسة وملف PDF مقروءًا بالعربية والإنجليزية. إدخال Atlas وتفعيل رخصة العميل وإنشاء مديره متروكة له؛ هذا الفحص لا يثبت نجاح هذه الخطوات قبل أن ينفذها. اختبارات المختبر الأقدم الموصوفة تحت الصور مستقلة عن هذا الحساب.

المرحلة الأولى: افتح Hero وتأكد من جاهزية حسابك

1. افتح لوحة الاستضافة

زر Hostbas اسمه Login to cPanel، لكن اللوحة المعروضة في صور هذا الدليل هي Webuzo. أسماء القوائم قد تختلف عند مزود آخر.

خانة IP Address موجودة أعلى الصفحة كما في الصورة. هذا العنوان ليس بالضرورة عنوان خروج التطبيق إلى الإنترنت؛ أكّده مع الاستضافة قبل إضافته إلى Atlas.

الصفحة الرئيسية للوحة الاستضافة وخانة IP Address في أعلاها
عنوان IP ظاهر أعلى الصورة، بجانب Primary Domain.

المرحلة الثانية: إعداد قاعدة MongoDB Atlas خطوة بخطوة

أنشئ قاعدة جديدة خاصة بموقعك. أمثلة هذا الدليل تستخدم المشروع Own Ebook Installation Lab، والخادم OwnEbookLab، وقاعدة البيانات own_ebook_lab. يمكنك اختيار أسماء أخرى، مع استخدام اسم قاعدة البيانات نفسه في الصلاحيات ورابط الاتصال.

1. أنشئ مشروعًا مستقلًا

  • أ. سجّل الدخول إلى MongoDB Atlas.
  • ب. افتح قائمة Project.
  • ج. اضغط New Project.
  • د. اكتب اسمًا لمشروع موقعك، ثم اضغط Next.
  • ه. اضغط Create Project. لا تحتاج إلى إضافة أعضاء آخرين.
نموذج تسمية مشروع مستقل في MongoDB Atlas
المشروع المستقل يفصل إعدادات موقعك عن قواعد البيانات الأخرى في حسابك.

2. افتح إنشاء الخادم

  • أ. داخل المشروع الجديد اضغط Create cluster.
  • ب. إذا كنت في صفحة Clusters، قد يظهر الزر باسم Build a Cluster.
زر إنشاء خادم داخل مشروع Atlas الجديد
تأكد من أنك داخل المشروع الذي أنشأته في الخطوة السابقة.

3. اختر الخطة المجانية وأكمل الإنشاء

  • أ. اختر Free.
  • ب. تأكد أن السعر الظاهر هو $0/hour.
  • ج. اكتب اسم الخادم، مثل OwnEbook.
  • د. اختر منطقة قريبة من خادم الاستضافة؛ الصورة تستخدم AWS — Paris.
  • ه. ألغِ تحديد Automate security setup.
  • و. ألغِ تحديد Preload sample dataset.
  • ز. اضغط Create Deployment، وأكمل التحقق إذا ظهر.
اختيار خطة Free وإلغاء إعداد الأمان التلقائي والبيانات النموذجية
الخطة المجانية الظاهرة في المثال توفر 512 MB لقاعدة البيانات. راجع السعة والخطة المناسبة عند نمو موقعك.

4. انتظر حتى يصبح الخادم جاهزًا

  • أ. انتظر ظهور اسم الخادم وحالة Active.
  • ب. اترك قاعدة الموقع الجديدة فارغة؛ لا تستورد بيانات مشروع آخر أو بيانات الأمثلة.
الخادم OwnEbookLab بحالة Active وعلى الخطة المجانية
ظهور Active يؤكد جاهزية الخادم، وتبقى خطوة المستخدم والسماح بالاتصال.

5. حدد صلاحيات مستخدم التطبيق

  • أ. افتح Database & Network Access.
  • ب. افتح Database Users، ثم اضغط Add New Database User.
  • ج. اختر Password.
  • د. ضمن Specific Privileges اضغط Add Specific Privilege.
  • ه. اختر readWrite.
  • و. في Database اكتب اسم القاعدة الجديدة مثل own_ebook، واترك Collection فارغًا.

فعّل Restrict Access to Specific Clusters، ثم اختر خادمك وحده واضغط Done. اترك Built-in Role دون اختيار دور إضافي.

صلاحية readWrite على قاعدة own_ebook_lab وتقييدها بخادم OwnEbookLab
استخدم اسم قاعدة البيانات ذاته في رابط الاتصال لاحقًا.

6. أنشئ اسم المستخدم وكلمة المرور

  • أ. اكتب اسم المستخدم، مثل own_ebook_app.
  • ب. اضغط Autogenerate Secure Password.
  • ج. انسخ كلمة المرور واحفظها في مدير كلمات المرور لديك. ستحتاجها داخل المثبّت.
  • د. راجع الصلاحيات في الخطوة السابقة، ثم اضغط Add User.
حقول اسم مستخدم قاعدة البيانات وكلمة المرور وزر التوليد الآمن
لا تضع كلمة المرور في صورة عامة أو رسالة دعم.

7. تحقق من حفظ المستخدم

  • أ. ارجع إلى Database Users.
  • ب. تأكد من ظهور المستخدم ودور readWrite بجانب اسم القاعدة، والوصول إلى خادم واحد.
المستخدم المحفوظ بصلاحية القراءة والكتابة على قاعدة الموقع فقط
وجود المستخدم في هذه القائمة يؤكد حفظه؛ احتفظ بكلمة مروره للخطوة التالية.

8. اسمح بعنوان خروج التطبيق إلى Atlas

أضف عنوان الخروج العام الذي يستخدمه تطبيقك للاتصال بالإنترنت. قد يختلف عن عنوان الدومين أو Shared IP في لوحة الاستضافة. أكّد العنوان مع مزود الاستضافة، ثم أضفه إلى Atlas بنطاق /32 للعنوان IPv4 المفرد.

  • أ. في Atlas افتح Database & Network Access → IP Access List.
  • ب. اضغط Add IP Address، وأدخل عنوان الخروج الذي أكّده المزود متبوعًا بـ /32، ثم اضغط Confirm.
  • ج. انتظر ظهور Active بجانبه. إذا كان مضافًا بالفعل، اتركه كما هو.
مثال خاص بحساب محدد: تم قياس 63.250.32.101/32 كعنوان خروج لحساب myaton.shop. لا تستخدمه تلقائيًا لحساب آخر أو خادم آخر.

هناك شرطان منفصلان: قائمة IP Access List في Atlas تسمح بعنوان خروج التطبيق، وجدار حماية الاستضافة يسمح بالاتصال الصادر إلى عقد Atlas على المنفذ 27017 مع عمل DNS/SRV. لا تحتاج إلى فتح منفذ MongoDB للدخول من الإنترنت إلى خادم موقعك.

متى أضغط Add Current IP Address؟

هذه خطوة اختيارية إذا ستتصل بالقاعدة من جهازك عبر Compass أو أداة مشابهة. اضغط Add IP Address → Add Current IP Address → Confirm، ثم انتظر Active. ليست شرطًا لتشغيل الموقع المستضاف، ولا تحذف عنوان خروج الاستضافة عند إضافة جهازك.

أستخدم Namecheap أو Hostinger أو مزودًا آخر

اطلب من الدعم تأكيد عنوان الخروج العام المستخدم لاتصالات تطبيق Node.js إلى Atlas، ودعم الاتصال الصادر إلى عقده على 27017 وDNS/SRV. عنوان الموقع أو Shared IP الظاهر في اللوحة قد يختلف؛ لا تعتمد عليه وحده. أكّد أيضًا دعم Node.js وChromium والخطوط داخل حسابك.

ما تجهيز Atlas الخاص بحساب myaton؟

في هذا الحساب فقط أعدّ المزود خدمة تلتقط مضيف Atlas الذي يدخله المالك وتسمح بعناوين عقده العامة فقط. هذا تجهيز استضافة خاص بالحساب، وليس ميزة موجودة تلقائيًا في كل نسخة Own Ebook. على بقية العملاء تأكيد السماح الصادر مع مزودهم.

مثال تاريخي لعنوان مسموح في قائمة Atlas بحالة Active
الصورة مثال؛ استخدم عنوان خروج حسابك المؤكّد. إضافة عنوان جهازك عبر Add Current IP Address اختيارية.

مرجع MongoDB الرسمي لقائمة السماح بعناوين IP.

9. انسخ رابط اتصال قاعدة البيانات

  • أ. افتح MongoDB Atlas من هنا، واختر مشروعك من قائمة Project أعلى الصفحة.
  • ب. من القائمة الجانبية اضغط Database → Clusters. هذه هي صفحة الخادم الذي أنشأته، مثل OwnEbookLab في الصورة.
  • ج. اضغط Connect بجانب اسم خادمك. إذا كنت ترى هذا الزر بالفعل، اضغطه مباشرة.
  • د. اختر Drivers، ثم JavaScript وNode.js Driver إذا ظهرت هذه الخيارات.
  • ه. اضغط أيقونة النسخ بجانب رابط الاتصال. احتفظ بالرابط كما هو، مع كلمة مرور مستخدم القاعدة واسم القاعدة، للخطوة القادمة في المثبّت.
صفحة خادم Atlas وزر Connect على يمين اسم الخادم
هذه صفحة الخادم المقصودة؛ اضغط Connect الظاهر في أعلى اليمين.
نافذة Drivers التي تعرض رابط الاتصال وأيقونة نسخه
انسخ الرابط الذي يبدأ بـ mongodb+srv://. اترك <db_password> كما هو؛ ستكتب كلمة المرور في خانتها داخل المثبّت.

المرحلة الثالثة: نزّل السكريبت وارفعه

1. افتح مشترياتك في Gumroad ونزّل السكريبت

بعد الدفع افتح محتوى عملية شراء Own Ebook Script من صفحة التأكيد أو زر Download & license key في إيصال Gumroad (قد يظهر باسم View content في بعض الصفحات). يمكنك الرجوع إليه من Library إذا كنت تستخدم حساب Gumroad. اضغط Download بجانب الملف الكامل ownebook-1.0.16-stable-full.zip أو الإصدار الأحدث الظاهر لك.

ستجد في صفحة الشراء نفسها ثلاثة أشياء: ملف السكريبت، مفتاح الترخيص الشخصي، وروابط الوثائق العامة. لا تحتاج إلى إنشاء حساب منفصل في بوابة Own Ebook حتى تنزّل الملف المرفق وتبدأ التثبيت.

ملف Own Ebook الكامل وزر Download وروابط الوثائق داخل محتوى Gumroad
صورة فعلية لمحتوى المنتج المحفوظ من معاينة البائع في Gumroad. قد تختلف أزرار صفحة المشتري ورقم الإصدار قليلًا. اختر Full للتثبيت الأول؛ Update للتحديث فقط.

2. انسخ مفتاح الترخيص وافتح الدليل العام

في محتوى الشراء ابحث عن License key واضغط Copy. احتفظ بمفتاحك بشكل خاص؛ ستلصقه في خانة كود التفعيل عندما يطلبه المثبّت. استخدم المفتاح الخاص بعملية شرائك، وليس المفتاح النموذجي الظاهر في هذه الصورة.

رابط الوثائق العامة ورابط هذا الدليل العربي موجودان في Gumroad ورسالة الشراء، ويعملان بدون تسجيل دخول. حساب Own Ebook للمشتري اختياري لإدارة الرخصة والتنزيلات المؤهلة لاحقًا؛ وهو مختلف عن حساب مدير موقعك.

روابط الدليل العام ومفتاح License key النموذجي مع زر Copy في معاينة Gumroad
هذه معاينة البائع: عبارة License key (sample) تعني أن المفتاح المعروض مثال غير صالح للتفعيل، وليس مفتاح عميل حقيقي.

3. افتح مدير الملفات في مجلد حسابك الخاص

من Webuzo افتح File Manager، ثم المجلد الرئيسي للحساب، مثل /home/YOUR_USER. يجب أن ترى مجلد public_html ضمن القائمة؛ ابقَ خارجه. لا تضع حزمة التطبيق أو إعدادات قاعدة البيانات داخله.

مجلد حساب الاستضافة خارج public_html في مدير الملفات
الصورة بعد الاختبار؛ ستظهر مجلدات own-ebook وown-ebook-data عند اكتمال تثبيتك.

4. ارفع ملف ZIP إلى مجلد Home، خارج public_html

مسار الرفع الصحيح هو المجلد الرئيسي لحساب الاستضافة:
/home/YOUR_USER/

استبدل YOUR_USER باسم مستخدم حساب الاستضافة. مثلًا، الحساب الظاهر في الصورة اسمه oebooklab، ومساره /home/oebooklab/.

لا تضع ملفات التطبيق داخل public_html، ولا داخل مجلد الدومين الإضافي إذا كان هو DocumentRoot، ولا داخل أي مجلد يخدمه الويب. ارفع Full ZIP إلى Home الخاص بحسابك وفكّه هناك، ليبقى ملف التشغيل في /home/YOUR_USER/ownebook/start.cjs.

مثال توضيحي من myaton.shop: المجلد /home/atonboxs/myaton.shop عام للدومين، أما مصدر التطبيق الخاص فهو /home/atonboxs/ownebook. إعداد التوجيه وحده يوجد في المجلد العام؛ لا تنقل إليه ملفات التطبيق. استخدم اسم حسابك أنت.

تعليمات حزمة Try Ebook التي قد تطلب فك الضغط داخل public_html لا تنطبق على Own Ebook؛ طريقة تشغيلهما مختلفة.

  • أ. في File Manager اضغط رمز المنزل Home أو Root للرجوع إلى مجلد حسابك الرئيسي. تأكد أن public_html ظاهر ضمن المجلدات، وابقَ خارجه.
  • ب. وأنت في هذا المسار، اضغط Upload files أعلى الصفحة.
  • ج. في النافذة اضغط Select files، وهو الزر الأيسر في الصورة. لا تختَر Select folder.
  • د. اختر ملف ZIP الكامل الذي نزّلته من Gumroad، ثم اضغط Open وانتظر اكتمال الرفع.
رفع ملف ZIP من المجلد الرئيسي للحساب خارج public_html باستخدام زر Select files الأيسر
الرفع هنا داخل مجلد الحساب الرئيسي؛ public_html ظاهر ضمن القائمة وليس مفتوحًا. اختر Select files.

5. فك ضغط الحزمة في المكان نفسه

  • أ. اضغط بزر الفأرة الأيمن على ملف ZIP الذي رفعته.
  • ب. اختر Extract files from archive، ثم اضغط Here، وهو الخيار الثاني في القائمة الفرعية.
  • ج. انتظر فك الضغط. سيظهر مجلد ownebook؛ افتحه وتأكد من وجود ملف start.cjs في /home/YOUR_USER/ownebook/start.cjs.
قائمة ملف ZIP وخيار Extract files from archive
افتح القائمة الفرعية بجانب Extract files from archive، ثم اختر Here.

المرحلة الرابعة: اربط التطبيق بدومينك

1. املأ بيانات التطبيق

هذه الخطوة لمن يجهّز التشغيل بنفسه. إذا استلمت رابط المثبّت وSetup key من الاستضافة، انتقل إلى المثبّت ولا تنشئ تطبيقًا مكررًا.

  • أ. ارجع إلى Webuzo، ثم اضغط Applications → Add Applications. إذا ظهرت تطبيقات لمواقع أخرى، اتركها كما هي وأنشئ تطبيقًا جديدًا لموقعك.
  • ب. في Application Name اكتب اسم موقعك، مثل Own Ebook.
  • ج. في Deployment Domain اختر أو اكتب اسم دومينك كاملًا، مثل mybooks.com أو mybooks.shop أو mybooks.store، بدون https://.
  • د. في Application type اختر Node.js. اكتب ownebook في Application Path بعد المسار الرمادي، وstart.cjs في Application startup file.
  • ه. تحت Deployment Environment اختر Production. تبويب Self Managed هو الزر البنفسجي أعلى النموذج؛ إذا كان مفتوحًا كما في الصورة، اتركه كما هو.
  • و. خانة Base Application URL موجودة أسفل Application Name، على يسار الصورة. اترك الجزء الأبيض بعد اسم الدومين فارغًا.
  • ز. احتفظ بالنموذج مفتوحًا. في الخطوة التالية سنملأ Start Command وStop Command، ثم نضغط Create أسفل النموذج لحفظ التطبيق.
نموذج التطبيق: Self Managed بالأعلى وBase Application URL تحت Application Name وCreate في الأسفل
صورة توضيحية قديمة للحقول؛ استخدم اسم موقعك ودومينك. لا تنسخ أوامر الصورة؛ اضغط «التالي» لتجهيز الأمرين المصححين قبل Create.

2. املأ Start Command وStop Command

نحن الآن عند خانتَي Start Command وStop Command أسفل نموذج التطبيق. اترك Webuzo مفتوحًا، وأدخل القيم الثلاث التالية هنا لنجهّز لك النصين.

مولّد خاص بتجهيز Hostbas الموضح هنا: يستخدم /usr/bin/lve_wrapper للعزل و/opt/own-ebook-node/bin/node لتشغيل Node.js. إذا كنت لدى مزود آخر، اطلب منه تأكيد مسار Node وآلية العزل وأوامر مدير التطبيقات قبل استخدامها. يتحقق المولد من المسار والمنفذ؛ اسم التطبيق للعرض فقط ولا يدخل في أمر التشغيل.

انسخ هذه البيانات من نموذج التطبيق

اسم موقعك الذي كتبته في الخطوة السابقة.
انسخ الجزء الرمادي /home/اسم-حسابك/ وأضف إليه ownebook، كما في المثال.
انسخ رقم Port من نموذجك؛ لا تستخدم رقم الصورة إلا إذا طابقه.

ينفّذ الأمر cd داخل CageFS بعد lve_wrapper، ثم يشغّل Node من مجلد التطبيق. لا تحذف هذا الجزء؛ قد يصبح مجلد العمل الموروث غير قابل للوصول بعد الدخول إلى العزل.

بعد لصق النصين، اضغط Create أسفل نموذج Webuzo. ثم افتح Applications → List Applications، وابحث عن اسم تطبيقك. إذا لم تكن حالته Running، اضغط Start.

تحقق من حفظ الأمر كما نسخته: في نسخة Webuzo التي اختبرناها، أضافت اللوحة محارف \ إلى علامات الاقتباس، فلم يعمل الأمر عند لصقه مباشرة. إذا حدث ذلك أو بقي التطبيق متوقفًا، لا تنشئ تطبيقًا آخر. أرسل إلى الاستضافة طريقة تشغيل الأمر من ملف خاص بالحساب لتجهيز التطبيق نفسه. نجح هذا المسار البديل في المختبر مع Check requirements؛ لا يعني نجاح الفحص اكتمال اتصال Atlas أو تفعيل الرخصة.
Port أعلى النموذج وApplication Name وApplication Path في الوسط وخانتا الأوامر وزر Create في الأسفل
صورة قديمة لشرح أماكن الحقول فقط؛ الأوامر التي قد تظهر داخلها ليست القالب المصحح. استخدم النصين الناتجين من المولد أعلاه وبيانات حسابك، ثم اضغط Create.

3. ثبّت شهادة الأمان SSL

  • أ. ارجع إلى Webuzo، واضغط SSL → Automatic SSL.
  • ب. ضع علامة بجانب دومينك، ثم اضغط Install.
  • ج. انتظر نحو دقيقتين، ثم حدّث الصفحة Refresh وتأكد من ظهور شهادة دومينك في القائمة. إذا كانت العملية ما زالت جارية، انتظر قليلًا ثم حدّث مجددًا.
صفحة Automatic SSL: حدد مربع الدومين ثم اضغط Install
اختر دومينك أنت، ثم Install. يجب أن يكون الدومين مرتبطًا باستضافتك.

المرحلة الخامسة: أكمل التثبيت من المتصفح

المُثبّت باللغة الإنجليزية وبهوية Own Ebook. الشرح هنا بالعربية، وأسماء الأزرار والحقول بالإنجليزية كما ستراها في موقعك.

أ. افتح موقعك وأدخل Setup key

إذا أرسل المزود رابط المثبّت وSetup key: افتح الرابط، والصق المفتاح في Setup key واضغط Verify & continue؛ تجاوز البحث عن ملف المفتاح أدناه. لا ترفع الحزمة مرة أخرى ولا تنشئ تطبيقًا آخر. أما إذا جهّزت التشغيل بنفسك، فاتبع الخطوات التالية.

  • أ. في شريط العنوان أعلى متصفح Chrome، اكتب دومينك كاملًا، مثل https://mybooks.com، ثم اضغط Enter. ستظهر صفحة التثبيت وتطلب Setup key.
  • ب. اتركها مفتوحة، وافتح Webuzo → File Manager في تبويب آخر.
  • ج. افتح مجلد ownebook، ثم المجلد .own-ebook-setup؛ اسمه يبدأ بنقطة. إذا لم يظهر، فعّل إظهار الملفات المخفية من Preferences.
  • د. اضغط بزر الفأرة الأيمن على installation-key.txt، ثم Edit أو Edit file، وانسخ الرمز الموجود بداخله دون تغييره.
  • ه. ارجع إلى صفحة موقعك، والصق الرمز في Setup key، ثم اضغط Verify & continue.
خانة Setup key وزر Verify and continue في صفحة تثبيت موقعك
انسخ الرمز من installation-key.txt؛ مفتاح الترخيص الذي أخذته من Gumroad ستستخدمه لاحقًا.

ب. افحص المتطلبات — Check requirements

  • أ. اضغط زر Check requirements.
  • ب. انتظر حتى يظهر إصدار Node.js ونتيجة الفحص.
  • ج. إذا ظهر زر Continue to database، اضغطه.
  • د. إذا لم ينجح الفحص، أرسل نص المشكلة إلى دعم الاستضافة. لا تحتاج إلى كتابة أوامر Node.js أو تعديل ملفات إعدادات.
زر فحص Node.js والأدوات داخل المثبّت
نجاح Check requirements يؤكد الفحص الأساسي فقط؛ لا يثبت اتصال Atlas أو تفعيل الرخصة أو إنشاء المدير. افحص اتصال Atlas عند إدخال بياناتك، وافتح PDF للتأكد من حروفه بعد إنشائه.

ج. أدخل رابط Atlas وكلمة المرور

  • أ. في Atlas connection string الصق الرابط الذي نسخته في خطوة رابط Atlas.
  • ب. في Database user password اكتب كلمة مرور مستخدم قاعدة البيانات الذي أنشأته في Atlas، إذا كان الرابط ما زال يحتوي <db_password>.
  • ج. في Database name اكتب اسم القاعدة نفسه الذي اخترته في خطوة الصلاحيات، إن لم يكن موجودًا في الرابط.
  • د. اضغط Continue.
حقول رابط Atlas وكلمة مرور مستخدم القاعدة واسم القاعدة وزر Continue
استخدم كلمة مرور مستخدم قاعدة البيانات، لا كلمة مرور تسجيل دخولك إلى موقع Atlas.

د. أنشئ المدير وفعّل الرخصة

  • أ. اكتب اسم موقعك في Site name.
  • ب. اكتب بريد المدير في Administrator email.
  • ج. اكتب كلمة مرور جديدة من 12 حرفًا على الأقل في Administrator password، ثم أعد كتابتها في Confirm password.
  • د. افتح مشترياتك في Gumroad وانسخ License key، ثم الصقه في Gumroad license key.
  • ه. اضغط Install my workspace مرة واحدة. إذا طلب تصحيح حقل، صحّحه ثم حاول مجددًا.
  • و. انتظر رسالة اكتمال التثبيت. يعرض المثبّت المرحلة الحالية، ولا تحتاج إلى تشغيل أوامر التثبيت في Terminal.
شاشة اسم الموقع والمدير ومفتاح ترخيص Gumroad
تُحذف نسخة المدخلات المؤقتة بعد انتهاء العامل. إذا انقطع التثبيت بعد إنشاء الملفات، يحتفظ بها للمراجعة ولا يحذف قاعدة البيانات ليعيد المحاولة.

هـ. أعد تشغيل التطبيق وادخل إلى موقعك

مثبّت 1.0.15 يطلب Stop / Start في المسار العام مع Application Manager. اتبع الخطوات التالية للتطبيق الذي أنشأته أنت.

إذا أكد المزود وجود إعادة تشغيل تلقائية بعد نجاح التثبيت: انتظر جاهزية الموقع، ثم افتح /login وسجّل الدخول. في تجهيز myaton.shop يوجد متحكم خاص بالمزود ينقل التشغيل من المثبّت إلى التطبيق تلقائيًا؛ لا تعِد تشغيل تطبيق آخر ولا تنشئ تطبيقًا مكررًا. هذه الخدمة ليست مضمونة لكل استضافة.
  • أ. بعد ظهور Your workspace is ready، ارجع إلى Webuzo، ثم اضغط Applications → List Applications.
  • ب. ابحث عن اسم تطبيقك، واضغط Stop بجانبه وانتظر حتى يتوقف.
  • ج. اضغط Start وانتظر ظهور Running.
  • د. افتح دومينك وأضف /login في النهاية، مثل https://mybooks.com/login.
  • ه. سجّل الدخول ببريد المدير وكلمة المرور اللذين اخترتهما أثناء التثبيت.
صفحة تسجيل الدخول ببريد المدير وكلمة المرور اللذين اخترتهما
هذه بيانات مدير موقعك الجديد.

المرحلة السادسة: ادخل واضبط موقعك

1. سجّل دخولك كمدير

افتح https://YOUR-DOMAIN/login. اكتب بريد المدير وكلمة المرور اللذين اخترتهما في المثبّت. هذه بيانات موقعك الخاصة؛ بيانات بوابة الشراء أو الديمو لن تعمل هنا.

صفحة تسجيل الدخول العادية للنسخة المثبتة دون بيانات الديمو
استبدل YOUR-DOMAIN بدومينك الحقيقي.

2. تحقق من ظهور لوحة العمل

ستظهر لوحة Dashboard وقائمة Admin. الحساب الجديد يبدأ بدون كتب أو بيانات عملاء. التسجيل العام مغلق افتراضيًا إلى أن تنتهي من ضبط الخدمة.

لوحة العمل الجديدة بعد نجاح تسجيل دخول مدير النسخة المثبتة
صورة من اختبار الإصدار 1.0.9 بحد 512 MB في بيئة Linux محلية. ظهور اسم موقعك وقائمة الإدارة يعني أن حساب المدير أُنشئ بنجاح.

3. اضبط علامتك التجارية وخدماتك

افتح Admin → Admin Settings، واضبط اسم الموقع وبريد الدعم والعملة وروابطك ومحتوى الصفحة الرئيسية. افتح Legal & Compliance لإدخال بيانات شركتك وسياساتك الخاصة قبل إتاحة الموقع للناس. راجع خطط الاشتراك وPayment Gateways إن كنت ستبيع خدمات على موقعك.

الإعدادات العامة للموقع وبريد الدعم والعملة
راجع جميع بيانات الهوية الافتراضية واجعلها تخص نشاطك قبل إطلاق الموقع.

4. اربط OpenRouter من لوحة الأدمن

هذه الخطوة متاحة من الإصدار 1.0.13. إذا كانت نسختك أقدم، اتبع خطوة التحديث أولًا.

  1. من القائمة الجانبية في موقعك افتح Admin → AI Costs & Billing. ستجد OpenRouter connection أعلى الصفحة.
  2. اضغط Get an API key، أو افتح صفحة مفاتيح OpenRouter. سجّل الدخول إلى حسابك، واضغط Create Key، ثم انسخ المفتاح الجديد.
  3. ارجع إلى موقعك، والصق المفتاح في OpenRouter API key، ثم اضغط Verify & save. انتظر رسالة نجاح الاتصال والحفظ.
  4. للتأكد لاحقًا، اضغط Test connection. الاختبار لا ينشئ كتابًا ولا يستهلك رصيد إنشاء.
إعداد OpenRouter في لوحة الأدمن: خانة المفتاح وزر Verify and save وزر Test connection
واجهة الإعداد الجديدة قبل إدخال المفتاح؛ لا تظهر فيها أي مفاتيح حقيقية.

أضف رصيدًا إلى حساب OpenRouter لتشغيل النماذج المدفوعة. رسوم استخدامها تُحتسب على حسابك هناك. المفتاح محفوظ بشكل مشفّر؛ لتغييره، الصق المفتاح الجديد واضغط Verify & save. ترك الخانة فارغة يُبقي المفتاح الحالي. لا تحتاج إلى تعديل ملفات الخادم أو إعادة تشغيل الموقع.

5. اضبط البريد واختبره

افتح Admin → Email & SMTP. أدخل Host وPort وEncryption وUsername وPassword حسب بيانات مزود بريدك، ثم From Name وFrom Email. احفظ، واختبر Test Connection، ثم Send Test Email إلى بريد تملكه. فعّل الإرسال بعد التأكد من وصول الرسالة.

حقول إعداد SMTP واختبار الاتصال والبريد في لوحة الإدارة
الصورة قبل إدخال أي بيانات بريد. نجاح التثبيت لا يعني أن مزود SMTP قد أُعد تلقائيًا.

6. افتح الكتاب المجاني وصدّره إلى PDF

من Dashboard اضغط Open a sample book. افتح Export ثم Export full book، أو اختر Export PDF → Full book في الأعلى. انتظر ظهور PDF downloaded وافتح الملف الذي نُزّل. اختبر أيضًا صفحات فيها نص عربي وإنجليزي: يجب أن تكون الحروف مقروءة وليست مربعات. وجود الملف أو حجمه وحده لا يكفي. إذا ظهرت مربعات، راجع الخطوط مع الاستضافة كما في حل المشكلات.

واجهة تصدير الكتاب التجريبي ورسالة تنزيل PDF بنجاح
الصورة من اختبار سابق على حساب مشترك متصل بـ Atlas. في 9 نوفمبر نجح دخول المدير وفتح الكتاب النموذجي وتصدير قالب PDF من صفحتين عبر الإصدار 1.0.12 على الخادم الفعلي، بذاكرة 512 MB و100 عملية وقراءة 4 MB/s. استخدم الاختبار قاعدة Atlas الموجودة في المختبر وحافظ على بياناتها. الكتاب النموذجي لا يحتاج إلى شراء رصيد ذكاء اصطناعي.

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

التحديث والنسخ الاحتياطي

1. افتح صفحة التحديث في موقعك

سجّل الدخول إلى موقعك أنت بحساب الأدمن. من القائمة الجانبية افتح Admin → License & Updates. يظهر الإصدار الجديد تلقائيًا مع ملخص قصير للإضافات؛ لا تحتاج إلى الضغط على زر للفحص كل مرة.

إذا أعددت Email & SMTP، يصل إلى الأدمن بريد واحد لكل إصدار، وفيه الملخص وزر يفتح صفحة التحديث في موقعه. لن يبدأ التثبيت من تلقاء نفسه.

صفحة License & Updates: ملخص الإصدار وزر Update now
مثال توضيحي للواجهة: رقم الإصدار المتاح يتغيّر حسب آخر تحديث منشور.

2. اضغط Update now

التثبيت الجديد بحزمة 1.0.14 أو أحدث يتضمن متحكم التحديث من الأدمن. أما التثبيت الأقدم فيحتاج انتقالًا يدويًا واحدًا وإعادة تشغيل المتحكم كما في القسم القابل للفتح أدناه. عند توفر تحديث:

  1. افتح Admin → License & Updates واقرأ الملخص القصير.
  2. انتظر انتهاء الكتب أو عمليات التصدير الجارية، ثم اضغط Update now.
  3. يتحقق الموقع من الرخصة وصلاحية التحديث، ويحفظ نسخة احتياطية، ثم يثبّت النسخة. يظهر التقدم أمامك، وقد يتوقف الموقع قليلًا أثناء إعادة التشغيل.
  4. انتظر رسالة نجاح التثبيت. يمكنك بعدها استعمال الموقع كالمعتاد.

إذا انتهت مدة التحديثات، ستظهر لك وصلة بوابة المشتري لتجديدها. وإذا لم يوجد تحديث جديد، ستظهر عبارة You’re up to date.

الترقية إلى 1.0.16 من نسخة أقدم: بعد نجاح التحديث، قد يظهر تنبيه One more step: restart your hosting application داخل Admin → License & Updates، وتذكير Finish your hosting update في بقية لوحة الأدمن. انتظر انتهاء إنشاء الكتب وPDF، ثم ارجع إلى Webuzo → Applications → List Applications، واختر التطبيق الحالي لهذا الموقع. اضغط Stop وانتظر توقفه، ثم اضغط Start مرة واحدة. لا تنشئ تطبيقًا آخر. إذا كان المزود يدير متحكمك، اطلب منه إعادة تشغيله.

هذه ليست خطوة بعد كل تحديث: يختفي التنبيه بعد التحقق من تشغيل المتحكم الجديد، ولا يطلبها تحديث لا يغير المتحكم. زر Check restart status يفحص الحالة فقط. إذا تعذر التحقق أو كانت هناك صيانة أو تحديث أو استعادة، اتبع الحالة المعروضة ولا تعِد التشغيل أثناء العملية. التثبيت الجديد بـ1.0.16 لا يحتاج إعادة تشغيل إضافية بعد بدء التطبيق الطبيعي؛ تبقى خطوة إعادة التشغيل الأولى بعد المثبت إذا طلبها.

نسختي أقدم من 1.0.14، أو يظهر One-time setup needed

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

هذا مسار الاستضافة المشتركة؛ لا تستخدم أوامر sudo أو ملف enable-admin-updates.py الخاص بخادم VPS. إذا كان المزود يدير متحكمًا خاصًا لتطبيقك، اطلب منه تنفيذ الانتقال وإعادة تشغيل المتحكم نفسه؛ لا تنشئ تطبيقًا جديدًا.

الخطوات التالية تستخدم مسارات Hostbas الافتراضية. أكّد المسارات مع المزود إذا كانت مختلفة، واترك تطبيقك في حالة Running قبل البدء.

  1. ارجع إلى Webuzo، ثم اضغط Terminal ضمن Server Utilities. ستفتح نافذة سوداء لكتابة الأوامر.
  2. اضغط زر «انسخ أمر التحديث» أدناه. داخل النافذة السوداء اضغط بزر الفأرة الأيمن واختر Paste، ثم اضغط Enter.
bash ~/own-ebook/current/management/update.sh

  1. اترك النافذة مفتوحة حتى ينتهي التحديث وتظهر نتيجة النجاح. قد يتوقف الموقع قليلًا أثناء التحديث. إذا ظهر خطأ، احتفظ بنصه وافتح حل المشكلات قبل المتابعة.
  2. بعد نجاح التحديث، انسخ أمر الإيقاف التالي والصقه في Terminal، ثم اضغط Enter وانتظر انتهاءه.
/opt/own-ebook-node/bin/node ~/own-ebook/app.cjs --stop

  1. ارجع إلى Webuzo → Applications → List Applications. بجانب تطبيقك اضغط Stop، ثم Start، وانتظر Running.
  2. افتح موقعك، وسجّل الدخول وتأكد من فتح كتبك.
أيقونة Terminal السوداء في قسم Server Utilities داخل Webuzo
أيقونة Terminal السوداء ظاهرة أسفل يسار الصورة ضمن Server Utilities.

3. احفظ نسخًا احتياطية خارج الاستضافة

احتفظ بنسخ دورية من قاعدة Atlas و~/own-ebook-data و~/own-ebook/deployment.json. ملفات التحديث وتقارير النسخ توجد داخل ~/own-ebook/updates. تنزيل نسخة مشفرة إلى مكان منفصل يحميك عند فقدان حساب الاستضافة؛ نسخة على القرص نفسه وحدها لا تكفي.

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

مجلد تقرير التحديث ونسخ قاعدة البيانات والملفات داخل الحساب الخاص
تحتوي النسخ والإعدادات على بيانات خاصة؛ لا تضعها في public_html أو DocumentRoot لأي دومين أو رابط تنزيل عام.

إذا توقفت عند مشكلة

تعذّر إخراج PDF أو ظهر تحذير عدد الصفحات (1.0.17 أو أحدث)

من Library اقرأ سبب التعطّل، ثم اضغط Check saved PDF لفحص المحتوى والصور المحفوظة. هذا الفحص مجاني من ناحية رصيد الذكاء الاصطناعي؛ لا يعيد الكتابة أو الغلاف ولا ينشئ شراءً جديدًا. يفتح Review layout المعاينة لتراجع التنسيق. فحص جميع الكتب يعرض نتيجة كل كتاب: تم التحقق، يحتاج مراجعة، أو مشغول.

حدود Small / Medium / Large هي 20 / 40 / 60 صفحة مطبوعة شاملة الغلاف الموجود. إذا كان الكتاب 24 صفحة والحد 20، يبقى المحتوى محفوظًا وتظهر الأرقام الحقيقية. راجع فواصل الصفحات والتنسيق؛ لا تحذف تعليمات أو أرقامًا لتجاوز التحذير. الكتب القديمة بلا باقة حجم تبقى متوافقة. إنشاء ملف PDF لا يثبت صحة الباترون أو تجربته عمليًا.

إذا كانت هناك صورتان مختلفتان من المخطوط، يعرض البرنامج مقارنة واختيار نسخة كمسودة منفصلة مع إبقاء الأصل. لا يحذف واحدة تلقائيًا. نقص الكتابة أو الصور له إجراء منفصل يتطلب مراجعة التكلفة والموافقة؛ وإذا كانت نتيجة طلب مدفوع سابق غير مؤكدة، اطلب مراجعتها من الدعم أولًا.

للدعم الفني: ابدأ بتقرير dry-run من أداة backend/scripts/repair-pdf-state.cjs، ثم أصلح الكتاب المحدد فقط مع نسخة احتياطية خاصة خارج المجلد العام. لا تُعدّل التاريخ المالي ولا تُشغّل إعادة توليد جماعية. تعليمات الفحص والاسترجاع في resources/pdf-recovery.md داخل الحزمة. لا تُزل حماية الاستضافة المؤقتة قبل اختبار التحديث الدائم على ذلك التثبيت وتوفير خطة رجوع. لا يتطلب هذا الإصدار إنشاء تطبيق استضافة آخر.

لا أجد Node.js أو Terminal أو Application Manager

الحساب غير مُهيّأ بعد. أرسل قائمة المتطلبات أعلاه إلى الاستضافة. لا تشغّل مثبت VPS أو أوامر sudo على الحساب المشترك.

Atlas لا يتصل أو يظهر Server selection timeout

راجع اسم المستخدم وكلمة مروره واسم القاعدة وصلاحية readWrite. يجب أن تسمح قائمة IP في Atlas بعنوان الخادم الصادر، وأن تسمح الاستضافة بالاتصال 27017 وDNS/SRV. عنوان جهازك الشخصي ليس عنوان الاستضافة. لا تعطل التحقق من TLS لحل المشكلة.

توقف إنشاء خادم Atlas أو ظهر CAPTCHA

أكمل التحقق في متصفحك ثم انتظر ظهور Active. إذا بقيت الصفحة معلقة، أعد تحميلها وتحقق من قائمة Clusters قبل إنشاء خادم آخر؛ قد يكون الإنشاء قد نجح بالفعل.

Chromium PDF test failed أو مربعات بدل النص

اطلب من الاستضافة فحص مكتبات Chromium وملفات الخطوط الفعلية داخل CageFS، إضافة إلى الذاكرة وحد العمليات والمساحة. قد يعرض fc-list أسماء محفوظة في الذاكرة المؤقتة بينما ملفاتها غير مرئية للتطبيق.

في حالة myaton عولجت المربعات بإضافة خطوط DejaVu الحرة ورخصتها داخل حساب العميل. يجب أن يختبر المزود ظهور حروف عربية وإنجليزية مقروءة في PDF؛ مجرد نجاح إنشاء ملف لا يكفي. لا ترفع حدود الحساب أو تغيّر باقته تلقائيًا، ولا تطلب من العميل بناء Next.js.

PermissionError أو os.getcwd() عند بدء التطبيق

قد يفقد مجلد العمل الموروث صلاحيته بعد دخول CageFS، حتى لو كان قبل الدخول داخل حسابك. استخدم مولد الأوامر المصحح الذي ينفّذ cd بعد lve_wrapper. إذا كان المزود جهّز التطبيق، أرسل له الخطأ ليفحص متحكمك الحالي.

Webuzo يغيّر علامات الاقتباس أو يبقى التطبيق متوقفًا

افتح تعديل التطبيق وقارن Start Command وStop Command بالنصين المنسوخين. إذا أضافت اللوحة محارف \، اطلب من مزود الاستضافة استعمال ملفين خاصين بأوامر التشغيل والإيقاف مع التطبيق نفسه. لا تحذف مجلدات التثبيت ولا تنشئ تطبيقًا مكررًا. بعد التشغيل افتح رابط المثبت واضغط Check requirements.

Destination already exists أو قاعدة البيانات غير فارغة

المثبت يحافظ على الموجود ويرفض الكتابة فوقه. لا تحذف الملفات أو القاعدة. إذا كان لديك تثبيت يعمل، استخدم التحديث. وإذا انقطع التثبيت الأول، اطلب مراجعة الملفات والمرحلة التي توقف عندها؛ لا توجد متابعة تلقائية عامة للمثبت المشترك.

التعافي وحدود الموارد في 1.0.15

يستخدم الوضع المحدود مهمة PDF واحدة ومتصفح Chromium واحدًا في الوقت نفسه، مع طابور محدود للطلبات التالية. مهلة بدء التطبيق خمس دقائق افتراضيًا مع فحص جاهزية؛ بعد محاولات تعافٍ محدودة يغلق المتحكم بوابته ويخرج بحالة فشل ليرصدها مدير الاستضافة، بدل البقاء على 503. يجب على المزود ضبط سياسة إعادة التشغيل المناسبة وفحص سبب نفاد الموارد.

الصيانة أثناء التحديث أو الاستعادة تبقى محفوظة حتى بعد إعادة تشغيل المتحكم. لا تحذف أقفالها أو بيانات العميل. إذا انقطع طلب ذكاء اصطناعي وكانت نتيجته غير مؤكدة، لا يعاد تلقائيًا؛ راجع الصفحات المحفوظة قبل المتابعة اليدوية. لا يثبت هذا الإصدار أن 512 MB أو 1 GB كافية لكل الأحمال. اطلب اختبار كتاب ممثل للاستخدام وPDF مقروء بالعربية والإنجليزية. تفاصيل المزود في ملحق الموارد.

الموقع يعرض 503 أو لا يعمل HTTPS

راجع حالة التطبيق وسجله، ومسار Node وأمر التشغيل والمنفذ المسند من اللوحة. انتظر إقلاع التطبيق. راجع DNS وشهادة SSL للدومين نفسه؛ لا تغيّر إعدادات الويب المشتركة أو دومينات العملاء الآخرين. قد تتأخر بعض محللات DNS بعد إنشاء دومين جديد.

خطأ 421 أو 426 خلف LiteSpeed

أرسل الخطأ إلى مزود الاستضافة مع رابط ملحق الدعم الفني. عليه حفظ Host الأصلي وإرسال قيمة https واحدة في X-Forwarded-Proto، وضبط الرابط الأساسي وتجديد الشهادة داخل إعداد الدومين فقط. هذه مراجعة للمزود وليست أوامر root ينسخها المشتري أو تعديلًا عامًا لكل المواقع.

فشل التحديث أو بقي ملف قفل

لا تحذف القفل قبل التأكد من عدم وجود تحديث يعمل. راجع تقرير العملية والمساحة والاتصال بـ Atlas، ثم اطلب من الفني الاستعادة من النسخ المحفوظة إذا لزم. اترك بيانات العملاء محفوظة.

ما المعلومات التي أرسلها للدعم؟

أرسل رقم الإصدار، واسم الاستضافة والخطة، والدومين، والخطوة التي توقفت عندها، ونص الخطأ بعد إخفاء المعلومات الخاصة. لا ترسل كلمة المرور أو رابط Atlas الكامل أو كود الترخيص أو ملف backend.env.