إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

إعداد الأسماء وTLS

دليل إرشاديتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: القائم بالتثبيت (مسؤول Linux), المسؤول الأعلى
الخططFree · Core · Pro · Enterpriseالنشراستضافة ذاتية

يستجيب خادم Excubius لاسم أساسي ولأي عدد من الأسماء المستعارة، ويقدّم HTTPS في أحد ستة أوضاع، بدءًا من شهادة Let's Encrypt وحتى بوابة تُنهي TLS في الواجهة الأمامية. تحدد إجابات برنامج التثبيت القيم الأولى. وبعد ذلك تغيّرها في وحدة التحكم، ويُطبَّق التغيير خلال دقيقة دون إعادة تشغيل. يوضح هذا الدليل كيفية اختيارها وتغييرها.

قبل البدء​

  • لتغيير الأسماء وTLS في وحدة التحكم، تحتاج إلى دور Super admin.
  • للعمل من الخادم بدلًا من ذلك، تحتاج إلى وصول SSH وsudo حتى تتمكن من العمل بصفة حساب الخدمة (excubius افتراضيًا).
  • أنشئ سجلات DNS أولًا. يجب أن يشير كل اسم إلى الخادم، أو إلى البوابة التي أمامه، من الأماكن التي سيستخدم الناس Excubius منها.

الأنواع الثلاثة للأسماء​

الاسمما هو
Primary name (الاسم الأساسي)اسم المضيف في العنوان العام، مثل monitoring.ciguapa.example. وتستخدمه الروابط التي يرسلها Excubius في رسائل Slack وقضايا Jira. ويتم تسجيل الدخول عليه دائمًا: فمن يفتح اسمًا مستعارًا يُحوَّل إلى الاسم الأساسي لتسجيل الدخول
Aliases (الأسماء المستعارة)أسماء أخرى يمكن للناس فتحها، مثل monitoring.areito.example في نطاق تتحكم فيه عندما تكون منطقة DNS الخاصة بالعميل بعيدة عن متناولك. ويستجيب الخادم لها جميعًا
Names in the certificate (الأسماء في الشهادة)الأسماء التي تُطلب الشهادة لها. جميع الأسماء افتراضيًا، وتنضم الأسماء المستعارة الجديدة تلقائيًا. ألغِ تحديد اسم لا تستطيع الشهادة تغطيته، مثل اسم لا تتحكم في DNS الخاص به

يضم الخادم 100 اسم على الأكثر في المجموع.

تحذير

تبدأ عناوين إعادة التوجيه المسجلة لتسجيل الدخول عبر Microsoft Entra ID وGoogle بالاسم الأساسي. وعندما تغيّر الاسم الأساسي، حدّثها أولًا؛ راجع إعداد موفري تسجيل الدخول.

اختيار الوضع​

الوضع في وحدة التحكمإجابة برنامج التثبيتمتى تستخدمه
Let's Encrypt over HTTPletsencryptجميع الأسماء في الشهادة موجودة في DNS العام وتشير إلى هذا الخادم، ويمكن الوصول إلى المنفذ 80 من الإنترنت، مباشرةً أو عبر إعادة توجيه من NAT أو بوابة
Let's Encrypt over DNSletsencrypt-dnsلديك بيانات اعتماد API لمنطقة DNS الخاصة بالأسماء. ولا يلزم أن يكون الخادم متاحًا من الإنترنت، لذلك فهذا هو الخيار المعتاد لخادم يُوصَل إليه عبر VPN
Self-signedselfsignedفي أي مكان. تعرض المتصفحات تحذيرًا إلى أن يضع الناس ثقتهم في الشهادة على حواسيبهم وهواتفهم
Your own certificatecustomتُصدر مؤسستك الشهادات. تلصق السلسلة والمفتاح، وتستبدلهما قبل انتهاء صلاحيتهما
Gateway in frontgatewayيُنهي موازن حمل أو وكيل عكسي، مثل Azure Application Gateway أو Front Door، اتصال TLS ويمرر HTTP عادي. ويُراعى رأس X-Forwarded-Proto الخاص به
Plain HTTPlaterتجربة أولى، أو شبكة تثق بها تمامًا. لا شيء مشفّر

تغيير الأسماء أو الوضع في وحدة التحكم​

  1. افتح Settings وحدد Server and certificates. ويمكنك أيضًا الوصول إليها من Settings › Instance عبر Server names and HTTPS.
  2. ضمن Names، تحقق من Primary name. لإضافة اسم مستعار، أدخله وحدد Add؛ ولإزالة اسم، حدد Remove بجواره.
  3. ضمن HTTPS، اختر الوضع واملأ ما يطلبه. تصف الأقسام التالية كل وضع.
  4. ضمن Names in the certificate، ألغِ تحديد أي اسم لا تستطيع الشهادة تغطيته.
  5. حدد Apply. تعرض الصفحة الرسالة Saved. The certificate service is applying it.

ضمن Current certificate ترى ما يجري تقديمه: الجهة المُصدِرة، والأسماء، وValid until، وLast attempt مع نتيجتها، وNext check. وإذا فشلت محاولة، يشرح What went wrong السبب.

يُتحقق من كل تغيير قبل حفظه، ويُكتب في سجل التدقيق.

Let's Encrypt عبر HTTP​

أدخل E-mail for the Let's Encrypt account. قبل أن تطبّق التغيير، تأكد من أن كل اسم في الشهادة يشير علنًا إلى الخادم، ومن أن المنفذ 80 مفتوح من الإنترنت. ويُرفض الاسم الذي لا يمكن أن يكون عامًا، مثل عنوان IP أو اسم ينتهي بـ .local أو .internal أو .corp: ألغِ تحديده، أو استخدم شهادة موقّعة ذاتيًا.

Let's Encrypt عبر DNS​

  1. أدخل E-mail for the Let's Encrypt account.

  2. اختر DNS provider لمنطقة الأسماء. وإذا لم يكن الموفر في القائمة، فاختر Other (acme.sh dnsapi id) وأدخل معرّف dnsapi الخاص به في acme.sh.

  3. ضمن API credentials، أدخل القيم التي يقرؤها الموفر. تسردها وحدة التحكم لكل موفر:

    الموفرمعرّف dnsapiالمتغيرات
    Cloudflaredns_cfCF_Token, CF_Account_ID
    DreamHostdns_dreamhostDH_API_KEY
    Azure DNSdns_azureAZUREDNS_SUBSCRIPTIONID, AZUREDNS_TENANTID, AZUREDNS_APPID, AZUREDNS_CLIENTSECRET
    Amazon Route 53dns_awsAWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
    GoDaddydns_gdGD_Key, GD_Secret
    DigitalOceandns_dgonDO_API_KEY
    Gandidns_gandi_livednsGANDI_LIVEDNS_TOKEN
    Hetznerdns_hetznercloudHETZNER_TOKEN
    IONOSdns_ionosIONOS_PREFIX, IONOS_SECRET
    Linode (Akamai)dns_linode_v4LINODE_V4_API_KEY
    Namecheapdns_namecheapNAMECHEAP_USERNAME, NAMECHEAP_API_KEY, NAMECHEAP_SOURCEIP
    OVHclouddns_ovhOVH_END_POINT, OVH_AK, OVH_AS, OVH_CK
    Porkbundns_porkbunPORKBUN_API_KEY, PORKBUN_SECRET_API_KEY
  4. يمكنك اختياريًا ضبط Let's Encrypt server على Staging للتجربة دون المساس بحدود المعدل في Let's Encrypt. لا تثق المتصفحات بشهادات Staging؛ فعُد إلى Production عندما ينجح الأمر.

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

موقّعة ذاتيًا​

لا شيء لإدخاله. الشهادة صالحة لمدة 825 يومًا وتُجدَّد بالطريقة نفسها كغيرها. ولإيقاف تحذيرات المتصفح، حدد Download the certificate وثبّتها كشهادة موثوقة على الحواسيب والهواتف التي تستخدم الخادم.

شهادتك الخاصة​

الصق Certificate chain بتنسيق PEM مع شهادة الخادم أولًا، وPrivate key بتنسيق PEM دون عبارة مرور. يجب أن يكون المفتاح من نوع RSA بطول 2048 بت أو أكثر، أو ECDSA. وترفض وحدة التحكم الشهادة المنتهية الصلاحية، أو التي لا تغطي أسماء الخادم، أو التي لا يطابقها مفتاحها. استبدل الاثنين قبل انتهاء صلاحية الشهادة؛ فـ Excubius لا يجددها نيابةً عنك.

بوابة في الواجهة الأمامية​

لا شيء لإدخاله. اضبط البوابة لتمرير HTTP عادي إلى المنفذ 80 على الخادم ولإرسال الرأس X-Forwarded-Proto.

التجديد​

التجديد تلقائي لشهادات Let's Encrypt والشهادات الموقّعة ذاتيًا. تفحص خدمة الشهادات الشهادة الفعالة كل يوم وتجددها عندما يتبقى 30 يومًا أو أقل. ولا يوجد مؤقت تحتاج إلى إعداده على الخادم.

  • لا تزيل المحاولة الفاشلة ما يعمل. تستمر الشهادة السابقة، أو HTTP عادي، في الخدمة؛ ويظهر الخطأ في الصفحة مع وقت إعادة المحاولة التالية، بعد 15 دقيقة ثم يتضاعف الفاصل حتى يوم واحد.
  • تُجرَّب أي تغييرات في الإعدادات فورًا.
  • يطلب Renew now شهادة جديدة فورًا.
  • ينتقل Use self-signed now إلى شهادة موقّعة ذاتيًا، وهي الطريقة السريعة للحصول على HTTPS ريثما يتعذر عمل Let's Encrypt.

تُعلَّم ملفات تعريف ارتباط الجلسة بالسمة Secure كلما وصل طلب عبر HTTPS، لذلك لا يتطلب تغيير الوضع إعادة تشغيل. اترك COOKIE_SECURE فارغًا في ملف الإعدادات؛ فهو لا يفعل سوى فرض السلوك في اتجاه واحد أو آخر.

يرد العنوانان /healthz و/heartbeat عبر HTTP عادي في كل وضع، لذلك يواصل المراقب الخارجي عمله أثناء تغيير TLS.

تغيير TLS من الخادم​

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

  1. اتصل عبر SSH وتحوّل إلى حساب الخدمة:

    sudo -iu excubius
  2. اعرض الإعدادات والشهادة الحالية:

    /opt/excubius/current/scripts/enable-tls.sh --status
  3. غيّر ما تحتاج إليه. مثلًا، للتحويل إلى شهادة موقّعة ذاتيًا:

    /opt/excubius/current/scripts/enable-tls.sh --mode selfsigned

    أو استخدم Let's Encrypt عبر DNS مع Cloudflare، باسمين وشهادة للاسم الثاني فقط. تُقرأ بيانات الاعتماد على هيئة أسطر KEY=VALUE من الإدخال القياسي:

    /opt/excubius/current/scripts/enable-tls.sh --mode letsencrypt-dns \
    --email ops@areito.example --dns-provider dns_cf \
    --names "monitoring.ciguapa.example monitoring.areito.example" \
    --cert-names monitoring.areito.example < credentials.txt
  4. للتجديد فورًا، شغّل enable-tls.sh --renew.

استبدل /opt/excubius إذا اخترت دليل تثبيت آخر. شغّل enable-tls.sh --help لعرض كل الخيارات، بما فيها --staging و--production. ولا يمكن رفع شهادتك الخاصة إلا من وحدة التحكم.

تغيير الإجابات باستخدام برنامج التثبيت​

يطرح sudo ./install.sh --reconfigure كل سؤال من جديد. وتُطبَّق إجابات TLS التي تقدمها حينئذٍ على المنصة العاملة، كما لو غيّرتها في وحدة التحكم.