البنية
مدير خوادم Minecraft هو تطبيق Node.js أحادي العملية، يعرض الصفحات من جانب الخادم. يدير خوادم Minecraft التي تعمل كحاويات Docker باستخدام صورة itzg/docker-minecraft-server، ويتواصل مع Docker daemon عبر واجهة برمجة التطبيقات الخاصة به (لا يتم استخدام سطر أوامر docker أبدًا).
شكل وقت التشغيل
Section titled “شكل وقت التشغيل”- يقوم Express + Handlebars بعرض الصفحات من جانب الخادم. لا يوجد تطبيق صفحة واحدة (SPA)؛ JavaScript الخاص بالمتصفح في
public/js/مكتوب يدويًا لتحسين الأداء التدريجي. تقوم خطوة esbuild (pnpm run build:js) بتجميع وتصغيره فيpublic/dist/js/؛ ويقدم التطبيق هذه الحزمة عندما تكون موجودة، وإلا فإنه يقدم المصدر الأصلي، لذا فإن تشغيل التطوير بدون بناء لا يزال يعمل. node:sqlite(مدمج في Node؛ تتطلب اللوحة Node ≥ 24) هو قاعدة البيانات - متزامنة، بدون وحدات أصلية، وضع WAL. يقوم مشغل ترحيل صغير ذو إصدارات بتطبيقsrc/db/migrations/*عند التشغيل. يتم تخزين العبارات المُعدة مؤقتًا فيsrc/db/index.jsمفتاحها هو نص SQL.- يحمل
wsتدفقات وحدة التحكم والإحصائيات المباشرة. كلاهما وسيط: تدفقdocker logs --followواحد (أوdocker stats) لكل خادم، يتم فك تجميعه مرة واحدة وتوزيعه على كل علامة تبويب متصلة، بدلاً من تدفق واحد لكل عارض. يحتفظ وسيط وحدة التحكم بمخزن مؤقت صغير لإعادة التشغيل لعلامات التبويب التي تنضم متأخرًا ويسقط المشترك الذي يتأخر مقبس الاتصال الخاص به كثيرًا بدلاً من تعطيل التدفق المشترك. - dockerode هي الطريقة الوحيدة التي يتحدث بها التطبيق إلى Docker. يتم الكشف عن نقطة النهاية تلقائيًا لكل منصة (أنبوب Windows المسمى مقابل مقبس Unix).
- جميع الحالات المستمرة تعيش تحت دليل واحد (
$DATA_DIR، الافتراضي./data). يؤدي نسخ هذا الدليل إلى ترحيل اللوحة بأكملها.
الطبقات
Section titled “الطبقات”تتدفق التبعيات في اتجاه واحد:
┌─────────────────────────────┐ HTTP ───────▶│ web/routes/* (+ middleware)│ parse & validate input, shape responses └──────────────┬──────────────┘ │ ┌──────────────▼──────────────┐ │ services/* │ domain logic (the actual features) └───┬─────────┬─────────┬─────┘ │ │ │ ┌────────────▼──┐ ┌────▼────┐ ┌──▼──────────┐ │ docker/* │ │ db/* │ │ storage/* │ infrastructure └───────────────┘ └─────────┘ └─────────────┘web/routes/- موجه واحد لكل مجال (players,worlds,crashes,blueprints,files, …). يقومweb/app.jsبتثبيت الموجهات ذات المستوى الأعلى (api.js، واجهة برمجة تطبيقات JSON للجلسة التي تحتوي أيضًا على مسارات الخادم الأساسية وتثبت موجهات المجال لكل خادم؛index.js، الصفحات؛auth،account،tasks، …). تقوم الموجهات بالتحقق من الصحة باستخدام zod، وتستدعي خدمة، وتعيد JSON أو تعرض عرضًا. لا ينتمي منطق العمل هنا. يتم تثبيت موجهين في المنطقة العامة، قبلrequireAuth:routes/status.js(صفحات حالة HTML اختيارية لكل خادم) وroutes/apiV1.js(/api/v1، واجهة برمجة تطبيقات JSON للقراءة فقط مصادقة بواسطة رمز مميز Bearer صادر عن المسؤول منservices/apiTokens.js، معطلة ما لم يتم تمكينها في الإعدادات؛ انظرdocs/public-api.md).services/- قلب التطبيق. تمتلك كل خدمة مجالًا واحدًا وقد تعتمد على البنية التحتية وعلى خدمات أخرى.docker/- أغلفة dockerode:connect(الكشف عن نقطة النهاية + صحة daemon)،containers(إنشاء/بدء/إيقاف/إعادة إنشاء مع ربط المجلدات، وحدود الذاكرة/وحدة المعالجة المركزية، والتسميات)،logs،stats،images،networks(اكتشاف شبكة المضيف)،hostPath(إعادة توجيه مسارات الربط تحتDATA_DIR_HOST)، وwatcherيحول أحداث Docker إلى سجل + اكتشاف الأعطال.db/- غلاف SQLite ومشغل الترحيل.storage/- تهيئة./data، وحارس المسار (safeJoin، العمود الفقري لسلامة الملفات)، ومؤشر الحجم في الخلفية + تطبيق الحصص.
عبر القطاعات:
config/- تكوين البيئة بالإضافة إلى كتالوج الحقول: المصدر الوحيد للحقيقة لإعدادات الخادم. يتم فهرسة كل متغير بيئة itzg (التسمية، المساعدة، النوع، الوحدة، الافتراضي، التحقق من الصحة، القسم، علامات الخطر). يتم اشتقاق المعالج ونماذج الإعدادات والتحقق من صحة zod منه، لذا فإن كشف إعداد جديد هو تغيير بيانات، وليس سباكة واجهة مستخدم جديدة.events/-recordEvent()هي نقطة الدخول الوحيدة لسجل التاريخ؛ تلتقط أحداث دورة الحياة أيضًا مقتطفات سجل الحاوية إلىdata/logs/<id>/events/.ws/- WebSockets لوحدة التحكم والإحصائيات المصادق عليها (يتم التحقق من ملف تعريف الارتباط الخاص بالجلسة عند الترقية، ويتم فحصOriginلمنع اختطاف المواقع المشتركة)، يتم وسيطتها لكل خادم (انظر “شكل وقت التشغيل”).logger.js+instrument.js-require('./logger')(label)يعيد مسجل Pino لكل وحدة؛ المستوى منLOG_LEVEL،makeFailureThrottle()يحافظ على حلقة خلفية فاشلة باستمرار لسطر سجل واحد بالإضافة إلى سطر “تم الاسترداد”. يقومsrc/utils/logSanitize.jsبحذف المفاتيح التي تشبه بيانات الاعتماد ورموز webhook من البيانات الوصفية المهيكلة؛src/config/logLevel.jsهي قائمة السماح المشتركة للمستوى (مفصولة لتجنب دورة التطلب معconfig).src/instrument.jsهو وصلة Sentry خاملة، يتم تحميلها أولاً فيsrc/server.js.src/web/middleware/requestLog.jsيكتب سطر سجل وصول واحد لكل طلب (يتخطى/healthzوالأصول الثابتة). يفرض ESLintno-consoleتحتsrc/**، مع استثناءpreflight.jsوinstrument.jsوconfig/index.js(يتم تشغيلها قبل وجود المسجل).- تحديد المعدل -
src/web/middleware/rateLimit.jsيضعexpress-rate-limitأمام/api(RATE_LIMIT_API_PER_MIN، الافتراضي 1200) وطلبات POST لتسجيل الدخول / المصادقة الثنائية / الإعداد (RATE_LIMIT_AUTH_PER_15MIN، الافتراضي 100)؛0يعطل المحدد. يعتمد علىreq.ip، لذا فإنTRUST_PROXYمهم خلف وكيل. يحتوي/api/v1على محددات خاصة به: حد لكل عنوان IP للعميل (خمسة أضعاف ميزانية الرمز المميز) يعمل قبل التحقق من الرمز المميز، ثم ميزانية لكل رمز مميز (RATE_LIMIT_PUBLIC_API_PER_MIN، الافتراضي 120) مفتاحها هو معرف الرمز المميز الذي تم التحقق منه. يتعامل عداد ناعم منفصل لكل حساب فيsrc/web/middleware/auth.jsمع قفل تسجيل الدخول (لكل IP وعام للحساب، يتلاشى). - الترخيص: طبقتان. الدور العام (
requireAuth→requireRole/requireWriteفيsrc/web/middleware/auth.js) يحمي الإجراءات على مستوى اللوحة وهو الافتراضي على كل خادم. أذونات لكل خادم (src/services/permissions.js، تسع قدرات مخزنة كقائمة JSON لكل(user, server)فيuser_server_permissions) تنقح هذا الافتراضي لخادم واحد؛ كل مسار/api/servers/:id، وتثبيت موجه فرعي، وصفحة، وWebSocket، وقائمة على مستوى الأسطول تمر عبرsrc/web/middleware/serverAccess.js(serverScope، مثبت على بادئة/servers/:idلكل من واجهة برمجة التطبيقات وموجه الصفحة، يخفي الخادم بدونviewكخطأ 404؛requireCap(cap)يسمي القدرة التي يحتاجها المسار). الكتابات التي تسمي خادمها في النص (الجداول الزمنية، استخراج وتثبيت العالم، تصدير المخطط) مفتوحة للمشاهدين بواسطةrequireWriteفقط لهذا الخادم، ويتحقق كل مسار من هذه القدرة بنفسه.test/permissions-routes.test.jsيتتبع مكدسات الموجه المباشر ويفشل إذا كان مسار الكتابة أو التثبيت أو الصفحة ذات النطاق الخادم لا يحتوي على بوابة.
سلوكيات المجال الرئيسية
Section titled “سلوكيات المجال الرئيسية”- حزم التعديل مثبتة دائمًا. تقوم الصورة بترقية الحزم غير المثبتة تلقائيًا عند كل إعادة تشغيل، لذا تقوم اللوحة بحل “الأحدث” إلى معرف إصدار محدد وقت التثبيت وتثبيته. الترقيات هي تدفق منسق صريح (
updates/): معاينة ← نسخ احتياطي قبل التحديث ← إيقاف تشغيل سلس ← إعادة تثبيت ← إعادة إنشاء ← مراقبة الصحة ← استعادة بنقرة واحدة. - تراكب التعديلات المخصصة تتم إدارته بواسطة اللوحة: التعديلات التي يضيفها المستخدم تهبط في المكتبة المزالة التكرار ويتم ربطها بقوة بالخادم بحيث تبقى على قيد الحياة بعد تحديثات الحزمة. يتم تعطيلها مع مراعاة الفئة. نظرًا لأن المكتبة تحتفظ بكل بناء تم تنزيله، فإن التحديث يسجل البناء الذي استبدله (
server_content.previous_*) ويمكن التراجع عنه من الملفات المحلية وحدها. يؤدي تعطيل تعديل الحزمة إلى كتابة متغير بيئة استبعاد الحزمة بدلاً من ذلك؛ يحملpacks.applyPackذلك وبقية ضبط الحزمة (PACK_TUNING_KEYS) عبر تغيير إصدار نفس الحزمة، ويسقطها عند تغيير الحزمة. - يجب كسب ترقية إصدار Minecraft. يقوم
services/compat.jsبمسح تعديلات الخادم - التي يتم حلها من الصفوف المثبتة باللوحة، ثم بيان حزمة CurseForge، ثم عن طريق تجزئة المحتوى مقابل Modrinth/CurseForge - ويبني مصفوفة دعم (المحمل، إصدار Minecraft) لكل مشروع منlatestFilesIndexesفي CurseForge (200 مشروعًا لكل طلب) وقائمة إصدارات Modrinth لكل مشروع (طلب واحد لكل مشروع، وهو ما يحافظ على اقتران المحمل والإصدار). يقدم مدقق التحديث أحدث إصدار يدعمه كل تعديل فقط، ولا يقدم أي شيء على الإطلاق عندما لا يمكن تحديد الإجابة: لا يوجد مسح، أو مسح لإصدار أو محمل مختلف، أو مسح لم ينتهِ أبدًا، أو ملف jar لا يتعرف عليه أي سجل. عمليات المسح يدوية فقط، وتعيش تقدمها ونتائجها الجزئية فيversion_compat(وليس فيservices/tasks.jsفي الذاكرة)، لذا فإن التحديث أو إعادة تشغيل اللوحة يستأنف بدلاً من التعليق على مؤشر الدوران؛ يقومreconcileScans()بتمييز عمليات المسح التي تم إيقافها بسبب إيقاف التشغيل عند التمهيد التالي. - إصدار محمل التعديل هو تثبيت، مثل أي شيء آخر. يقرأ
services/loaderPin.jsالبناء المثبت من بيان تثبيت الصورة الخاص بها (.forge-manifest.jsonوالأصدقاء) ويكتب التثبيت: متغير itzg للمحمل على خادم عادي (FORGE_VERSION، …)، أوCF_MOD_LOADER_VERSIONعلى حزمة Forge أو Fabric CurseForge، والذي يتجاوز الإصدار الذي تعلنه الحزمة. يتجاهل مثبت CurseForge الخاص بالصورة هذا التجاوز لـ NeoForge، ولا تحتوي حزم Modrinth وFTB على أي تجاوز، لذا يتبع محملها الحزمة. يقومpacks.applyPackبتجريد كل متغيرCF_عند تحديث الحزمة أو التراجع عنها، مما يسقط التجاوز مع البقية. يتم فحص بناء مكتوب مقابل القائمة الكاملة للسجل أولاً (services/loaderVersions.js؛ يأتي Forge من بياناته الوصفية maven، والتي تتخطى الأرقام؛ يتم إعادة فحص الفشل مرة واحدة مقابل السجل نفسه)، ثم يتم إجراء التغيير نسخ احتياطي ← تثبيت (فوق البيئة كما هي بعد النسخ الاحتياطي) ← إعادة بناء. - المنافذ يتم تخصيصها من مخطط أساسي (اللعبة من
PORT_GAME_STARTصعودًا، RCON = اللعبة +PORT_RCON_OFFSET، Bedrock منPORT_BEDROCK_START)، ويتم فحصها للتأكد من توفرها، وحجزها في قاعدة البيانات. “المأخوذ” هو اتحاد مطالبات كل خادم (المنافذ المباشرة، بالإضافة إلى زوج معلق أدناه)، وكل منفذ مضيف تنشره أي حاوية Docker (containers.publishedHostPorts: ارتباطات الحاويات قيد التشغيل المباشرة بالإضافة إلى المنافذ المكونة لكل حاوية متوقفة، لأن فحص ربط نظام التشغيل من داخل حاوية اللوحة الخاصة بها يرى فقط مساحة اسم شبكة تلك الحاوية)، وفحص نظام التشغيل. يتم تخزين جزء Docker مؤقتًا لمدة 3 ثوانٍ ومحدود: قائمة لا تستجيب في 2.5 ثانية تسقط جزء Docker فقط، ويكلف الفحص البطيء منافذ تلك الحاوية فقط. يقوم إنشاء الخادم وservers.changeGamePortباختيار المنافذ من خلال سلسلة تسلسل واحدة تغطي فقط الاختيار والمطالبة به (كتابة الصف لإنشاء، الحجز في الذاكرة لتغيير المنفذ)؛ لا يوجد منتقي منفذ BlueMap وتجاوزات المنافذ الإضافية فيه ولا يستشيران Docker. يتم تطبيق تغيير المنفذ على خادم موجود (servers.changeGamePort، تحت قفل عملية الخادم) على الفور، لأن Docker يثبت ارتباطات المنفذ عند إنشاء الحاوية: يتم فحص الزوج الجديد (RCON دائمًا اللعبة +PORT_RCON_OFFSET) وحجزه في الذاكرة (ports.reserve، كل من الزوج القديم والجديد، يتم احترامهما بواسطة كل اختيار آخر) تحت قفل المنفذ. يتم رفضه (409PENDING_CHANGES) بينما تنتظر الإعدادات الأخرى إعادة البناء، لذا فإنه يعيد بناء حاوية كانت تعمل بالفعل، على منفذ جديد؛ ولا يتم تغيير خادم قيد التشغيل إلا عندما يطلب الطلبrestart: true(وإلا 409NEEDS_CONFIRM). يتم سحب الصورة ويتم فحص اسم حاوية مخصص قبل لمس أي شيء. يتم إيقاف خادم قيد التشغيل؛ ثم يتم كتابة الزوج الجديد معpending_recreate = 1(لذا فإن تعطل اللوحة من هناك يترك “إعادة بناء معلقة” صادقة)، تتم إزالة الحاوية، وإعادة بنائها على الزوج الجديد وبدء تشغيلها. إذا فشلت أي خطوة بعد الإيقاف، يقومputBackOnOldPortبإعادة كتابة الزوج القديم، وإعادة البناء (وإعادة التشغيل، إذا كانت تعمل) عليه ويسجل الخطوة التي فشلت؛ يخبر التاريخ والتنبيهات إذا فشل ذلك أيضًا، مما يترك الخادم متوقفًا حتى يقوم شخص ما ببدء تشغيله. قدرةsettingsكافية، بما في ذلك الخادم قيد التشغيل. يمكن لغير المسؤولين اختيار فقط منPORT_GAME_STARTصعودًا. (أعمدةport_*_pendingمن الترحيل 029 تنتمي إلى تصميم سابق غير منشور وغير مستخدمة؛ 031 يمسحها.) يجيب تصادم القفل 409 معcode: 'BUSY'، والذي يتحقق منه المتصلون الذين يعيدون المحاولة أدناه بدلاً من الصياغة. إعادة التشغيل التلقائي بعد التعطل (watcher.restartAfterCrash) والنسخ الاحتياطي المجدول أو البدء (scheduler.runTaskWithRetry) التي تجد الخادم مشغولًا بإجراء آخر تحاول مرة أخرى كل 20 ثانية / 60 ثانية لمدة تصل إلى 30 دقيقة، وتحديث الحزمة أو التراجع يعيد محاولة خطواته المقفلة بنفس الطريقة (opLock.retryWhileBusy)؛ إعادة تشغيل بعد التعطل أو بدء مجدول ينتظر يتوقف بمجرد أن يقوم شخص ما بإيقاف أو قتل أو بدء تشغيل الخادم منذ ذلك الحين (events.lifecycleActionSince)، وإعادة تشغيل بعد التعطل أيضًا عندما يكون إعادة التشغيل التلقائي معطلًا أو الخادم غير موجود. لا يتم إعادة محاولة عمليات إعادة التشغيل والإيقاف والأوامر المجدولة، ويتخطى الجدول الزمني الذي لا يزال تشغيله الأخير ينتظر تشغيله التالي. - حصص القرص يتم فرضها بواسطة اللوحة لأن Docker لا يمكنه تحديد استخدام ربط المجلدات: يقوم الفهرس بتخزين أحجام كل دليل مؤقتًا ويتم حماية عمليات نمو القرص بناءً عليها.
- الأسرار (كلمات مرور RCON، مفاتيح API، أسرار TOTP، عنوان URL لـ Discord webhook) يتم تشفيرها في وضع السكون باستخدام AES-256-GCM باستخدام مفتاح عشوائي مخصص في
$DATA_DIR/.secret-key(الوضع0600، يتم إنشاؤه تلقائيًا). إنه مستقل عنSESSION_SECRET؛ يتم الاحتفاظ بمفتاح مشتق منSESSION_SECRETكخيار احتياطي لفك التشفير فقط للقيم المكتوبة قبل وجود المفتاح المخصص، ويقومsrc/services/secretsMigration.jsبإعادة تشفير تلك القيم تحت المفتاح المخصص مرة واحدة عند التمهيد..secret-keyموجود ولكنه لا يمكن تحليله هو خطأ تمهيد صعب (لا يتم إعادة إنشائه بصمت أبدًا). تقوم المخططات بتجريد جميع الأسرار عند التصدير. server.propertiesمملوكة للوحة ولكنها مظللة بالبيئة. تقوم صورة itzg بإعادة تأكيد كل خاصية مدعومة بالبيئة عند كل بدء تشغيل (OVERRIDE_SERVER_PROPERTIESافتراضيًا صحيح)، لذا فإن القيمة التي تعدلها اللوحة مباشرة - PvP/صعوبة World Controls، تبديل القائمة البيضاء، محرر الملفات - سيتم إعادتها بصمت عند البدء التالي ما لم يتم إزالة متغير البيئة المطابق وإعادة إنشاء الحاوية. تمر كل كتابة مباشرة للخاصية عبرwriteServerProperties()(الملف بأكمله) أوsetServerProperty()(مفتاح واحد) فيsrc/services/servers.js، والتي تعيد كتابة الملف بشكل ذري، وتلغي تعيين متغير البيئة خلف كل مفتاح متغير (عبر السمةprop:في حقول الكتالوج، يتم فحصها في الاختبارات مقابل تعريفات خصائص الصورة الخاصة بها)، وتضع علامةpending_recreate. يتم كتابة الصعوبة في الملف وكذلك إرسالها عبر RCON، لأن الخادم المخصص يعيد تطبيق خاصيةdifficultyعند كل تمهيد. يقوم Minecraft نفسه بإعادة حفظ server.properties من قيمه وقت التمهيد عندwhitelist on/off، مما سيلغي التعديلات التي تم إجراؤها أثناء تشغيل الخادم، لذا فإن تبديل القائمة البيضاء قيد التشغيل يلتقط الملف أولاً ويعيد كتابته مع تغييرwhite-listفقط. تظل متغيرات البيئة قابلة للتكوين بالكامل عند الإنشاء (يعرضها المعالج ويتم تطبيقها مرة واحدة)؛ يتم إلغاء تثبيتها فقط في المرة الأولى التي تعدل فيها اللوحة الخاصية الأساسية. MOTD هو نفس العقد: يؤدي التعديل المباشر لملفmotdإلى إلغاء تعيينه، لذا فإن آخر كتابة تفوز.
تنسيقات البيانات والأسلاك
Section titled “تنسيقات البيانات والأسلاك”data/panel.db- قاعدة بيانات SQLite. يتم أخذ لقطة يوميًا عبرVACUUM INTOإلىdata/backups/_panel/(يتم الاحتفاظ بأحدث 14 لقطة)؛ يتم تشغيلPRAGMA integrity_checkعند التمهيد.data/.session-secret- سر توقيع ملف تعريف الارتباط الذي يتم إنشاؤه تلقائيًا، يتم إنشاؤه عند التشغيل الأول إذا لم يتم تعيينSESSION_SECRET. يؤدي حذفه إلى تدوير السر (مما يبطل الجلسات).data/.secret-key- مفتاح التشفير المخصص 32 بايت في وضع السكون (الوضع0600)، يتم إنشاؤه تلقائيًا عند التشغيل الأول. مستقل عنSESSION_SECRET؛ يؤدي حذفه إلى جعل كل بيانات اعتماد مخزنة غير قابلة للفك، لذا فهو ينتمي إلى نسخك الاحتياطية.- المخططات (
.mcserver.zip) - ملف مضغوط يحتوي علىmanifest.jsonيصف التكوين والموارد ومرجع الحزمة المثبتة وبيان التراكب (عناوين URL المصدر + sha256) وملفات التكوين المختارة، واختياريًا عالم. يقوم الاستيراد بإعادة تنزيل كل تعديل والتحقق من تجزئته وتعيين منافذ جديدة. - حاويات Docker التي تم إنشاؤها بواسطة اللوحة يتم تسميتها وتصنيفها بحيث يمكن للمراقب العثور عليها؛ تمتلك اللوحة دورة حياتها الكاملة.
تسلسل التمهيد
Section titled “تسلسل التمهيد”require('./instrument')(وصلة Sentry) قبل أي شيء آخر، ثمrequire('./preflight')للفشل بوضوح عند إصدار Node غير مدعوم.- تحميل التكوين؛ التأكد من/إنشاء
.session-secretو.secret-key. ensureDataRoot()- إنشاء تخطيط./data، مسحtmp/.- تشغيل ترحيلات قاعدة البيانات، ثم
PRAGMA integrity_check(يسجل بصوت عالٍ، ويشير إلىdata/backups/_panelعند الفشل). - إعادة تشفير أي أسرار قديمة مفتاحها
SESSION_SECRETتحت.secret-key(secretsMigration). - استيراد مفاتيح API من البيئة مرة واحدة (
apiKeys.importFromEnvOnce())، تثبيت أي خادم لا يزال يحمل محدد حزمة تعديل غير مثبت (packPins.pinUnpinnedServers())، وضع علامة على عمليات مسح توافق الإصدار التي تركت قيد التشغيل بواسطة عملية سابقة على أنها مقاطعة (compat.reconcileScans())، ثم بذر المخططات الأولية (محمية). - بدء تشغيل خادم HTTP + WS. عند ربط مكشوف، اطبع رقم التعريف الشخصي
/setupللتشغيل الأول. - تثبيت حارس وقت التشغيل بعد التمهيد (يلتقط الأخطاء غير المعالجة؛
MSM_EXIT_ON_FATAL=1يجعله يخرج بقوة للنشر تحت الإشراف). - بدء تشغيل الخدمات الخلفية: وسيط WS، مفهرس التخزين، مراقبو الأعطال والمخزون، المجدول، جسر أحداث Discord، مراقب التواصل مع الروبوتات، ومؤقت الصيانة اليومي (تقليم صفوف التحليلات القديمة، نصوص الروبوتات، سجل الأحداث (365 يومًا) وصفوف ذاكرة التخزين المؤقت لواجهة برمجة التطبيقات، ثم أخذ لقطة لـ
panel.db). - تهيئة Docker في الخلفية. واجهة المستخدم قابلة للاستخدام بالكامل بينما يكون daemon معطلاً؛ تضيء ميزات Docker عندما يصبح قابلاً للوصول. بمجرد الاتصال، يقوم
refreshStatuses({ boot })بتسوية الحالات المخزنة مؤقتًا، ويصدر حدثoffline-after-restartلمرة واحدة لخادم كان يعمل قبل إعادة تشغيل اللوحة ولن يتم إعادته، وتبدأ حلقة التمهيد خوادمauto_startبالإضافة إلى استعادة خوادمauto_restartالتي تم العثور عليها معطلة أثناء الانقطاع (مع احترام التراجع عن حلقة التعطل).
ترتيب instrument-before-preflight هو مقايضة متعمدة: يسمح لربط Sentry المستقبلي بتصحيح وقت التشغيل أولاً، على حساب رسالة أقل ودية قليلاً على Node قديم حقًا.
خط أنابيب البناء
Section titled “خط أنابيب البناء”pnpm run build = build:css (Tailwind → public/css/app.css) + build:js (esbuild → public/dist/js/، ESM مع تقسيم التعليمات البرمجية). postinstall يشغل CSS فقط. public/css/app.css وpublic/dist/ هي عناصر بناء يتم تجاهلها بواسطة Git؛ تقوم مرحلة بناء Dockerfile بتشغيل pnpm run build بالكامل وتنسخ public/ إلى صورة وقت التشغيل. يتم تقديم الأصول الثابتة immutable/ذاكرة تخزين مؤقت طويلة للملفات ذات البصمة، وذاكرة تخزين مؤقت قصيرة لـ CSS/JS، وno-cache لـ HTML و/api.