خادم-SSL

خادم الويب بـ SSL مع Express، يدعم HTTP/2

التثبيت

npm i @sumor/ssl-server --save

المتطلبات الأساسية

إصدار Node.JS

يتطلب إصدار Node.JS 16.x أو أعلى

تتطلب إصدار Node.JS ES module

نظرًا لأن هذه الحزمة مكتوبة بتنسيق ES module، فيرجى تغيير الشيفرة التالية في ملف package.json الخاص بك:

{
  "type": "module"
}

الاستخدام

استضافة خادم بسيط

import createApp from '@sumor/ssl-server'
const app = createApp()

// الاستماع على المنفذ 443 افتراضيًا، وإعادة توجيه 80 إلى https 443
await app.listen()

إضافة ملفات SSL

يرجى إضافة ملفات SSL إلى مجلد الجذر بأسماء التالية:

• domain.crt
• domain.key
• ca.crt (اختياري، سيتم إلحاقه بسلسلة الشهادات)

إذا لم توجد، سيُولّد الخادم شهادة ذاتية التوقيع.
إذا تم تغيير ملفات SSL، سيتم إعادة التحميل تلقائيًا.

الميزات

يدعم جميع ميزات express، الفرق الوحيد هو طريقة listen وclose. يرجى الرجوع إلى المثال أدناه لمزيد من التفاصيل.

إضافة وسيطات ومسارات

import createApp from '@sumor/ssl-server'
const app = createApp()
import bodyParser from 'body-parser'

// يمكنك إضافة أي وسيط express
app.use(bodyParser)

// إضافة مسارات
app.get('/', (req, res) => {
  res.send('مرحبًا بالعالم!')
})

// الاستماع هو دالة غير تزامنية
await app.listen()

إغلاق الخادم بالإجبار

import createApp from '@sumor/ssl-server'
const app = createApp()

// الاستماع هو دالة غير تزامنية
await app.listen()
// الإغلاق هو دالة غير تزامنية
await app.close()

الاستماع على منفذ مخصص

import createApp from '@sumor/ssl-server'
const app = createApp()

// الاستماع هو دالة غير تزامنية
await app.listen(8443, 8080)