ssl-server

أداة Sumor Cloud.
المزيد من التوثيق

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

التثبيت

npm i @sumor/ssl-server --save

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

إصدار Node.JS

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

يتطلب التحويل إلى وحدة ES Node.JS

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

{
  "type": "module"
}

الاستخدام

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

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

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

إضافة ملفات SSL

يرجى إضافة ملفات 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'

// يمكنك إضافة أي وسيط تعبير
app.use(bodyParser.json())

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

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

إغلاق الخادم بقوة

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

// listen دالة غير متزامنة
await app.listen()
// close دالة غير متزامنة
await app.close()

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

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

// listen دالة غير متزامنة
await app.listen(8443, 8080)
console.log(`الخادم يعمل على https://localhost:8443/`)
console.log(`خادم إعادة التوجيه يعمل على http://localhost:8080/`)