تخطي إلى المحتوى الرئيسي

توجيه المواقع الإلكترونية وتعدد المواقع

يمكن الآن لكنيسة واحدة أن تخدم أكثر من موقع إلكتروني مميز، ويمكن أن يقع كل موقع على نطاق فرعي *.b1.church أو على نطاق مخصص بالكامل تملكه الكنيسة. تستعرض هذه الصفحة طبقة التوجيه الواقعة أسفل منشئ المواقع: كيف يتم تحويل الطلب الوارد إلى كنيسة وإلى موقع محدد، ونموذج البيانات الخاص بتعدد المواقع (القيمة الحارسة siteId التي تُبقي كل موقع موجود مسبقًا يعمل كما كان)، وحافة النطاقات المخصصة، وهي وكيل Caddy مُدار ذاتيًا على EC2 يُنهي طبقة TLS ويعيد كتابة كل نطاق كنيسة إلى المصدر *.b1.church الخاص به. أما ما يُعرض فعليًا بعد حل الطلب، أي شجرة الصفحات والأقسام والعناصر، فراجع منشئ المواقع الإلكترونية.

نظرة عامة​

   grace.b1.church              www.gracechurch.org  (custom domain)
(b1.church subdomain) │
│ ▼
│ ┌──────────────────────────────────────────┐
│ │ Caddy edge — EC2 3.23.251.61 │
│ │ (proxy.b1.church) │
│ │ • terminates TLS (per-domain LE cert) │
│ │ • rewrites Host → {sub}.b1.church │
│ │ • reverse-proxies to B1App │
│ └────────────────────┬─────────────────────┘
│ Host = {sub}.b1.church
▼ ▼
┌────────────────────────────────────────────────────────────┐
│ B1App src/middleware.ts │
│ • always: delete any client-supplied x-site (anti-spoof) │
│ • internal *.b1.church Host ⇒ domains lookup stays inert │
│ • raw custom Host (bypassing Caddy) ⇒ lookup → set x-site │
└───────────────────────────┬────────────────────────────────┘
▼ next.config.mjs → host first-label → /[sdSlug]/…
┌─────────────────────────────────────────────────┐
│ [sdSlug] · ConfigHelper.load(sdSlug) │
│ GET /membership/churches/lookup/?subDomain=… │
│ → { id, name, subDomain, siteId? } │
│ threads ?siteId= into every content call: │
│ /content/pages/:id/tree · /globalStyles · │
│ /blocks/public/footer · /links · sitemap │
└─────────────────────────────────────────────────┘

domain save/delete (B1Admin Settings→Domains → POST /membership/domains)
└─ best-effort CaddyHelper.updateCaddy() (wrapped, non-fatal, 10s timeout)
Caddy reads the domains table itself via two anonymous endpoints:
GET /membership/domains/authorize — on-demand-TLS `ask` (200 known / 404 unknown)
GET /membership/domains/hostmap — host→{sub}.b1.church map (5-min refresh)

تنطبق ثلاث قواعد على هذه الطبقة:

  1. تحافظ قيمة حارسة على التوافق مع الإصدارات السابقة. siteId = '' هو الموقع الرئيسي. كل صفحة وكتلة ورابط ونمط عام وصف نطاق كان موجودًا قبل هذه الميزة يحمل القيمة '' ويُعرض تمامًا كما كان. الموقع الثاني ليس سوى مجموعة من الصفوف ذات siteId غير فارغ، وأي نقطة نهاية للمحتوى تُستدعى بدون ?siteId= تُرجع الموقع الرئيسي، أي الطلب القديم نفسه بالبايت.
  2. يعتمد الحل على تسمية المضيف ويتقارب. يُوجَّه النطاق الفرعي *.b1.church مباشرة وفق تسمية مضيفه. أما النطاق المخصص فتُعاد كتابته إلى تسمية {sub}.b1.church عند حافة Caddy قبل أن يراه B1App (مع بحث في قاعدة البيانات عبر الوسيط يضبط ترويسة x-site كخيار احتياطي لأي Host مخصص خام). يصل المساران إلى المسار [sdSlug] نفسه وإلى الاستدعاء churches/lookup نفسه، لذا يكون العرض اللاحق متطابقًا تمامًا.
  3. حافة Caddy عديمة الحالة فوق مصدر حقيقة واحد. تنتهي النطاقات المخصصة عند وكيل Caddy مُدار ذاتيًا على EC2 يعيد كتابة كل نطاق إلى المصدر {sub}.b1.church الخاص به. يُطلق حفظ النطاق استدعاءً واحدًا CaddyHelper.updateCaddy() بأفضل جهد ممكن، كما يقرأ Caddy جدول domains مباشرة عبر نقطتي authorize وhostmap الموضحتين أدناه. الجدول هو المصدر المعتمد، ولا يمكن لعدم وصول Caddy أن يُفشل عملية حفظ أبدًا.

حل الموقع​

النطاقات الفرعية *.b1.church​

يعيد الملف B1App/next.config.mjs كتابة الطلبات الواردة حسب المضيف. تلتقط قاعدة المضيف بالنمط (?<subdomain>.*?)\..* التسمية الأولى للمضيف، وتعيد كتابة / و/:path* إلى /{subdomain}، أي إلى القطعة [sdSlug] في App Router. لذلك يتحول grace.b1.church/about إلى /grace/about.

داخل src/app/[sdSlug]/، تستدعي ConfigHelper.load(sdSlug) (في src/helpers/ConfigHelper.ts) المسار GET /membership/churches/lookup/?subDomain={sdSlug}. تحتوي استجابة ChurchController.getBySubDomain الآن على فرعين:

المعرّف المطابقالاستجابةالمعنى
churches.subDomain{ id, name, subDomain }الموقع الرئيسي لتلك الكنيسة
sites.subDomain{ id, name, subDomain, siteId }موقع ثانوي: يرجع المتحكم إلى جدول sites، ويحدد الكنيسة المالكة، ويعيد المعرّف المطلوب مع الحقل الإضافي siteId

هذا الحقل الإضافي siteId هو الشيء الوحيد الذي يميز طلب الموقع الثانوي عن الطلب الرئيسي، وكل ما عداه في المسار مشترك بينهما.

إذا لم يطابق المعرّف أيًا من الجدولين، تُعاد الاستجابة {} مع الحالة 200. تتعامل ConfigHelper.load مع استجابة بلا id على أنها موقع غير معروف وتستدعي notFound() من Next، فيحصل النطاق الفرعي غير المعروف على خطأ 404 حقيقي بدلًا من أن تطلب كل الاستدعاءات اللاحقة المسار /…/undefined. كما يبني مسار صفحة المنشئ مسار الشجرة عبر pageTreePath() (في src/helpers/pageTreePath.ts)، والذي يرمّز المعرّف بصيغة URL، فيُعيد المعرّف المشوّه (المحتوي على الشرطات المائلة العكسية أو المسافات) خطأ 404 بدلًا من أن يظهر خطأ 400 من الواجهة البرمجية على شكل خطأ 500.

النطاقات المخصصة​

تنتهي النطاقات المخصصة التي تملكها الكنيسة عند حافة Caddy (المفصّلة أدناه)، التي تعيد كتابة ترويسة Host إلى {sub}.b1.church الخاص بالموقع قبل تمرير الطلب إلى B1App. لذلك في المسار الطبيعي يتلقى B1App مضيفًا داخليًا من النوع *.b1.church ويحله بتسمية المضيف تمامًا كما يحل نطاقًا فرعيًا أصليًا، ولا يُنفَّذ بحث الوسيط في قاعدة البيانات أبدًا. يعمل الملف src/middleware.ts على كل طلب، لكن له مهمة دائمة واحدة واحتياط واحد:

  1. دائمًا: يحذف أي ترويسة x-site يرسلها العميل. هذه الترويسة قابلة للانتحال كمدخل لإعادة الكتابة، ولا يُوثق بها إلا عندما يضبطها الوسيط نفسه، وتجريدها هو المهمة الحقيقية للوسيط خلف Caddy.
  2. احتياط، فقط للمضيف Host غير الداخلي: بالنسبة إلى ترويسة Host لنطاق مخصص خام تصل إلى B1App دون إعادة كتابة Caddy، يستدعي GET /membership/domains/public/lookup/{host}، وإذا أعاد subDomain يضبط x-site: {subDomain}.b1.church. خلف Caddy يكون هذا الفرع غير فعّال، لأن Host هو بالفعل *.b1.church.

تُتخطى الكشوف الداخلية، وهي localhost وb1.church واللواحق .b1.church و.localtest.me و.localhost و.up.railway.app و.vercel.app، ولا يُنفَّذ لها بحث على الإطلاق، لأنها بالفعل محلولة بقاعدة إعادة الكتابة بحسب تسمية المضيف، أو لأنها مضيفات معاينة ونشر.

يقوم البحث نفسه (DomainRepo.loadByName) بعملية LEFT JOIN بين domains → churches وdomains → sites، ويُعيد COALESCE(NULLIF(sites.subDomain,''), churches.subDomain)، أي نطاق الموقع الثانوي المعيّن إذا كان النطاق يشير إليه، وإلا فنطاق الكنيسة. يبحث أولًا عن المضيف الدقيق، فإذا بدأ ذلك المضيف بـ www. ولم يجد نتيجة، يعيد المحاولة مرة واحدة مع النطاق الجذري المجرد.

في next.config.mjs، توضع قواعد إعادة الكتابة لـ x-site قبل قواعد المضيف العامة، لتكون لها الأولوية. فالقيمة x-site: grace.b1.church تعطي التسمية الأولى grace، أي [sdSlug] = grace، ومن هنا يكون الحل مطابقًا تمامًا لمسار النطاق الفرعي (نفس churches/lookup ونفس siteId).

معلومة

ترويسة x-site غير موثوقة من الخارج. يجرد الوسيط دون شروط أي x-site واردة قبل أن يضبط ترويسته الخاصة اختياريًا، وقواعد إعادة الكتابة لا ترى إلا القيمة التي ضبطها الوسيط، فلا يستطيع العميل أن يفرض نفسه على محتوى كنيسة أخرى بإرسال ترويسة.

ملاحظات تشغيلية إضافية حول الوسيط:

  • التخزين المؤقت. تُخزَّن نتيجة كل مضيف (النجاح أو الفشل المؤكد، وليس خطأ الشبكة أبدًا) في الذاكرة ضمن Map لمدة 10 دقائق، لكل نسخة من بيئة Serverless.
  • المطابقة. يعيد المطابِق عن قصد تضمين /sitemap.xml و/robots.txt و/manifest.webmanifest. فالنمط الأول فيه يستبعد المسارات المحتوية على نقاط، وهذا كان سيُسقط تلك الملفات، لذا تُعاد إضافتها حتى تحصل ملفات SEO وPWA الخاصة بكل كنيسة على النطاق المخصص أيضًا على ترويسة x-site.
  • ترويسة الرابط القانوني. بالنسبة إلى صفحات الكنيسة، يُلحق الوسيط ترويسة استجابة Link: <{proto}://{host}{path}>; rel="canonical" تسمي المضيف الذي قُدمت منه الصفحة فعليًا، سواء كان نطاقًا فرعيًا أو نطاقًا مخصصًا (helpers/canonicalLink.ts). عندما يصل نطاق مخصص إلى B1App عبر وكيل Caddy، يكون مضيف الطلب هو النطاق الفرعي {sub}.b1.church، لذلك يستخدم الوسيط نطاق الزائر من X-Church-Host بدلًا منه، ولكن فقط بعد أن يؤكد /domains/public/lookup/{host} أن ذلك النطاق يشير إلى النطاق الفرعي نفسه (ownsSubdomain()). وعندئذ يسمي الرابط القانوني وrobots.txt وsitemap.xml النطاق المخصص بدلًا من النطاق الفرعي b1.church. ويُتخطى هذا على المضيفات غير الخاصة بالكنائس (b1.church وlocalhost و*.vercel.app و*.up.railway.app) وعلى /mobile و/login و/logout وملفات robots/sitemap/manifest المُولَّدة.

الموقع العام المعطّل​

يمكن للكنيسة تفعيل Disable Public Website في B1Admin (إعداد المحتوى على مستوى الكنيسة hidePublicSite = "true"). عندئذ يقدم الموقع مساراته الخاصة بالأعضاء فقط:

  • وسيط B1App يبحث عن النطاق الفرعي (/membership/churches/lookup ثم /content/settings/public/:churchId) ويعيد توجيه الطلبات المجهولة لأي مسار خارج قائمة السماح إلى /login?returnUrl={path}{query}. قائمة السماح (في helpers/publicSite.ts) هي /login و/logout و/mobile/* و/register/* و/guest-register وملفات manifest وrobots وsitemap. لا تُخزَّن إلا الإجابات المؤكدة، لمدة 60 ثانية في بيئة الإنتاج، لأن استدعاء إعادة التحقق من المدير لا يستطيع مسح هذه الخريطة الخاصة بكل نسخة؛ ولا تُخزَّن في بيئات التطوير والاختبار. وإذا حدث خطأ في الواجهة البرمجية، يُقدَّم الموقع بدلًا من قفل الجميع خارجه.
  • يرى الأعضاء المسجلون الدخول الموقع كاملًا. الطلب الذي يحمل ملف تعريف الارتباط jwt غير المنتهي الصلاحية (تقوم الدالة hasSession() في الوسيط بفك ترميز الحقل exp من الحمولة دون التحقق من التوقيع، وهذه بوابة لينة وليست تحكمًا في الوصول) يتخطى إعادة التوجيه، فبعد تسجيل الدخول يعود العضو إلى الصفحة التي طلبها ويرى الصفحات العادية والصفحات المدمجة (المجموعات والمواعظ وغيرها) والتنقل في الترويسة. لم تعد مكونات الصفحات وHeader تتحقق من hidePublicSite بنفسها.
  • يمنع robots.txt كل شيء، كما يفعل مع المضيفات المحجوبة من الفهرسة (noindex).
  • الواجهة البرمجية. يعيد GET /content/pages/public/:churchId (قائمة الصفحات في خريطة الموقع) القيمة []، فلا يستطيع المستدعون المجهولون عرض قائمة الصفحات.

تمرير siteId​

يحفظ ConfigHelper قيمة siteId المحلولة في ConfigurationInterface الخاص بالطلب (مع تخزين مؤقت عبر cache() من React)، ويضيف ?siteId= إلى استدعاءات المحتوى التي يقوم بها هو ومكونات الصفحات، بشكل مشروط: فالقيمة siteId الفارغة (نطاق فرعي للكنيسة الرئيسية) تحذف المعامل نهائيًا. ونقاط النهاية التي يمرَّر إليها هذا المعامل هي شجرة الصفحات (/content/pages/:id/tree) وقائمة الصفحات العامة المستخدمة في خريطة الموقع (/content/pages/public/:id) والأنماط العامة (/content/globalStyles/church/:id) وروابط التنقل (/content/links/church/:id) وكتلة التذييل المستقلة (/content/blocks/public/footer/:id). في مسار العرض الطبيعي يصل التذييل ضمن شجرة الصفحة (أقسام موسومة بـ zone: "siteFooter")، وقد جُلب بالفعل مع siteId، لذلك لا توجد فجوة في التذييل غير المحدد النطاق.

أما بوابة الأعضاء (B1App mobile) فهي خارج هذا النظام عن قصد: يحل loadChurchAppearance.ts الكنيسة عبر churches/lookup لكنه يقرأ /settings/public/{id} على مستوى الكنيسة ولا يمرر siteId أبدًا، فالبوابة على مستوى الكنيسة بأكملها في الإصدار الأول (انظر أدناه).

مواقع متعددة لكل كنيسة​

نموذج البيانات​

جدول membership.sites الجديد بسيط عن قصد:

العمودالنوعملاحظات
idchar(11) PK
churchIdchar(11)الكنيسة المالكة
namevarchar(255)اسم العرض (مثل "Español" أو "Youth")
subDomainvarchar(45)فهرس فريد — فضاء أسماء عام (انظر أدناه)

ثم يُضاف نطاق الموقع إلى جداول المحتوى والنطاقات عبر عمود واحد غير قابل للقيمة الفارغة:

الجدول (الوحدة)العمودمعنى ''
domains (membership)siteId char(11) NOT NULL DEFAULT ''يخدم النطاق الموقع الرئيسي
pages وlinks وglobalStyles وblocks (content)siteId char(11) NOT NULL DEFAULT ''الموقع الرئيسي، وفي جدول blocks تعني '' أيضًا مشتركة بين كل المواقع

يضيف ترحيلان كل هذا (tools/migrations/membership/2026-07-02_sites.ts وtools/migrations/content/2026-07-02_site_id.ts). ولأن العمود قيمته الافتراضية ''، تحتفظ كل الصفوف الموجودة بسلوكها الحالي دون الحاجة إلى ملء البيانات.

فضاء أسماء نطاقات فرعية عام. يشترك sites.subDomain في فضاء أسماء واحد مع churches.subDomain، فلا يمكن أن يتصادم نطاق فرعي لموقع مع نطاق فرعي لكنيسة أو لموقع آخر. يُفرض هذا في كلا مساري الحفظ: يرفض SiteController.save معرّفًا يطابق churches أو sites، ويفعل ChurchController.validateSave الشيء نفسه بالعكس. ويدعم فهرس فريد على `sites.subDomain> هذا على مستوى قاعدة البيانات.

توسيع فرادة الصفحات من (churchId, url) إلى (churchId, siteId, url)، لكي يملك موقعان من كنيسة واحدة كلٌّ منهما صفحة /about خاصة به.

محتوى لكل موقع مع احتياطات​

كل نقطة نهاية لـ قائمة/شجرة محتوى مخصصة للمواقع تقبل معامل ?siteId= اختياريًا (وعند غيابه تكون القيمة ''، أي الموقع الرئيسي): شجرة الصفحات وقائمتها والصفحات العامة، وقائمة الكتل وحسب النوع والتذييل، والروابط (المجهولة والمفلترة والكل)، والأنماط العامة. أما الأقسام والعناصر فلا تُحدَّد بالموقع مباشرة، بل ترث ذلك من الصفحة أو الكتلة الأب.

هناك سلسلتا حل تقومان بالعمل المثير للاهتمام:

  • الأنماط العامة — الموقع ← الرئيسي ← الافتراضي. تُرجع GlobalStyleRepo.loadForChurch(churchId, siteId) صف الموقع الخاص به؛ وإذا لم يكن لدى الموقع الثانوي صف، تُرجع صف الرئيسي ('') كما هو (مع الاحتفاظ بـ id/siteId الخاصين بالرئيسي، والذي يستخدمه العميل للنسخ عند الكتابة)؛ وإذا لم يوجد رئيسي أيضًا، يُرجع GlobalStyleController لوحة ألوان وخطوطًا افتراضية مكتوبة في الشيفرة.
  • كتلة التذييل — يفوز تذييل الموقع، ويعود المشترك احتياطيًا. تُرجع BlockRepo.loadByBlockType(churchId, "footerBlock", siteId) الصفوف المشتركة ('') وصفوف الموقع الخاصة معًا، ويختار المحلل تذييل الموقع الخاص إن وُجد، وإلا المشترك. ويعمل المنطق نفسه في TreeHelper.insertBlocks (شجرة الصفحة) وفي نقطة النهاية المستقلة /content/blocks/public/footer/:churchId.

تسلسل حذف الموقع​

يُزيل SiteController.delete (المشروط بصلاحية Settings→Edit في العضوية) الموقع الثانوي في ثلاث خطوات:

  1. يحذف ContentModuleGateway.deleteSiteContent(churchId, siteId) كل محتوى يملكه الموقع بالتسلسل: صفحاته ← أقسامها وعناصرها وpageHistory وposts الخاصة بها؛ وكتله ← أقسامها وعناصرها وpageHistory؛ وروابطه وglobalStyles. ويوجد حارس يرفض التشغيل مع ''، فالقيمة الحارسة للموقع الرئيسي/المشترك لا تُحذف أبدًا بالتسلسل.
  2. يُعيد DomainRepo.clearSiteId تعيين نطاقات الموقع إلى الرئيسي (siteId → '') بدلًا من حذفها، فيبقى النطاق المخصص بعد حذف الموقع.
  3. يُحذف صف sites، وتُعاد مزامنة مسارات Caddy (بأفضل جهد ممكن).

واجهة B1Admin​

الإمكانيةالمكانالآلية
مبدّل المواقعuseSiteSelection وSiteSwitcher (الفارغ = "Main Website")يقرأ معامل عنوان URL باسم ?site= ويمرره على شكل ?siteId= في استدعاءات ContentApi. متاح في مناطق القوائم الثلاث للمواقع: الصفحات والكتل والمظهر، لكن ليس في محرّرات الصفحات والكتل، لأنها تحمل siteId في السجل نفسه
إنشاء المواقع وحذفهاSitesDialog، ويُفتح من خيار "Manage websites…" في المبدّلPOST /membership/sites / DELETE /membership/sites/:id (الاسم والنطاق الفرعي). مشروط بصلاحية Settings→Edit في العضوية (Permissions.settings.edit على الخادم؛ وPermissions.membershipApi.settings.edit في B1Admin). إنشاء وحذف فقط — لا توجد واجهة لإعادة التسمية في الإصدار الأول
تعيين الموقع لكل نطاقDomainSettingsEdit ضمن الإعدادات ← النطاقاتقائمة منسدلة للموقع في كل صف ترسل siteId لكل نطاق إلى /membership/domains. يختفي العمود إذا لم تُرجع الواجهة أي مواقع (في الخلفية الأقدم)
نسخ الأنماط عند الكتابةStylesManager.prepareForSaveعندما لا يطابق siteId في صف الأنماط العامة المحمّل الموقعَ المختار (أي عندما تُرجع الواجهة الرئيسي الموروث كاحتياط)، يحذف id الخاص بالرئيسي ويضع siteId الحالي، فيُجبر على إدراج صف جديد خاص بالموقع بدلًا من الكتابة فوق الرئيسي. وينطبق المنطق نفسه على كتلة تذييل الموقع
معلومة

ما يبقى على مستوى الكنيسة كاملة في الإصدار الأول (اختيار متعمد في النطاق، وليس قيدًا في نموذج البيانات): المدونة (لا تملك BlogPage مبدّل مواقع، وتحمّل /posts دون siteId)، وأدوات الموقع (شريط الإعلانات ومشغّله)، وعمليات إعادة التوجيه، والشعار وGA4 وإعدادات الكنيسة، وبوابة الأعضاء (تطبيق B1App للجوال). ولاحظ أن هذا ليس "كامل صفحة المظهر": فالأنماط العامة للموقع الثانوي (لوحة الألوان والخطوط والطباعة والتباعد والتنقل وCSS المخصص) تخص الموقع عبر مسار نسخ الكتابة المذكور أعلاه؛ أما لوحات الشريط والمشغّل وإعادة التوجيه والشعار في صفحة المظهر فتبقى على مستوى الكنيسة.

النطاقات المخصصة: حافة Caddy (خطة الإعداد الثابت)​

معلومة

تم تعديل الاتجاه في 2026-07-02. أُلغيت خطة سابقة لنقل استضافة النطاقات المخصصة إلى نطاقات تديرها Vercel، وأُزيلت كل شيفرة تسجيل نطاقات Vercel (VercelHelper، ومتغيرات البيئة vercelToken/vercelProjectId/vercelTeamId، ومعاملات SSM، وإدخالات الصحة) من الواجهة البرمجية. ويبقى وكيل Caddy المُدار ذاتيًا على EC2 حافة النطاقات المخصصة الدائمة. والعمل المتبقي داخلي فقط: استبدال إعداد Caddy وقت التشغيل عبر واجهة الإدارة البرمجية بإعداد ثابت يبقى بعد إعادة التشغيل.

الحافة​

تشير كل نطاقات الكنائس المخصصة عبر DNS إلى جهاز EC2 واحد، وهو 3.23.251.61، ويمكن الوصول إليه أيضًا عبر proxy.b1.church. تطلب شاشة الإعدادات ← النطاقات في B1Admin من الكنائس إضافة سجل A → 3.23.251.61 للنطاق الجذري أو سجل CNAME → proxy.b1.church. ينهي Caddy طبقة TLS بشهادة Let's Encrypt لكل نطاق، ويعيد كتابة ترويسة Host إلى المصدر {sub}.b1.church الخاص بالنطاق، ويمرره إلى B1App، فيوجّهه الأخير بتسمية المضيف كأي نطاق فرعي أصلي (انظر النطاقات المخصصة أعلاه).

يأتي تعيين المصادر من DomainRepo.loadPairs، حيث يدمج الاتصال COALESCE لنطاق الموقع المعيّن، فيُمرَّر النطاق إلى الموقع الثانوي الصحيح، ويعود إلى الكنيسة الرئيسية عند غيابه:

CONCAT(COALESCE(NULLIF(s.subDomain,''), c.subDomain), '.b1.church:443')  AS dial
WHERE d.domainName NOT LIKE '%www.%'

تُستبعد صفوف www.* من الخريطة، ويخدم Caddy www.{host} بإعادة توجيه 302 إلى النطاق الجذري.

نقطتان مجهولتان تغذيان الحافة​

يعرض DomainController نقطتين للقراءة فقط دون مصادقة، يستهلكهما الجهاز مباشرة، وهما مجهولتان بالضرورة، لأن الحافة تستعلم عنهما قبل وجود أي سياق للكنيسة:

النقطةتُرجعالدور
GET /membership/domains/authorize?domain=200 إذا كان النطاق — أو، في حالة عدم العثور على www.، نطاقه الجذري المجرد — موجودًا في domains؛ و404 في غير ذلك (بما في ذلك domain الفارغ)ask لـ on-demand-TLS في Caddy: ضابط إساءة الاستخدام الذي يقرر ما إذا كان سيُصدر شهادة لاسم SNI الوارد
GET /membership/domains/hostmaptext/plain، سطر مرتب واحد لكل نطاق قابل للتوجيه بالشكل {domain} {sub}.b1.churchملف خريطة المضيف ← المصدر الذي يحدّثه الجهاز بمؤقت

تعيد authorize استخدام DomainRepo.loadByName (المضيف الدقيق، ثم إعادة محاولة واحدة من www. إلى الجذر)، وتعيد hostmap استخدام loadPairs، فهي تراعي الموقع وتستبعد www.* تمامًا كمسارات الوكيل، وتزيل فقط اللاحقة :443.

حفظ النطاق وحذفه — دفعة واحدة بأفضل جهد​

يكتب DomainController.save صفوف domains ثم يُجري استدعاءً واحدًا CaddyHelper.updateCaddy() بأفضل جهد ممكن، ملفوفًا في try/catch يسجّل الخطأ (console.error) ويتجاهله؛ ويفعل delete الشيء نفسه (وهذا أيضًا أصلح خللًا سابقًا كان يترك مسارًا قديمًا بعد الحذف)، وكذلك حذف الموقع الثانوي (SiteController.delete). ويُحدَّد updateCaddy نفسه بمهلة 10 ثوانٍ في Axios، فلا يمكن لـ Caddy المتوقف أو غير القابل للوصول أن يُرجع خطأ 500 عند حفظ النطاق — جدول domains هو المصدر المعتمد.

الحالة الراهنة — إعداد ثابت، دون حالة تشغيل​

يعمل الجهاز (جهاز EC2 يعمل بنظام Windows خلف عنوان IP مرن دائم) بـ Caddy من Caddyfile ثابت: TLS عند الطلب يشير ask فيه إلى /membership/domains/authorize، إضافة إلى ملف خريطة للمضيف ← المصدر يُحدَّث كل 5 دقائق من /membership/domains/hostmap عبر مهمة مجدولة تنتهي بإعادة تحميل caddy reload بسلاسة. يبقى الإعداد بعد إعادة التشغيل دون أي حالة تشغيل — دون حاجة إلى إعادة تهيئة يدوية — وإذا كان اسم SNI غير معروف يُرفض TLS (فلا تُصدر أي شهادة لمضيف رفضته authorize)، بينما يحصل المضيف المصرّح به غير المعيّن بعد (نطاق جديد داخل نافذة المزامنة) على خطأ 404 نظيف. تصبح النطاقات الجديدة قابلة للتوجيه خلال ~5 دقائق من الحفظ، وتُصدر شهاداتها عند أول زيارة. أما البناء والإعداد والتشغيل والمشكلات المجربة فعليًا فموثّقة في وكيل Caddy للنطاقات المخصصة.

مسار الدفع الوقتي القديم — مسار الرجوع، بانتظار الحذف​

ما زال CaddyHelper (في وحدة membership) قادرًا على التحكم في Caddy عبر واجهته الإدارية على caddyHost:caddyPort (معاملا SSM caddyHost/caddyPort؛ ولا يفعل شيئًا إذا لم يُضبطا؛ ويظهر تحت مجموعة Integrations في ServerHealthController): إذ يُرسل updateCaddy() طلب PATCH بمصفوفة مسارات كاملة، ويعيد initializeCaddy() إضافةً إلى نقطتي GET /membership/domains/caddy/init وGET /membership/domains/caddy بناءَ خادم مُهيأ وقت التشغيل من الصفر. كان إعداد ذلك النمط يعيش في ذاكرة Caddy فقط، وهو فقدان الذاكرة عند إعادة التشغيل الذي استُبدل به هذا المعمار. تبقى هذه الآلية فقط كمسار رجوع، ومجدولة للحذف بعد استقرار الجهاز الثابت؛ ودفعة updateCaddy() بأفضل جهد عند حفظ النطاق أو حذفه لا تفعل شيئًا ضارًا مع الجهاز الثابت (واجهته الإدارية تقبل الاتصال من localhost فقط).

صفحات ذات صلة​

  • وكيل Caddy للنطاقات المخصصة — جهاز الحافة نفسه: الإعداد من الصفر، وخدمة WinSW، ومهمة مزامنة الخريطة، ومشكلات التشغيل
  • منشئ المواقع الإلكترونية — شجرة الصفحات والأقسام والعناصر، والعارضات، والمدونة، وSEO، وتوليد الذكاء الاصطناعي (ما يُعرض بعد أن يُحل الطلب إلى كنيسة/موقع)
  • نقاط نهاية المحتوى — واجهة REST للصفحات والكتل والروابط والأنماط العامة، وكلها تدعم الآن ?siteId=
  • B1App — تطبيق Next.js الذي يستضيف الوسيط ومسار [sdSlug]
  • نشر تطبيقات الويب — كيفية نشر B1App على Vercel