نکات کلیدی
- اگر Nginx بر روی همان سرور در پورت 443 فعال باشد، نصب کننده پیکربندی `turnserver` را نادیده می گیرد.
- بدون احراز هویت، هر کسی می تواند از پهنای باند سرور استفاده کند و جلسه بدون محدودیت برای غریبه ها قابل دسترسی باشد.
- هندبوک توصیه می کند Jibri را روی همان سرور جلسه نصب نکنید؛ بهتر است سرور جداگانه ای برای ضبط داشته باشید.
مقدمه
Jitsi Meet یک پلتفرم متنباز برای برگزاری ویدیوکنفرانس است که بر روی سرورهای لینوکسی قابل نصب میباشد. در این راهنما بهصورت مختصر و کاربردی به نکات کلیدی نصب و پیکربندی در Ubuntu 24.04 و Debian 12 پرداخته میشود.
نکات کلیدی پیش از نصب
- گواهینامه معتبر: اپلیکیشنهای موبایل فقط به سروری با گواهی امضاشده متصل میشوند.
- پورت 10000/UDP: باید باز باشد تا صدا و تصویر منتقل شود.
- NAT: بدون نگاشت NAT، شرکتکنندگان صدای و تصویری دریافت نمیکنند.
- اتاق باز: اگر تنظیمات اشتباه باشد، هر کسی میتواند جلسه ایجاد کند.
- سایز سرور: سرور ناکافی باعث افت کیفیت و قطع ارتباط میشود.
سرویسهای اصلی
| سرویس | نقش |
|---|---|
| Prosody | سرور XMPP برای سیگنالدهی |
| Jicofo | مدیریت جلسه |
| Jitsi Videobridge | انتقال رسانه |
مراحل نصب
- آمادهسازی دامنه و گواهی
- یک زیردامنه (مثلاً `meet.example.org`) را به IP عمومی سرور خود ارجاع دهید.
- از Let’s Encrypt برای دریافت گواهی SSL استفاده کنید.
- نصب بستههای مورد نیاز
- برای Ubuntu 24.04: `sudo add-apt-repository universe`
- برای Debian 12: نیازی به فعالسازی مخزن universe نیست.
- نصب OpenJDK 17 و مخازن Prosody و Jitsi:
“`bash sudo apt update sudo apt install -y openjdk-17-jdk prosody jitsi-meet “`
- پیکربندی فایروال
- باز کردن پورت 10000/UDP:
“`bash sudo ufw allow 10000/udp “`
- اطمینان از باز بودن پورتهای 80 و 443 برای HTTPS.
- تنظیمات NAT و فایروال شبکه
- در روتر یا فایروال، پورت 10000/UDP را به IP سرور هدایت کنید.
- در صورت استفاده از سرویسهای ابری، تنظیمات NAT را در پنل مدیریت سرویس اعمال کنید.
- تست نهایی
- از سه دستگاه در شبکههای مختلف (مثلاً خانگی، اداری، موبایل) به سرور متصل شوید.
- جلسهای با دو شرکتکننده آغاز کنید و سپس نفر سوم را اضافه کنید تا عملکرد صحیح را بررسی کنید.
نکات تکمیلی
- ساخت اتاق باز: در فایل `/etc/jitsi/jicofo/jicofo.cfg` مقدار `anonymous` را به `false` تغییر دهید.
- حجم سرور: برای جلسات بزرگ، حداقل 4 GB RAM و پردازنده چند هستهای توصیه میشود.
- پشتیبانی از چند سرور: در صورت نیاز به مقیاسپذیری، میتوانید چندین سرور Videobridge را به یک Prosody متصل کنید.
جمعبندی
نصب Jitsi Meet بر روی Ubuntu 24.04 یا Debian 12 بهصورت ساده و سریع انجام میشود، اما رعایت نکات امنیتی و پیکربندی صحیح شبکه برای عملکرد بیعیب ضروری است. با دنبال کردن این راهنما، میتوانید یک پلتفرم ویدیوکنفرانس سازمانی بدون محدودیت زمان راهاندازی کنید.
پورتهای مورد نیاز برای نصب و راهاندازی
- پورت 80/TCP باید پیش از نصب باز باشد؛ Let’s Encrypt در طول فرآیند تأیید گواهی به آن متکی است.
- هندبوک برای کارکرد صحیح، پورتهای 80، 443، 22 و 5349 را روی TCP و 10000 را روی UDP باز میدارد؛ پورت 3478/UDP اختیاری است و تغییر در `config.js` لازم است.
- در صورتی که SSH روی پورت دیگری فعال است، همان پورت را پیش از فعالسازی `ufw` باز کنید. فایروال دیتاسنتر نیز همان تنظیمات را میطلبد.
نصب و دریافت گواهی
نصبکننده نام میزبان و نوع گواهی را از شما میپرسد.
- انتخاب گواهی خودامضا باعث هشدار مرورگر و محدودیت در اپلیکیشن موبایل میشود.
- پس از نصب، با مراجعه به ` میتوانید جلسهای ایجاد کنید.
- اگر Nginx بر روی همان سرور در پورت 443 فعال باشد، نصبکننده پیکربندی `turnserver` را نادیده میگیرد.
مشکل قطع شدن جلسات سهنفره
اگر پس از نصب، جلسه دو نفره سالم باشد ولی سه نفره قطع شود، علت معمولاً در مسیر `videobridge` است.
- دو نفر به صورت مستقیم P2P ارتباط برقرار میکنند؛
- نفر سوم به `jitsi-videobridge2` روی پورت 10000/UDP متصل میشود.
- در محیطی که کابل آمپلیفایر جدا باشد، صدای نفر سوم از طریق آمپلیفایر عبور میکند و در صورت قطع کابل، صدا در سالن شنیده نمیشود.
- آزمایش دو نفره مسیر `videobridge` را پنهان میکند؛ برای تشخیص بهتر، سه دستگاه (یک لپتاپ و دو گوشی) را در دو اپراتور مختلف امتحان کنید.
سرور مجازی با IP خصوصی
اگر خروجی `ip address show` فقط IP خصوصی (10.x، 172.16–172.31 یا 192.168.x) را نشان دهد، هندبوک سرور را پشت NAT میداند.
- از پشتیبانی ارائهدهنده بپرسید که آیا پورتهای 443/TCP و 10000/UDP به سرور شما میرسند یا خیر.
- اگر جلسه سه نفره باز نمیشود، نگاشت آدرس را در فایل `/etc/jitsi/videobridge/jvb.conf` در بخش `ice4j.harvest.mapping` با کلیدهای `local-address` و `public-address` تنظیم کنید و سپس سرویس را با `sudo systemctl restart jitsi-videobridge2` راهاندازی مجدد کنید.
محدود کردن دسترسی به اتاقها
- بهطور پیشفرض، هر کسی که آدرس سرور را میداند میتواند جلسهای ایجاد کند.
- برای محدود کردن دسترسی، احراز هویت را فعال کنید؛ این کار باعث میشود فقط کاربران معتبر بتوانند اتاق بسازند و مهمانان پس از ورود به آن وارد شوند.
- بدون احراز هویت، هر کسی میتواند از پهنای باند سرور استفاده کند و جلسه بدون محدودیت برای غریبهها قابل دسترسی باشد.
- رمز اتاق فقط جلوی ورود به جلسه را محدود میکند، اما جلوی ایجاد اتاق جدید را نمیگیرد.
روش توصیهشده هندبوک: توکن JWT
برای کنترل دقیقتر دسترسی و امنیت، از توکن JWT استفاده کنید. این روش امکان احراز هویت کاربر و محدود کردن دسترسی به منابع را فراهم میکند.
احراز هویت JWT و نصب اولیه
- در مرحلهٔ اول نصب، بستهٔ مورد نیاز برای دسترسی root را در صفحهٔ Token Authentication نصب میکنیم.
- سپس، شناسهٔ برنامه (Application ID) و رمز مخفی (Application Secret) را وارد کرده و در فایل پیکربندی Prosody با گزینهٔ `authentication = “token”` ذخیره میکنیم.
- از این پس، فقط کاربرانی که توکن معتبر دارند، میتوانند اتاق ایجاد کنند؛ سایر کاربران از دامنهٔ ناشناس وارد میشوند.
- سایر تنظیمات در همان صفحه قابل دسترسی هستند و اتصال به Keycloak در بخش Authentication انجام میشود.
هندبوک بهصورت واضح اعلام کرده است که روش قدیمی Secure Domain با `internal_hashed` و `prosodyctl` برای نصب تازه منسوخ شده و فقط در سرورهای قدیمی قابل مشاهده است.
تخمین منابع سرور برای تعداد شرکتکننده
| عامل | اولویت | توضیح |
|---|---|---|
| شبکه | بالاترین | تأمین پهنای باند کافی برای انتقال ویدئو 4K |
| RAM | متوسط | حافظهٔ کافی برای پردازش ویدئو و ارتباطات |
| CPU | پایینتر | پردازشگر برای مدیریت جلسه ویدئویی |
| دیسک | کمترین | ذخیرهسازی موقت و لاگها |
- هندبوک در صفحهٔ Requirements هیچ عددی برای تعداد شرکتکننده ارائه نمیدهد؛ بنابراین، تخمین منابع باید بر اساس اهمیت عوامل بالا انجام شود.
- مثال: 20 کاربر 4K در سرور با پهنای 100 مگابیت در ثانیه امکانپذیر نیست؛ در این صورت، برای رشد، بهتر است `videobridge` را به سرور بزرگتر منتقل کنیم.
- برای جلسات بیش از 100 نفر، هندبوک در فایل `/etc/systemd/system.conf` محدودیتهای زیر را پیشنهاد میکند:
SystemMaxUsers=100
سپس با دستور `sudo systemctl daemon-reload` و راهاندازی مجدد `jitsi-videobridge2` این محدودیت اعمال میشود.
ضبط جلسه با Jibri
- هر نمونهٔ Jibri فقط میتواند یک جلسه را ضبط کند.
- برای رزولوشن 1080×720، حداقل 8 گیگابایت RAM لازم است.
- هندبوک توصیه میکند Jibri را روی همان سرور جلسه نصب نکنید؛ بهتر است سرور جداگانهای برای ضبط داشته باشید.
سقف زمان جلسه
- در مستندات هندبوک تنظیمی برای محدودیت مدت جلسه وجود ندارد.
- برای پایان خودکار، ماژول `reservations` در Prosody از یک API خارجی برای تعیین زمان استفاده میکند و جلسه را پس از پایان زمان تعیینشده متوقف میکند.
- در مسیر نصب پیشفرض هندبوک، هیچ محدودیت دیگری تعریف نشده است.
مشکلات اتصال اپلیکیشن موبایل
- اگر اپلیکیشن موبایل متصل نمیشود ولی مرورگر کار میکند، احتمالاً زنجیره کامل گواهی (fullchain) در Nginx تنظیم نشده است.
- در Let’s Encrypt، خط `ssl_certificate` باید به فایل `fullchain.pem` اشاره کند.
- استفاده از گواهی خودامضا معمولاً باعث جلوگیری از اتصال اپلیکیشن میشود.
برگزاری جلسه بدون دامنه
- نصبکننده میتواند IP ثابت را بپذیرد، اما مستندات هندبوک بهطور پیشفرض از دامنه و گواهی Let’s Encrypt استفاده میکند.
- در صورتی که کاربران از گوشی وارد میشوند، پیشنهاد میشود دامنهای را تهیه کنید تا اتصال امن برقرار شود.
سازگاری با Ubuntu 22.04
- فهرست مستندات هندبوک از Ubuntu 24.04 شروع میشود؛ بنابراین، نصب بر روی Ubuntu 22.04 ممکن است نیاز به بررسی سازگاری داشته باشد.
ورود مهمانان خارج از سازمان پس از فعالسازی احراز هویت
- پس از فعالسازی احراز هویت، مهمانان خارج از سازمان همچنان میتوانند وارد جلسه شوند؛ زیرا احراز هویت فقط برای ایجاد اتاق اعمال میشود و دسترسی به اتاق توسط کاربران ناشناس مجاز است.
ساخت و مدیریت جلسات در سرور شخصی
- ایجاد اتاق: تنها نیاز به تعریف نام اتاق است؛ سایر کاربران از دامنهی مهمان وارد میشوند.
- پایان خودکار جلسات: در حالت پیشفرض، جلسه پس از مدتی بهصورت خودکار تمام نمیشود؛ برای فعالسازی این ویژگی باید ماژول reservations در Prosody را نصب و یک API رزرو پیادهسازی کنید.
- ضبط جلسات: فنی امکان ضبط بر روی همان سرور وجود دارد، اما توصیه میشود از Jibri استفاده نکنید؛ مصرف بالای آن میتواند دیسک سرور را سریع پر کند.
- مکانیزم لاگ: برای تشخیص خطاها، فایلهای لاگ زیر را بررسی کنید
`/var/log/jitsi/jvb.log`، `/var/log/jitsi/jicofo.log` و `/var/log/prosody/prosody.log`.
نکات کلیدی برای راهاندازی موفق
- دامنه و گواهی: دامنهی خود را با گواهی Let’s Encrypt پیکربندی کنید.
- پورتها: پورتهای 10000/UDP و 5349/TCP باید باز باشند.
- NAT: در فایل `jvb.conf`، نگاشت NAT را برای IP خصوصی سرور تنظیم کنید.
- احراز هویت: از توکن JWT برای ورود کاربران استفاده کنید.
- سایز سرور: با توجه به تعداد همزمان کاربران، سایز سرور را از بخش شبکه شروع کنید.
- عیبیابی: در صورت بروز مشکل، ابتدا لاگهای `jvb.log`، `jicofo.log` و `prosody.log` را مرور کنید.
پیامرسانی در کنار جلسات
- تیمهای فعال بر روی سرور خود، معمولاً ترجیح میدهند پیامهایشان را نیز در همان محیط داشته باشند.
- مقایسهی Mattermost با رقبای آن میتواند انتخاب مناسبتری برای تیم شما فراهم کند.
- در اولین جلسهی خود، هر گونه اختلال معمولاً در یک خط از `jvb.log` قابل مشاهده است؛ این خط میتواند بهعنوان سند اولیه برای رفع اشکال مورد استفاده قرار گیرد.
منابع مستندات رسمی Jitsi
- راهنمای نصب بر روی Debian و Ubuntu
- نیازمندیهای سختافزاری و نرمافزاری
- پرسشهای متداول و راهنمای NAT
- احراز هویت با توکن JWT
- راهاندازی سیستم رزرو و مدت زمان جلسات

کمپین ابتکار نو
کمپین ایده های نو
کمپین آینده روشن
کمپین طراحی مدرن