لاستضافة عميل Element Web مخصص على Nginx، قم بتنزيل إصدار Element Web رسمي مُجهز مسبقًا، وضع ملفاته الثابتة على خادم الويب الخاص بك، وقم بتهيئته config.jsonمع خادم Matrix الرئيسي، ثم قم بتشغيل الموقع عبر HTTPS. لا يقوم Nginx بتشغيل Element نفسه، بل يقوم بتشغيل ملفات تطبيق المتصفح، بينما يتصل التطبيق بشكل منفصل بخادم Matrix الرئيسي. استخدم اسم مضيف مختلفًا للعميل والخادم الرئيسي، مثل `@client.web.org` و `@ chat.example.comclient.web.org` matrix.example.com.
يفترض هذا الدليل استخدام نظامي Debian أو Ubuntu، وخادم Nginx باسم نطاق عام، وخادم Matrix منزلي موجود يمكن الوصول إليه عبر HTTPS. ويستخدم هذا الدليل أرشيف الإصدار الرسمي بدلاً من إصدار تجريبي. تصف وثائق مشروع Element الحالية تطبيق الويب المنشور بأنه محتوى ثابت، ويتطلب إعدادات أساسية وعناوين URL لنقاط الدخول لتجنب التخزين المؤقت. يُرجى مراجعة ملاحظات الإصدار ووثائق الإعدادات الحالية عند اختيار إصدار أو تغيير الخيارات.
1. تجهيز اسم المضيف والخادم
أنشئ سجل A chat.example.comللإشارة إلى عنوان IPv4 العام لخادم Nginx. أضف سجل AAAA فقط إذا كان الخادم قابلاً للوصول عبر IPv6. اسمح بالوصول إلى منفذي TCP 80 و443 عبر جدار الحماية الخاص بالمضيف وجدار الحماية السحابي. تأكد من أن هذين المنفذين غير مشغولين بالفعل من قِبل خادم ويب آخر.
قم بتثبيت Nginx وإنشاء مجلد لتطبيق الويب:
sudo apt update
sudo apt install nginx
sudo mkdir -p /var/www/element
على جهاز آخر، افتح صفحة إصدارات Element Web الرسمية واختر إصدارًا مستقرًا منشورًا. نزّل أرشيف الويب المُجهز مسبقًا، ثم انقل الأرشيف إلى الخادم. تجنّب استخدام الفرع developأو الإصدار الليلي لخدمة عامة إلا إذا كنت تنوي تشغيل برنامج تجريبي.
2. قم بتثبيت الملفات الثابتة وتعيين خادم المنزل
استخرج أرشيف الإصدار إلى مجلد مؤقت أولًا. تفحّص بنية المجلد الرئيسي للأرشيف، ثم انسخ ملفات الويب الخاصة به إلى المجلد المطلوب /var/www/element؛ مع الحفاظ على بنية مجلد الإصدار. قد تتغير بنية الحزم، لذا تأكد من أن index.htmlملفات الحزم والملفات i18nالأخرى وملف التكوين موجودة في المجلد الذي سيشير إليه جذر مستندات Nginx.
sudo mkdir -p /tmp/element-release
tar -xzf /tmp/element-web-REPLACE_WITH_RELEASE.tar.gz -C /tmp/element-release
find /tmp/element-release -maxdepth 2 -name index.html
استخدم المجلد الذي يحتوي على الملفات index.htmlكمصدر عند نسخ محتويات الإصدار إلى المجلد المطلوب /var/www/element. إذا كان الأرشيف يحتوي على مجلد رئيسي واحد مُرقّم، فانسخ محتويات ذلك المجلد بدلاً من إنشاء مستوى فرعي إضافي. لا تستبدل أي عملية نشر جارية حتى تكتمل الملفات الجديدة؛ فقد يؤدي النسخ غير المكتمل إلى فقدان حزم جافا سكريبت لدى المستخدمين.
انسخ ملف الإصدار config.sample.jsonإلى config.jsonالمجلد المطلوب إذا كان الأرشيف يوفره، ثم عدّل الملف الجديد. يحتاج العنصر إلى إعدادات اتصال افتراضية لخادم المنزل لبدء التشغيل. الصيغة المفضلة المدعومة هي default_server_config، باستخدام عنوان URL الأساسي لواجهة برمجة تطبيقات العميل. المثال أدناه توضيحي؛ استبدل عنوان URL بعنوان URL الفعلي الذي يوفره خادم Matrix المنزلي الخاص بك:
{
"default_server_config": {
"m.homeserver": {
"base_url": "https://matrix.example.com"
}
},
"brand": "Example Chat"
}
تدعم وثائق تكوين Element أيضًا default_server_nameخاصية تعتمد على .well-knownاكتشاف المصفوفة. استخدم هذه الخاصية default_server_configعندما تريد تحديد عنوان URL للخادم الرئيسي مباشرةً. لا تضع كلمات المرور أو رموز الوصول أو مفاتيح التوقيع أو أي بيانات سرية أخرى في ملف JSON العام هذا. brandيُغيّر هذا الخيار بعض تسميات التطبيق؛ فهو ليس تغييرًا كاملاً للعلامة التجارية.
3. قم بتهيئة Nginx للتطبيق
أنشئ كتلة خادم Nginx مثل /etc/nginx/sites-available/element. استبدل النطاق إذا لزم الأمر. يُشغّل هذا التكوين البسيط Element كملفات ثابتة ويرسل المسارات المفقودة إلى index.html، مع وضع علامة على جميع الاستجابات لإعادة التحقق. تمنع سياسة التخزين المؤقت المحافظة هذه المستخدمين من تلقي غلاف تطبيق قديم أو تكوين قديم بعد الإصدار؛ يمكنك ضبط تخزين الأصول مؤقتًا لاحقًا إذا كانت عملية النشر لديك تحافظ على مسارات Element المطلوبة بدون تخزين مؤقت.
server {
listen 80;
listen [::]:80;
server_name chat.example.com;
root /var/www/element;
index index.html;
location / {
try_files $uri $uri/ =404;
add_header Cache-Control "no-cache" always;
add_header X-Frame-Options SAMEORIGIN always;
add_header X-Content-Type-Options nosniff always;
add_header Content-Security-Policy "frame-ancestors 'self'" always;
}
}
تنصّ ملاحظات استضافة المواقع الإلكترونية من Element على عدم تخزين أي ملفات مؤقتًا ، وتوصي /config.*.jsonبإعادة التحقق من المتصفح عند تحميل الصفحة. ينطبق هذا المثال على كل شيء كنقطة انطلاق مباشرة. كما يتضمن رؤوس الأمان التي توصي بها Element، بما في ذلك سياسة الإطار وحماية MIME. إذا كنت قد حددت بالفعل سياسة أمان محتوى في مكان آخر، فقم بدمجها في تلك السياسة بدلاً من إرسال سياسات متعارضة./i18n/version/index.htmlno-cacheframe-ancestors 'self'
قم بتفعيل الموقع والتحقق من صحة Nginx قبل إعادة تحميله:
sudo ln -s /etc/nginx/sites-available/element /etc/nginx/sites-enabled/element
sudo nginx -t
sudo systemctl reload nginx
4. أضف بروتوكول HTTPS واختبر العميل
يجب تقديم العنصر عبر بروتوكول HTTPS. بمجرد أن يتم حل نظام أسماء النطاقات (DNS) إلى هذا الخادم ويصبح المنفذ 80 متاحًا، ثبّت Certbot باتباع التعليمات الحالية لتوزيعتك، ثم اطلب شهادة وثبّتها باستخدام تكامل Nginx الخاص به. يوثّق مشروع Certbot certbot --nginxعملية التحقق من التدفق والتجديد؛ يختلف تثبيت الحزمة باختلاف نظام التشغيل، لذا استخدم تعليمات Nginx الحالية لإصدارك. إذا عدّل Certbot كتلة الخادم، sudo nginx -tفأعد تشغيله وتأكد من جدولة التجديد.
افتح https://chat.example.comنافذة متصفح خاصة. يجب أن تُحمّل شاشة تسجيل الدخول إلى Element بدون أي ملفات برمجية أو أنماط مفقودة، وأن تعرض خادمك الرئيسي المتوقع، وأن يظهر رمز قفل صحيح في شريط عنوان المتصفح. سجّل الدخول باستخدام حساب تجريبي وتأكد من قدرة المتصفح على الوصول إلى الخادم الرئيسي. في حال فشل تسجيل الدخول، افحص وحدة تحكم مطوّر المتصفح ولوحة الشبكة بحثًا عن طلبات محظورة، أو أخطاء في الشهادة، أو عنوان IP خاطئ base_url.
مشاكل النشر الشائعة
- صفحة فارغة أو نصف محملة: تحقق من أن Nginx
rootيشير إلى الدليل الذي يحتوي على index.html، وأن الحزم i18nوالدليل قد تم نسخهما معه. - يظهر خادم رئيسي خاطئ: تحقق من صحة بنية JSON
config.jsonوتأكد من وجود الملف في جذر الموقع. إذا قمتَ بتكوين ملف خاص بنطاق معين config.chat.example.com.json، فسيحاول Element استخدام هذا الملف قبل config.jsonدمج الملفات؛ ولن يتم دمجها. - يرى المستخدمون الإعدادات القديمة بعد التحديث: تأكد من
index.htmlعدم تخزين ملفات JSON الخاصة بالتكوين مؤقتًا. امسح ذاكرة التخزين versionالمؤقت i18nللمتصفح أو أعد التحقق منها بعد تغيير سياسة Nginx. - يتم تحميل صفحة تسجيل الدخول، لكن طلبات واجهة برمجة التطبيقات (API) تفشل: تأكد من صحة عنوان URL الخاص بالخادم الرئيسي، واستخدامه لبروتوكول HTTPS، وتهيئته للوصول عبر المتصفح، بما في ذلك سلوك CORS المناسب عند الحاجة. لا يقوم عنصر الاستضافة على Nginx بدور وكيل أو استبدال خادم Matrix الرئيسي.
لضمان نجاح عملية النشر، يتم تحميل العميل على النطاق المخصص عبر بروتوكول HTTPS، وتُشير إعداداته إلى الخادم الرئيسي المُستهدف، ويمكن لحساب تجريبي تسجيل الدخول دون فشل طلبات الشبكة. تُعدّ ملاحظات استضافة المواقع الإلكترونية الخاصة بـ Element ووثائق فهرسة Nginx المراجع الأساسية للنشر الثابت وسلوك كتلة الخادم الموضح هنا.