ssl-server

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

خادم ويب SSL بتقنية Express، دعم HTTP/2

التثبيت

npm i @sumor/ssl-server --save

الشروط المسبقة

إصدار Node.JS

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

يتطلب إصدار Node.JS للوحدة النمطية ES

نظرًا لأن هذه الحزمة مكتوبة بتنسيق الوحدة النمطية 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'

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

// إضافة المسارات
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)
console.log(`الخادم يعمل على https://localhost:8443/`)
console.log(`خادم إعادة التوجيه يعمل على http://localhost:8080/`)