Wholly Crypto باستخدام Docker.

قبل أن تبدأ.

استخدم خادم Linux افتراضيًا جديدًا بمعمارية amd64 / x86-64 مع صلاحية root وBash وcurl. يعرض الإعداد تثبيت ما ينقص من Python 3.9+ وGit وDocker Engine وDocker Compose وBuildx بعد موافقتك.

ابدأ بمعالجَين افتراضيين وذاكرة 4 GB وقرص SSD بسعة 30 GB للاستخدام الخفيف. اترك مساحة للسجل وصور الحاويات والنسخ الاحتياطية.

الإعداد التلقائي للمتطلبات: Ubuntu 22.04/24.04/26.04 وDebian 12/13 وFedora 43/44/45 وRHEL 9/10. على التوزيعات الأخرى، ثبّت المتطلبات أولًا.

أبقِ المنفذين 80 و443 غير مستخدمَين ومفتوحَين في جدارَي الحماية. وجّه سجلات DNS للتاجر والدفع وAPI إلى الخادم. مع Cloudflare، استخدم DNS-only أثناء الإعداد؛ ثم شغّل الوكيل بعد انتهاء التحقق من HTTPS.

اختر Docker أو أداة التثبيت المباشر. لا ينقل إعداد Docker تثبيتًا موجودًا ولا يوقف خادم ويب آخر.

ثبّت بأمر واحد.

bash <(curl -fsSL https://raw.githubusercontent.com/whollycrypto-com/whollycrypto-docker/v1.1.1/install.sh)

اختر النطاقات وIP الخادم العام وبريد تجديد الشهادات والعملة النقدية وبيانات Basic Auth. القيم الافتراضية هي merchant.example.com, pay.example.com و api.example.com. يمكنك اختيار أسماء نطاقات فرعية أخرى.

يبني الإعداد صورة التشغيل، ويتحقق من تنزيل التاجر الموقّع، ويشغّل PostgreSQL 18 ويصدر شهادات HTTPS. GitHub بديل للتنزيل. لا تحتاج إلى مصدر برنامج التاجر أو مترجم Rust أو عقدة بلوكتشين.

يُحتفظ بمحركات الحاويات والحاويات ووحدات التخزين الموجودة. يتوقف الإعداد للمراجعة اليدوية إذا وجد حزمًا متعارضة.

انتظر ظهور جاهز: https://… في السجل. افتح ذلك العنوان وأدخل بيانات Basic Auth وأنشئ حساب المسؤول. إذا توقف الإعداد، أصلح المشكلة المذكورة وشغّل ./whollycrypto-docker resume. تُحفظ مفاتيح المحافظ الموجودة دون استبدال.

المستودع ودليل الإعداد الكامل ↖

أدِر التثبيت.

شغّل هذه الأوامر من /root/whollycrypto-docker. تعمل لوحة التحكم والدفع وAPI وقواعد رصيد المعالجة كما في التثبيت المباشر.

الإعدادات ← النظام يمكنه تثبيت تحديثات التاجر أيضًا. إعادة بناء صورة Docker لا تستبدل برنامج التاجر المثبّت ولا تتجاوز فحوصات التحديث. حدّث اعتماديات الحاوية منفصلة وفق تعليمات تحديث التشغيل في المستودع.

احتفظ بنسخة خارج الخادم.

./whollycrypto-docker backup

توقف هذه النسخة الكاملة صفحة الدفع لفترة قصيرة. تحفظ قاعدة البيانات وملفات التاجر ومفتاح تشفير المحافظ وNginx والشهادات وأسرار الإعداد المطابقة وتتحقق منها. انسخ مجلد النسخة المؤرّخ كاملًا إلى تخزين آمن غير متصل.

تحتوي النسخ الاحتياطية على مفاتيح خاصة وبيانات دخول غير مشفّرة. لا تضعها في Git أو مجلد عام أبدًا. صدّر نسخ محافظ المشاريع من اللوحة أيضًا. تحتاج محافظ Lightning المتصلة إلى إجراء استعادة خاص بها.

لا تستخدم أبدًا docker compose down -v لإصلاح خطأ. فهو يحذف وحدات التخزين الدائمة وقد يدمّر مفاتيح المحافظ وسجل المدفوعات. استخدم ./whollycrypto-docker stop للإيقاف دون حذف البيانات. اتبع دليل الاستعادة قبل الاستعادة.

مكونات قليلة. وبيانات منفصلة.

حاويتان: برنامج التاجر مع Nginx، وPostgreSQL. تبقى البيانات عند استبدال الحاويات في وحدات تخزين مسمّاة. تستخدم القاعدة مقبس Unix خاصًا؛ ولا يُكشف المنفذان 5432 و8080. لا تحتاج إلى وضع privileged أو شبكة المضيف أو مقبس Docker للمضيف.

يستخدم Docker عزل الحاويات، لا عزل systemd في المثبّت المباشر. لا يزال بإمكان root ومسؤولي Docker الوصول إلى مفاتيحك. أبقِ Basic Auth وقيود IP المناسبة للنطاقات وAPI مفعّلة. قد يتجاوز نشر منافذ Docker قواعد UFW؛ راجع جدار حماية المزوّد و إرشادات جدار حماية Docker.

يستهدف إعداد Docker الأول Linux amd64 مع Nginx الخاص به. لا تُدعم بعد إعدادات ARM64 أو Docker Desktop أو Docker دون root أو وكيل عكسي إضافي.