💬 تثبيت LiveKit — سيرفر WebRTC مفتوح المصدر للصوت والفيديو الفوري
انشر LiveKit على Ubuntu بواسطة Docker — SFU لـ WebRTC مفتوح المصدر وقابل للتوسع يشغّل الصوت والفيديو والبيانات الفورية للتطبيقات التي تبنيها، على المنفذ 7880.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/livekit/livekit-ubuntu.sh
chmod +x livekit-ubuntu.sh
sudo bash livekit-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/livekit/livekit-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x livekit-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إذا لزم الأمر ويشغّل سيرفر LiveKit مع WebSocket/API على TCP 7880، والوسائط على TCP 7881، وحركة WebRTC على UDP 7882. يأتي ببيانات اعتماد تطويرية (مفتاح API devkey، السر secret) يجب استبدالها للاستخدام الفعلي.
sudo bash livekit-ubuntu.sh
4 ربط عميل
لا يملك LiveKit صفحة لمستخدم نهائي — أنت تبني فوقه. وجّه عميل LiveKit أو الـ CLI إلى رابط WebSocket باستخدام مفتاح API وسر التطوير:
ws://<your-server-ip>:7880 (API key devkey / secret secret)
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 7880 | WebSocket + API (TCP) — the endpoint clients connect to |
| 7881 | Media (TCP) |
| 7882/udp | WebRTC media — must be open or calls have no audio/video |
| devkey / secret | Dev credentials — replace before any real deployment |
نظرة عامة
LiveKit هو وحدة توجيه انتقائي (SFU) لـ WebRTC مجانية ومفتوحة المصدر — البنية التحتية من جانب السيرفر التي توجّه الصوت والفيديو والبيانات الفورية بين المشاركين على نطاق واسع. مكتوب بلغة Go فوق مكتبة Pion WebRTC ومرخّص بموجب Apache 2.0، إنه ليس تطبيق مكالمات فيديو جاهزاً بل المحرك الذي تبني فوقه واحداً، مع حزم SDK رسمية للويب وiOS وAndroid والمنصات الأصلية، بالإضافة إلى حزم SDK للسيرفر بلغات Node.js وGo وPython وغيرها. يعرض نفس السيرفر ذاتي الاستضافة واجهة API مطابقة لعرض LiveKit السحابي المُدار، فيمكنك البدء على بنيتك التحتية الخاصة والانتقال في أي اتجاه دون إعادة كتابة تطبيقك.
لماذا تستخدمه
بناء صوت وفيديو فوري من الصفر يعني تنفيذ إشارات WebRTC واجتياز NAT وتوجيه الوسائط على نطاق واسع — جهد هندسي كبير لا ينبغي لمعظم الفرق تحمّله بنفسها. يوفر LiveKit تلك البنية التحتية كوحدة SFU مُختبرة جيداً مع حزم SDK تتولى تعقيد جانب العميل، فيركّز فريقك على تجربة التطبيق بدلاً من تفاصيل WebRTC الداخلية. استضافته ذاتياً تعني أن وسائطك الفورية لا تلمس أبداً خوادم طرف ثالث، وتتجنب رسوم الاستخدام بالدقيقة من المنصات المستضافة، وتحصل على واجهات API مطابقة سواء شغّلته بنفسك أو انتقلت لاحقاً إلى LiveKit Cloud للتوسع.
متى تحتاجه
- تبني منتجاً يحتاج صوتاً أو فيديو حياً — سوقاً بمكالمات فيديو، تطبيق طب عن بُعد، فصلاً افتراضياً، أو دعم عملاء مباشراً
- تريد بناء وكلاء صوت بالذكاء الاصطناعي ينضمون لمحادثات فورية، باستخدام إطار عمل LiveKit Agents لخطوط أنابيب تحويل الكلام لنص وLLM وتحويل النص لكلام
- تحتاج تسجيل أو بث الجلسات من جانب السيرفر إلى تخزين متوافق مع S3 أو لوجهات RTMP مثل YouTube أو Twitch
- تريد جلب بثوث خارجية (RTMP، WHIP، HLS) إلى غرفة حية كمشاركين كاملين باستخدام Ingress
- تحتاج بنية تحتية فورية تتحكم بها وتستضيفها بنفسك بالكامل، بدلاً من الدفع بالدقيقة لواجهة فيديو مستضافة
- تُجري نموذجاً أولياً لميزة فورية وتريد خيار التوسع على نفس الواجهات لاحقاً عبر LiveKit Cloud دون إعادة كتابة
من يحتاجه
- مطورو التطبيقات الذين يبنون ميزات صوت/فيديو فورية داخل منتج بدلاً من نشر تطبيق اجتماعات جاهز
- مهندسو الذكاء الاصطناعي الذين يبنون وكلاء صوت وتجارب محادثة ذكاء اصطناعي باستخدام إطار عمل LiveKit Agents
- الشركات الناشئة التي تريد تجنب الرسوم المتكررة بالدقيقة أو بالمشارك التي تفرضها منصات API الفيديو المستضافة
- الشركات ذات متطلبات إقامة البيانات أو الخصوصية التي تحتاج بقاء الوسائط الفورية على بنية تحتية تتحكم بها
- الفرق التي تبني منتجات بث مباشر أو فعاليات افتراضية أو بث تفاعلي وتحتاج Ingress وEgress
- مهندسو المنصات الذين يحتاجون SFU قابلاً للتوسع وجاهزاً للإنتاج كلبنة بناء ضمن نظام أكبر
حالات الاستخدام الشائعة
- مكالمات فيديو داخل التطبيق لسوق أو تطبيق مواعدة أو منصة طب عن بُعد أو فصل افتراضي
- وكلاء صوت مدعومون بالذكاء الاصطناعي ينضمون للمكالمات للتعامل مع دعم العملاء أو المقابلات أو الترجمة الفورية
- فعاليات مبثوثة مباشرة مع تسجيل من جانب السيرفر وإخراج RTMP متزامن لـ YouTube أو Twitch
- جلب بث من OBS Studio أو مشفّر أجهزة إلى غرفة LiveKit كمشارك مباشر عبر Ingress
- منتجات اجتماعات افتراضية أو ندوات عبر الإنترنت مبنية بالكامل حول حزم SDK الخاصة بعملاء LiveKit وواجهة مستخدم مخصصة
- مساحات صوتية تفاعلية أو غرف دردشة صوتية مفتوحة شبيهة بـ Clubhouse أو Twitter Spaces
الميزات الرئيسية
- معمارية وحدة توجيه انتقائي (SFU) مكتوبة بلغة Go فوق مكتبة Pion WebRTC، مبنية للتوسع الأفقي
- حزم SDK رسمية للعميل لـ JavaScript/الويب وiOS (Swift) وAndroid (Kotlin) وFlutter وReact Native وUnity
- حزم SDK للسيرفر بلغات Node.js وGo وPython وRuby وJava وغيرها لإصدار رموز الوصول وإدارة الغرف
- خدمة Egress للتسجيل من جانب السيرفر (مركّب أو لكل مسار) إلى تخزين متوافق مع S3 وبث RTMP/HLS متزامن للخارج
- خدمة Ingress لجلب مصادر خارجية — RTMP وWHIP وHLS وMP4 — إلى غرفة كمسارات مشاركين حية
- إطار عمل LiveKit Agents لبناء وكلاء صوت بالذكاء الاصطناعي بخطوط أنابيب منخفضة الكمون لتحويل الكلام لنص وLLM وتحويل النص لكلام
- واجهة API مطابقة بين LiveKit ذاتي الاستضافة وLiveKit Cloud، فيمكنك الانتقال في أي اتجاه دون إعادة كتابة تطبيقك
- مصادقة قائمة على الرموز حيث يوقّع الخادم الخلفي رموز وصول قصيرة الأجل يستخدمها العملاء للانضمام للغرف
كيفية الاستخدام بعد التثبيت
- استبدل بيانات اعتماد التطوير الافتراضية devkey / secret بمفتاح API وسر خاصين بك تم توليدهما قبل أي استخدام فعلي
- استخدم حزمة SDK للسيرفر في الخادم الخلفي لتوليد رموز وصول موقّعة يسلّمها تطبيق العميل للمستخدمين المنضمين لغرفة
- ادمج حزمة SDK لعميل LiveKit (ويب، iOS، Android، أو Flutter) في تطبيقك لربط المستخدمين بالغرف وعرض الوسائط
- افتح منفذ UDP 7882 على الجدار الناري ومجموعة الأمان السحابية — لن تتدفق وسائط WebRTC بدونه حتى لو نجحت الإشارة
- أعدّ TLS واسم مضيف عام إذا كان العملاء سيتصلون من خارج شبكتك المحلية، لأن المتصفحات تتطلب اتصالات WebSocket آمنة في الإنتاج
- أعدّ Egress إذا احتجت تسجيلاً من جانب السيرفر أو بثاً متزامناً لمنصات مثل YouTube أو Twitch
- أعدّ Ingress إذا احتجت جلب مصادر RTMP أو WHIP أو HLS خارجية كمشاركين في الغرفة
- إذا كنت تخطط لبناء وكلاء صوت بالذكاء الاصطناعي، ثبّت إطار عمل LiveKit Agents واربطه بمزوّدي تحويل الكلام لنص وLLM وتحويل النص لكلام
أفضل ممارسات الأمان
- استبدل بيانات اعتماد التطوير devkey / secret فوراً — فهي قيم افتراضية معروفة للعموم وتمنح وصولاً كاملاً لواجهة API إن بقيت دون تغيير
- لا تكشف سر API أبداً في كود جانب العميل — يجب أن يحتفظ به الخادم الخلفي فقط لتوقيع رموز وصول قصيرة الأجل للعملاء
- استخدم أوقات انتهاء صلاحية قصيرة للرموز وحدّد نطاق كل رمز بالغرفة والصلاحيات التي يحتاجها المستخدم فعلياً
- أنهِ TLS أمام منفذ WebSocket/API حتى يتصل العملاء عبر wss:// وليس ws:// النص العادي
- قيّد الغرف التي يمكن لرمز الانضمام إليها والإجراءات (نشر، اشتراك، تسجيل) المسموح له بتنفيذها
- حافظ على تحديث صورة Docker لسيرفر LiveKit، لأنها بنية تحتية عامة المواجهة تتعامل مع وسائط فورية ومصادقة
- إذا كنت تكشف محتوى مُسجَّلاً عبر Egress، أمّن حاوية التخزين المتوافقة مع S3 بضوابط وصول مناسبة — فالتسجيلات حساسة بطبيعتها
المنافذ وإعدادات جدار الحماية
يحتاج LiveKit منفذ TCP 7880 لنقطة نهاية WebSocket/API التي يتصل بها العملاء، ومنفذ TCP 7881 لبعض مسارات الوسائط، والأهم — منفذ UDP 7882 لحركة وسائط WebRTC. ينقل WebRTC الصوت والفيديو عبر UDP بالتصميم، فإذا لم يكن هذا المنفذ مفتوحاً ويمكن الوصول إليه عبر الجدار الناري ومجموعة الأمان السحابية وأي NAT في المسار، سيتصل العملاء ويرون حالة الغرفة لكن دون سماع أو رؤية أي شيء. في الإنتاج، ضع منفذ WebSocket/API خلف إنهاء TLS حتى تستطيع المتصفحات استخدام اتصالات wss:// الآمنة، لأن معظم المتصفحات تتطلب HTTPS/WSS خارج localhost. حافظ على تغيير مفتاح وسر API التطويريين إلى قيم فريدة، لأن أي شخص يستطيع الوصول للمنفذ 7880 ببيانات الاعتماد الافتراضية يملك وصولاً كاملاً لواجهة API.
النسخ الاحتياطي والصيانة
- انسخ ملف إعدادات سيرفر LiveKit احتياطياً (livekit.yaml)، الذي يحدد مفاتيح API والمنافذ وأي إعدادات Egress/Ingress
- انسخ أزواج مفتاح وسر API احتياطياً بأمان — فقدانها يُبطل كل رمز وصول صادر سابقاً
- إذا كنت تستخدم تسجيلات Egress، تأكد أن حاوية التخزين المتوافقة مع S3 تملك سياسة نسخ احتياطي أو تحكم إصدارات خاصة بها، فالتسجيلات تعيش خارج سيرفر LiveKit نفسه
- انسخ docker-compose.yml أو إعدادات النشر احتياطياً حتى يمكن إعادة إنشاء السيرفر بشكل مطابق على مضيف جديد
- LiveKit نفسه عديم الحالة إلى حد كبير بالنسبة للجلسات الحية — الأصول الدائمة الرئيسية للحماية هي الإعدادات وبيانات الاعتماد وأي وسائط مُسجَّلة
- اختبر أن سيرفراً مُعاد نشره بإعدادات مُستعادة يستطيع مصادقة تكاملات SDK للعملاء الحالية بشكل صحيح
الأخطاء الشائعة
- ترك بيانات اعتماد devkey / secret الافتراضية في مكانها في أي استخدام يتجاوز الاختبار المحلي
- نسيان فتح منفذ UDP 7882، ما يؤدي لعملاء يتصلون بنجاح لكن بدون صوت أو فيديو
- كشف سر API في كود جانب العميل (المتصفح أو الجوال) بدلاً من الاحتفاظ به على جانب السيرفر فقط
- افتراض أن LiveKit تطبيق اجتماعات جاهز للاستخدام — إنه بنية تحتية بدون واجهة مستخدم مدمجة، وتخطي دمج SDK يتركك بلا شيء لعرضه
- عدم وضع TLS أمام منفذ WebSocket/API، ما ترفض المتصفحات الاتصال به بأمان خارج localhost
- إصدار رموز وصول طويلة الأجل أو واسعة النطاق بشكل مفرط بدلاً من رموز قصيرة الأجل ومحددة النطاق بالغرفة
- التقليل من تقدير احتياجات النطاق الترددي والمعالج عند التوسع لعدد كبير من الغرف أو المشاركين المتزامنين دون تخطيط للسعة
استكشاف الأخطاء وإصلاحها
- العملاء يتصلون لكن بدون صوت/فيديو — تحقق أن منفذ UDP 7882 مفتوح على الجدار الناري ومجموعة الأمان السحابية وأي راوتر/NAT في المسار
- تعذر الاتصال إطلاقاً — تحقق أن منفذ TCP 7880 متاح وأن رابط WebSocket ومفتاح/سر API يطابقان إعدادات سيرفرك
- الاتصال يعمل محلياً لكن يفشل من خارج الشبكة — تأكد أنك تستخدم اسم مضيف عاماً بشهادة TLS صالحة، وليس فقط IP الخام عبر ws:// النص العادي
- أخطاء رمز الوصول (غير مصرّح/غير صالح) — تحقق أن الرمز وُقِّع بسر API الصحيح ولم تنتهِ صلاحيته
- زمن استجابة مرتفع أو وسائط متقطعة — تحقق من استخدام المعالج/النطاق الترددي للسيرفر تحت الحمل وفكّر إن كنت تحتاج التوسع أفقياً بعدة عقد SFU
- تسجيلات Egress تفشل في البدء — تأكد أن خدمة Egress تعمل وأن بيانات اعتماد التخزين المتوافق مع S3 وصلاحيات الحاوية صحيحة
- بث Ingress لا يظهر في الغرفة — تحقق أن مصدر RTMP/WHIP مُعدّ بشكل صحيح ويصل لنقطة نهاية خدمة Ingress
البدائل
Jitsi Meet هو أقرب شيء لبديل حقيقي إذا كان ما تريده فعلاً تطبيق مؤتمرات فيديو ذاتي الاستضافة وجاهز — انشره وستحصل على غرف اجتماعات عاملة فوراً، بدون أي دمج SDK مطلوب. mediasoup وJanus مكتبتا SFU مفتوحتا المصدر أخريان لـ WebRTC بفلسفة مشابهة أقل مستوى وابنِ تطبيقك بنفسك مثل LiveKit، لكن LiveKit تقدم أكثر جاهزاً من الصندوق (Ingress وEgress وAgents وتغطية SDK أوسع). للبدائل المستضافة والمُدارة بالكامل، تقدم Agora وDaily وTwilio و100ms واجهات بنية تحتية فيديو بالدفع حسب الاستخدام بدون أي سيرفر تشغّله بنفسك — مفيدة إذا كنت تفضل عدم تشغيل بنية تحتية إطلاقاً، على حساب تسعير بالدقيقة وتحكم أقل. إذا كانت حاجتك الوحيدة مكالمة صوت/فيديو بين شخصين فقط بدون غرف بعدة مشاركين، فقد يكفيك تنفيذ WebRTC نظير-لنظير أبسط دون تعقيد SFU.
متى لا تستخدمه
إذا كنت تريد منتج مؤتمرات فيديو جاهزاً للاستخدام لفريقك أو مؤسستك — وليس شيئاً تبني تطبيقاً فوقه — فإن LiveKit الطبقة الخاطئة؛ انشر Jitsi Meet بدلاً من ذلك وتخطَّ عمل دمج SDK بالكامل. يفترض LiveKit أيضاً أنك مرتاح مع مفاهيم WebRTC وتوجيه منفذ UDP وكتابة كود تطبيق ضد حزم SDK للعميل/السيرفر — إذا كان فريقك يفتقر لتلك القدرة أو الوقت، فقد تُوصلك واجهة فيديو مستضافة بأداة أعلى مستوى للسوق أسرع رغم التكلفة المتكررة. لسيناريوهات المكالمات منخفضة الحركة جداً أو بين شخصين فقط، يتجنب إعداد WebRTC نظير-لنظير أبسط العبء التشغيلي لتشغيل وتوسيع SFU. وإذا لم تستطع فتح وتوجيه منفذ UDP بشكل موثوق عبر شبكتك (بعض الشبكات المؤسسية أو شبكات الجوال المقيدة تجعل هذا صعباً فعلاً)، فقد تحتاج بنية تحتية ترحيل TURN أو خدمة مُدارة تتعامل مع ذلك التعقيد نيابة عنك بالفعل.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو LiveKit؟
إنه سيرفر WebRTC مفتوح المصدر — SFU — يوفر العمود الفقري للصوت والفيديو والبيانات الفورية للتطبيقات التي تبنيها.
هل هو تطبيق فيديو جاهز للاستخدام؟
لا — هذا هو الشيء الأساسي الذي يجب فهمه. LiveKit مكوّن سيرفر توجّه إليه تطبيقك الخاص باستخدام حزم SDK الخاصة به؛ لا يأتي بصفحة اجتماع لمستخدم نهائي. إذا كنت تريد تطبيق مؤتمرات جاهزاً وذاتي الاستضافة يمكنك فقط نشره واستخدامه، فـ Jitsi Meet هو الأنسب.
ما هما devkey وsecret؟
إنهما بيانات اعتماد تطويرية — مفتاح API devkey والسر secret — تأتي مع التثبيت للاختبار المحلي. يستخدم خادمك الخلفي السر لتوقيع رموز وصول يقدّمها العملاء للانضمام للغرف.
ما المنافذ ولماذا UDP مهم؟
TCP 7880 هو WebSocket/API، وTCP 7881 هو الوسائط، وUDP 7882 يحمل حركة وسائط WebRTC. منفذ UDP بالغ الأهمية: ينقل WebRTC الصوت والفيديو عبر UDP، فإذا لم يكن مفتوحاً ويمكن الوصول إليه، سيتصل العملاء لكن بدون وسائط.
كيف يُقارن بـ Jitsi؟
Jitsi Meet تطبيق مؤتمرات فيديو كامل وذاتي الاستضافة — انشره وستحصل على غرف عاملة فوراً. LiveKit بنية تحتية أدنى مستوى: SFU لـ WebRTC مع حزم SDK تبني فوقها تجربتك الخاصة.