راهنمای نصب

MaxiPBX را روی سرور خود نصب کنید

ده گام، از نام دامنه PBX شما تا نخستین ورود به رابط کاربری. ابتدا FQDN و فایروال را آماده می‌کنید، سپس Control Plane یک اسکریپت منحصربه‌فرد تولید می‌کند که آن را از طریق SSH اجرا می‌کنید و در پایان یک دستیار وب پیکربندی را بر عهده می‌گیرد.

پیش از شروع

  • یک سرور Debian 13 تازه نصب‌شده، بدون هیچ سرویس یا برنامه دیگری.
  • دسترسی SSH با حساب root (یا حسابی که بتواند به root ارتقا یابد).
  • یک نام دامنه که منطقه DNS آن را مدیریت می‌کنید، برای ایجاد FQDN مربوط به PBX شما (برای نمونه pbx.yourdomain.com).
  • یک حساب در MaxiPBX Control Plane، به نشانی my.maxipbx.com.
  • دسترسی به فایروال یا روتری که جلوی سرور قرار دارد، برای باز کردن پورت‌های لازم.
پیش از نصب

آماده‌سازی شبکه

  1. گام 1 : FQDN سرور خود را ایجاد کنید

    پیش از هر چیز، یک نام دامنه کامل (FQDN) به PBX خود اختصاص دهید، برای نمونه pbx.yourdomain.com. در منطقه DNS دامنه خود، این نام را به نشانی IP سرورتان ارجاع دهید:

    توجههنگام آغاز نصب (گام 8)، FQDN باید از پیش به سرور شما اشاره کند. ابتدا آن را ایجاد کنید.

    نامنوعمقدار
    pbx.yourdomain.com A نشانی IPv4 سرور شماالزامی
    pbx.yourdomain.com AAAA نشانی IPv6 سرور شمادر صورتی که سرور شما نشانی IPv6 داشته باشد

    نکتهانتشار تغییرات DNS ممکن است چند دقیقه طول بکشد. برای اطمینان از اینکه نام به نشانی IP سرور شما ترجمه می‌شود، دستور «ping pbx.yourdomain.com» را از رایانه خود اجرا کنید.

  2. گام 2 : پورت‌های فایروال را باز کنید

    PBX فایروال مخصوص به خود را دارد که دقیقاً پورت‌های مورد نیازش را باز می‌کند. اگر فایروال یا روتری جلوی آن قرار دارد (فایروال ارائه‌دهنده میزبانی، روتر سازمانی، مودم اینترنت)، همه پورت‌های زیر را روی آن، از بیرون به سمت PBX، باز کنید.

    توجهپورت 8443 TCP فقط در زمان نصب لازم است: دستیار نصب (گام 10) از آن استفاده می‌کند. پیش از آغاز نصب آن را باز کنید و پس از فعال‌سازی PBX دوباره ببندید: دیگر نیازی به آن نیست.

    پورتپروتکلسرویسکاربرد
    8443 فقط در زمان نصب TCP دستیار دستیار نصب (گام 10). پس از فعال‌سازی PBX آن را دوباره ببندید
    80 TCP Nginx پیکربندی خودکار تلفن‌ها از طریق HTTP، تمدید گواهی‌های Let's Encrypt
    443 TCP Nginx رابط وب، API، برنامه‌های موبایل و دسکتاپ، تلفن وب (WebRTC)، پیکربندی خودکار از طریق HTTPS
    5060 UDP + TCP Kamailio SIP: تلفن‌ها، سافت‌فون‌ها، ترانک‌های اپراتورها
    5061 TCP Kamailio SIP رمزگذاری‌شده (TLS)، گواهی ECDSA
    5062 TCP Kamailio SIP رمزگذاری‌شده (TLS)، گواهی RSA برای تلفن‌هایی که از ECDSA پشتیبانی نمی‌کنند
    30000-40000 UDP rtpengine صدا (RTP) برای همه تماس‌ها: بدون این پورت‌ها صدایی وجود ندارد
    3478-3479 UDP + TCP coturn STUN/TURN: صدا برای برنامه‌ها و تلفن وب در پشت NAT
    5349-5350 UDP + TCP coturn TURN رمزگذاری‌شده (TLS)، با همان نقش در شبکه‌های محدود
    389 TCP MaxiPBX API دفترچه LDAP برای تلفن‌ها
    10389 TCP MaxiPBX API دفترچه LDAP روی پورت جایگزین، برای برخی مدل‌ها
    22 TCP SSH مدیریت و نگهداری از راه دور توسط MaxiPBX. قابل محدودسازی به نشانی‌های IP ما

    نکتهاگر PBX پشت NAT قرار دارد (نشانی IP خصوصی)، برای کل این فهرست، ارسال پورت (Port Forwarding) به نشانی IP داخلی آن را با همان بازه RTP 30000-40000 UDP تنظیم کنید.

در Control Plane

کلید نصب خود را تولید کنید

  1. گام 3 : وارد Control Plane شوید

    my.maxipbx.com را در مرورگر خود باز کنید و با حساب خود وارد شوید. Control Plane جایی است که کل ناوگان PBX خود را مدیریت می‌کنید.

    باز کردن Control Plane
  2. گام 4 : فهرست PBXهای خود را باز کنید

    در منو به «ناوگان PBX» بروید و سپس روی «PBX» کلیک کنید. در آنجا همه PBXهایی که از قبل به حساب شما متصل هستند نمایش داده می‌شوند.

  3. گام 5 : یک کلید نصب تولید کنید

    روی «تولید کلید نصب» کلیک کنید. این کلید سرور آینده را به حساب شما متصل می‌کند: پس از نصب، مستقیماً در ناوگان شما نمایان می‌شود.

  4. گام 6 : اسکریپت نصب را نمایش دهید و کپی کنید

    اسکریپت نصب را نمایش دهید و آن را به‌طور کامل کپی کنید. این اسکریپت از پیش حاوی کلید شماست: نیازی به تغییر چیزی در آن نیست.

    توجهاین اسکریپت حاوی کلیدی ویژه حساب شماست. آن را با کسی به اشتراک نگذارید و در هیچ جا منتشر نکنید.

روی سرور شما

نصب را اجرا کنید

  1. گام 7 : با حساب root از طریق SSH متصل شوید

    از یک ترمینال (یا کلاینتی مانند PuTTY در Windows)، با حساب root به سرور Debian 13 تازه خود متصل شوید. YOUR_IP را با نشانی IP سرور خود جایگزین کنید.

    ssh root@YOUR_IP

    نکتهاگر با حساب دیگری وارد شده‌اید، پیش از ادامه با دستور «su -» یا «sudo -i» به root تغییر وضعیت دهید.

  2. گام 8 : اسکریپت را جای‌گذاری کرده و Enter را بزنید

    اسکریپت نصبی را که در گام 6 کپی کرده‌اید در ترمینال جای‌گذاری کنید و سپس Enter را بزنید.

  3. گام 9 : اجازه دهید نصب کامل شود

    پیشرفت نصب به‌صورت هم‌زمان روی صفحه نمایش داده می‌شود. اجازه دهید بدون هیچ دخالتی تا پایان اجرا شود.

    توجهدر طول نصب، ترمینال را نبندید و اتصال SSH را قطع نکنید.

در مرورگر شما

پیکربندی را تکمیل کنید

  1. گام 10 : دستیار نصب را باز کنید

    در پایان نصب، ترمینال نشانی PBX شما را با قالبی که در زیر نشان داده شده نمایش می‌دهد. آن را در مرورگر خود باز کنید و سپس دستیار نصب را دنبال کنید: این دستیار شما را در پیکربندی اولیه راهنمایی می‌کند.

    https://YOUR_IP:8443

    نکتهاگر مرورگر شما در این نخستین بازدید هشدار امنیتی درباره گواهی نمایش داد، می‌توانید برای اجرای دستیار به سایت ادامه دهید.

    به کمک نیاز دارید؟اگر هنگام استفاده از دستیار تردیدی داشتید، با شریک فروشنده MaxiPBX خود تماس بگیرید: او برای همراهی شما آماده است.

PBX شما نصب شد

پس از تکمیل دستیار، PBX شما آماده است و به ناوگان شما در Control Plane متصل شده است. اکنون می‌توانید کاربران، تلفن‌ها و خطوط خود را ایجاد کنید.

به کمک نیاز دارید؟

تیم ما می‌تواند در طول نصب همراه شما باشد یا آن را به جای شما انجام دهد.