بروزرسانی FreePBX به نسخه 17؛ راهنمای کامل مهاجرت از FreePBX 16 به 17 روی Debian 12

بروزرسانی FreePBX به نسخه 17؛ مهاجرت از FreePBX 16 روی CentOS به FreePBX 17 روی Debian 12
زمان مطالعه: ۷ دقیقهبه‌روزرسانی: 22 آبان 1405
فهرست مطالب
  1. چرا باید به FreePBX 17 مهاجرت کرد؟
  2. FreePBX 16 و FreePBX 17 چه فرقی دارند؟
  3. پیش از شروع: آماده‌سازی
  4. گام ۱: تکلیف chan_sip و Macro را روشن کنید
  5. گام ۲: پشتیبان کامل بگیرید
  6. گام ۳: FreePBX 17 را روی Debian 12 نصب کنید
  7. گام ۴: پشتیبان را بازیابی کنید
  8. گام ۵: آنچه با پشتیبان منتقل نمی‌شود
  9. گام ۶: آزمون و جابه‌جایی
  10. گام ۷: امنیت پس از مهاجرت
  11. پرسش‌های متداول
  12. آیا می‌توان FreePBX 16 را درجا به نسخه 17 ارتقا داد؟
  13. بروزرسانی FreePBX به نسخه 17 چقدر قطعی دارد؟
  14. آیا ضبط مکالمات و گزارش تماس‌ها منتقل می‌شوند؟
  15. داخلی‌های chan_sip بعد از مهاجرت کار می‌کنند؟
  16. لایسنس ماژول‌های تجاری چه می‌شود؟
  17. کارت آنالوگ یا E1 روی FreePBX 17 کار می‌کند؟
در یک نگاه
  • بروزرسانی FreePBX به نسخه 17 درجا انجام نمی‌شود؛ نسخه 17 فقط روی Debian 12 نصب می‌شود. نسخه‌های قبلی روی CentOS 7 بودند که پشتیبانی آن تمام شده است.
  • مسیر استاندارد این است: پشتیبان‌گیری روی سرور قدیم ← نصب FreePBX 17 روی سرور جدید ← بازیابی ← آزمون ← جابه‌جایی.
  • تنظیمات شبکه، Deployment ID و لایسنس ماژول‌های تجاری با فایل پشتیبان منتقل نمی‌شوند.
  • Asterisk نسخه 21 که همراه FreePBX 17 نصب می‌شود دیگر chan_sip و Macro ندارد؛ پیش از مهاجرت تکلیف آن‌ها را روشن کنید.

چرا باید به FreePBX 17 مهاجرت کرد؟

FreePBX 16 به‌طور رسمی روی توزیع SNG7 بر پایهٔ CentOS 7 عرضه می‌شد. پشتیبانی CentOS 7 در تیر ۱۴۰۳ (ژوئن ۲۰۲۴) تمام شد و از آن به بعد وصلهٔ امنیتی رسمی برای سیستم‌عامل منتشر نمی‌شود. برای مرکز تلفنی که به اینترنت یا شبکهٔ سازمان وصل است، ماندن روی سیستم‌عامل بدون پشتیبانی ریسک امنیتی جدی دارد.

FreePBX 17 روی Debian 12 ساخته شده و با PHP 8.2، Asterisk جدید و به‌روزرسانی‌های امنیتی منظم سیستم‌عامل، عمر مفید مرکز تلفن را چند سال افزایش می‌دهد. ساختار Dialplan هم از Macro به GoSub تغییر کرده است. اما چون سیستم‌عامل عوض می‌شود، این کار یک مهاجرت است و نه بروزرسانی با یک کلیک؛ برنامه‌ریزی درست آن مهم‌ترین بخش کار است.

FreePBX 16 و FreePBX 17 چه فرقی دارند؟

موضوعFreePBX 16FreePBX 17
سیستم‌عاملSNG7 بر پایهٔ CentOS 7 (بدون پشتیبانی)Debian 12
روش نصبفایل ISO آمادهنصب Debian 12 و اجرای اسکریپت رسمی
PHP7.48.2
Asterisk پیش‌فرضنسخه‌های 16 تا 20نسخه 21
درایور SIPchan_sip و PJSIPفقط PJSIP
DialplanMacroGoSub
مسیر ارتقاارتقای درجا از 15 ممکن بودسرور جدید و Backup & Restore
برنامه‌ریز مهاجرت به FreePBX 17
تعاملی

وضعیت سرور فعلی را انتخاب کنید تا نقشهٔ مهاجرت و نکته‌های پرخطر مخصوص شما ساخته شود.

نسخهٔ فعلی FreePBX
داخلی یا ترانک با chan_sip دارید؟
ماژول تجاری یا اختصاصی؟
کارت آنالوگ یا E1 (DAHDI)؟
سرور جدید همان IP قبلی را می‌گیرد؟

    پیش از شروع: آماده‌سازی

    سرور جدیدیک سرور یا ماشین مجازی جدا با Debian 12 آماده کنید. سرور قدیم تا پایان آزمون‌ها روشن و دست‌نخورده بماند تا راه بازگشت داشته باشید.
    فهرست اطلاعاتIP، Gateway، DNS، تنظیمات NAT و پورت‌ها، Deployment ID و فهرست ماژول‌ها و نسخه‌هایشان را از سرور قدیم یادداشت کنید.
    پنجرهٔ زمانیجابه‌جایی نهایی را در ساعتی با کمترین تماس برنامه‌ریزی کنید و به کاربران خبر دهید. زمان واقعی را در آزمون آزمایشی بسنجید.
    سازگاری سخت‌افزاراگر کارت آنالوگ یا E1 دارید، سازگاری درایور DAHDI یا Wanpipe با هستهٔ Debian 12 را پیش از هر کاری بررسی کنید.

    گام ۱: تکلیف chan_sip و Macro را روشن کنید

    Asterisk 21 که با FreePBX 17 نصب می‌شود، درایور قدیمی chan_sip و برنامهٔ Macro را ندارد. هر داخلی یا ترانکی که هنوز chan_sip است، پس از بازیابی کار نمی‌کند. بهتر است تبدیل را روی همان سرور قدیم انجام دهید و پیش از پشتیبان‌گیری آزمایش کنید. تفاوت دو درایور را در مقالهٔ تفاوت SIP و PJSIP ببینید.

    # list remaining chan_sip peers on the old server
    asterisk -rx "sip show peers"
    # PJSIP endpoints after conversion
    asterisk -rx "pjsip show endpoints"

    اگر کد سفارشی در فایل‌هایی مثل extensions_custom.conf دارید که از Macro() استفاده می‌کند، باید آن را به Gosub() بازنویسی کنید.

    گام ۲: پشتیبان کامل بگیرید

    در سرور قدیم از منوی Admin › Backup & Restore یک پشتیبان کامل بسازید:

    ۱روی Add Backup کلیک کنید.
    ۲برای پشتیبان نام و توضیح بنویسید.
    ۳همهٔ ماژول‌ها را انتخاب کنید.
    ۴محل ذخیره (Local یا FTP/SSH) را مشخص کنید.
    ۵ذخیره کنید و پشتیبان را اجرا کنید.
    ۶فایل را دانلود و در جای امن نگه دارید.

    همین کار از خط فرمان هم شدنی است:

    # list backup jobs and run one by its id
    fwconsole backup --list
    fwconsole backup --backup=<backup-id>
    # copy the archive to the new server
    scp /var/spool/asterisk/backup/<name>/*.tar.gz root@NEW_SERVER:/root/
    حجم پشتیباناگر به گزارش تماس‌ها و مکالمات ضبط‌شده در سرور جدید نیاز ندارید، ماژول CDR Reports و ضبط‌ها را از پشتیبان کنار بگذارید؛ حجم فایل و زمان کار خیلی کم می‌شود. می‌توانید ضبط‌های قدیمی را جداگانه بایگانی کنید.

    گام ۳: FreePBX 17 را روی Debian 12 نصب کنید

    ابتدا Debian 12 را طبق آموزش جامع نصب Debian 12 نصب کنید و سپس اسکریپت رسمی را با کاربر root اجرا کنید. جزئیات و گزینه‌های اسکریپت در آموزش نصب FreePBX 17 آمده است.

    cd /tmp
    wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
    bash /tmp/sng_freepbx_debian_install.sh

    نصب بسته به سخت‌افزار و سرعت اینترنت ممکن است نیم ساعت یا بیشتر طول بکشد. بعد از نصب، از طریق مرورگر وارد شوید، کاربر مدیر را بسازید و همهٔ ماژول‌ها را به آخرین نسخه برسانید.

    گام ۴: پشتیبان را بازیابی کنید

    در سرور جدید وارد Backup & Restore شوید، فایل را در بخش Restore بارگذاری و بازیابی را اجرا کنید. روش خط فرمان:

    fwconsole backup --restore=/root/<backup-file>.tar.gz
    fwconsole ma upgradeall
    fwconsole chown
    fwconsole reload

    اگر پشتیبان از FreePBX 14 یا 15 است، اول بازیابی را روی سرور آزمایشی امتحان کنید. اگر خطا گرفتید، مطمئن‌ترین راه این است که سرور قدیم را ابتدا به FreePBX 16 برسانید و از آنجا پشتیبان بگیرید.

    گام ۵: آنچه با پشتیبان منتقل نمی‌شود

    تنظیمات شبکهIP، Gateway، DNS و تنظیمات NAT در Asterisk SIP Settings را دستی بررسی و وارد کنید.
    Deployment ID و لایسنساگر ماژول تجاری دارید، پیش از خاموش کردن سرور قدیم Deployment ID را کپی کنید و لایسنس را برای سرور جدید منتقل کنید.
    ماژول‌های اختصاصیماژول‌های شخص ثالث یا سفارشی را از سازنده‌شان در نسخهٔ سازگار با FreePBX 17 دریافت کنید.
    فایل‌های بیرون از FreePBXاسکریپت‌ها، Cronها، فایل‌های صوتی دستی و تنظیمات سیستم‌عامل را جداگانه منتقل کنید.

    گام ۶: آزمون و جابه‌جایی

    پیش از جابه‌جایی نهایی، سرور جدید را با یک IP موقت آزمایش کنید:

    asterisk -rx "pjsip show registrations"
    asterisk -rx "pjsip show endpoints"
    fwconsole ma list
    • ثبت ترانک‌ها (سیپ ترانک یا سیپ فون مخابرات) و داخلی‌ها
    • تماس ورودی و خروجی، منوی گویا، صف‌ها، ضبط مکالمه، پست صوتی و گزارش تماس
    • کارت‌های آنالوگ یا E1 و نمایش شماره روی آن‌ها

    اگر سرور جدید IP قبلی را می‌گیرد، در پنجرهٔ زمانی برنامه‌ریزی‌شده سرور قدیم را از شبکه جدا و IP را منتقل کنید. اگر IP عوض می‌شود، پیش از جابه‌جایی آن را به مخابرات یا سرویس‌دهندهٔ ترانک اعلام کنید؛ بسیاری از ترانک‌ها فقط از IP ثبت‌شده تماس می‌پذیرند. تنظیم تلفن‌ها (Provisioning) را هم به سرور جدید ارجاع دهید. سرور قدیم را دست‌کم یکی دو هفته خاموش ولی سالم نگه دارید.

    گام ۷: امنیت پس از مهاجرت

    فایروال FreePBXماژول Firewall و Responsive Firewall را فعال کنید و شبکه‌های مورد اعتماد را تعریف کنید.
    SSH محدودورود root با رمز را ببندید، از کلید SSH استفاده کنید و دسترسی را به IPهای مدیریتی محدود کنید.
    رمزهای تازهرمز مدیر، داخلی‌ها و ترانک‌ها را عوض کنید؛ رمز ضعیف داخلی‌ها رایج‌ترین راه سوءاستفاده از خطوط است.
    به‌روزرسانی منظمبه‌روزرسانی خودکار ماژول‌های امنیتی را فعال کنید و Debian را مرتب وصله کنید.

    فهرست کامل اقدام‌ها را در راهنمای امنیت ویپ (VoIP) ببینید.

    نقشهٔ مهاجرت FreePBX 16 به FreePBX 17 در هفت گام
    هفت گام بروزرسانی FreePBX به نسخه 17 در یک نگاه

    پرسش‌های متداول

    آیا می‌توان FreePBX 16 را درجا به نسخه 17 ارتقا داد؟

    نه. FreePBX 17 فقط روی Debian 12 نصب می‌شود و نسخه 16 روی CentOS 7 است. باید سرور جدید بسازید و تنظیمات را با Backup & Restore منتقل کنید.

    بروزرسانی FreePBX به نسخه 17 چقدر قطعی دارد؟

    اگر سرور جدید را موازی آماده و آزمایش کنید، قطعی فقط به زمان جابه‌جایی IP یا ترانک محدود می‌شود. زمان دقیق را در یک آزمون آزمایشی روی همان شبکه بسنجید.

    آیا ضبط مکالمات و گزارش تماس‌ها منتقل می‌شوند؟

    بله، اگر ماژول CDR Reports و ضبط‌ها را در پشتیبان انتخاب کنید. اگر حجمشان زیاد است، می‌توانید آن‌ها را جدا بایگانی کنید تا پشتیبان سبک‌تر شود.

    داخلی‌های chan_sip بعد از مهاجرت کار می‌کنند؟

    نه. Asterisk 21 درایور chan_sip ندارد؛ داخلی‌ها و ترانک‌ها را پیش از مهاجرت به PJSIP تبدیل و آزمایش کنید.

    لایسنس ماژول‌های تجاری چه می‌شود؟

    لایسنس به Deployment ID سرور وابسته است و با پشتیبان منتقل نمی‌شود. پیش از خاموش کردن سرور قدیم Deployment ID را یادداشت کنید و لایسنس را برای سرور جدید منتقل کنید.

    کارت آنالوگ یا E1 روی FreePBX 17 کار می‌کند؟

    در صورت سازگاری درایور DAHDI یا Wanpipe با هستهٔ Debian 12 بله. اسکریپت نصب نسخهٔ هستهٔ سازگار را نشان می‌دهد؛ پیش از مهاجرت آن را بررسی کنید.

    زنبیل خرید