Hướng dẫn cài đặt

Cài đặt MaxiPBX trên máy chủ của bạn

Mười bước, từ tên miền của PBX đến lần truy cập đầu tiên vào giao diện. Trước tiên, bạn chuẩn bị FQDN và tường lửa, sau đó Control Plane tạo một script duy nhất để bạn chạy qua SSH, rồi một trình hướng dẫn trên web sẽ tiếp quản phần cấu hình.

Trước khi bắt đầu

  • Một máy chủ Debian 13 vừa cài đặt mới, không có dịch vụ hay ứng dụng nào khác.
  • Quyền truy cập SSH bằng tài khoản root (hoặc một tài khoản có thể chuyển sang root).
  • Một tên miền mà bạn quản lý vùng DNS, để tạo FQDN cho PBX (ví dụ pbx.yourdomain.com).
  • Một tài khoản trên MaxiPBX Control Plane, tại my.maxipbx.com.
  • Quyền truy cập vào tường lửa hoặc bộ định tuyến đặt trước máy chủ, để mở các cổng cần thiết.
Trước khi cài đặt

Chuẩn bị mạng

  1. Bước 1 : Tạo FQDN cho máy chủ

    Trước hết, hãy đặt cho PBX một tên miền đầy đủ (FQDN), ví dụ pbx.yourdomain.com. Trong vùng DNS của tên miền, hãy trỏ tên này đến địa chỉ IP của máy chủ:

    Lưu ýFQDN phải trỏ đến máy chủ của bạn ngay khi bạn bắt đầu cài đặt (bước 8). Hãy tạo nó trước tiên.

    TênLoạiGiá trị
    pbx.yourdomain.com A Địa chỉ IPv4 của máy chủBắt buộc
    pbx.yourdomain.com AAAA Địa chỉ IPv6 của máy chủNếu máy chủ có địa chỉ IPv6

    MẹoMột thay đổi DNS có thể mất vài phút để được cập nhật. Để kiểm tra tên miền có phân giải đúng về IP của máy chủ, hãy chạy “ping pbx.yourdomain.com” từ máy tính của bạn.

  2. Bước 2 : Mở các cổng trên tường lửa

    PBX có tường lửa riêng, chỉ mở đúng những cổng cần thiết. Nếu có tường lửa hoặc bộ định tuyến đặt phía trước (tường lửa của nhà cung cấp hosting, bộ định tuyến doanh nghiệp, modem internet), hãy mở tất cả các cổng dưới đây trên thiết bị đó, từ bên ngoài vào PBX.

    Lưu ýCổng 8443 TCP chỉ cần thiết trong quá trình cài đặt: đây là cổng của trình hướng dẫn cài đặt (bước 10). Hãy mở cổng này trước khi bắt đầu cài đặt, sau đó đóng lại khi PBX đã được kích hoạt: cổng này không còn cần thiết nữa.

    CổngGiao thứcDịch vụCông dụng
    8443 Chỉ trong quá trình cài đặt TCP Trình hướng dẫn Trình hướng dẫn cài đặt (bước 10). Đóng lại sau khi PBX được kích hoạt
    80 TCP Nginx Cấp phát cấu hình điện thoại qua HTTP, gia hạn chứng chỉ Let's Encrypt
    443 TCP Nginx Giao diện web, API, ứng dụng di động và máy tính, điện thoại web (WebRTC), cấp phát cấu hình qua HTTPS
    5060 UDP + TCP Kamailio SIP: điện thoại, softphone, trunk của nhà mạng
    5061 TCP Kamailio SIP mã hóa (TLS), chứng chỉ ECDSA
    5062 TCP Kamailio SIP mã hóa (TLS), chứng chỉ RSA cho các điện thoại không hỗ trợ ECDSA
    30000-40000 UDP rtpengine Âm thanh (RTP) cho tất cả cuộc gọi: thiếu các cổng này sẽ không có âm thanh
    3478-3479 UDP + TCP coturn STUN/TURN: âm thanh cho ứng dụng và điện thoại web phía sau NAT
    5349-5350 UDP + TCP coturn TURN mã hóa (TLS), cùng vai trò trên các mạng hạn chế
    389 TCP MaxiPBX API Danh bạ LDAP cho điện thoại
    10389 TCP MaxiPBX API Danh bạ LDAP trên cổng thay thế, dành cho một số mẫu điện thoại
    22 TCP SSH Quản trị từ xa và bảo trì bởi MaxiPBX. Có thể giới hạn cho các địa chỉ IP của chúng tôi

    MẹoNếu PBX nằm sau NAT (địa chỉ IP riêng), hãy thiết lập chuyển tiếp cổng cho toàn bộ danh sách này đến IP nội bộ của nó, với cùng dải RTP 30000-40000 UDP.

Trong Control Plane

Tạo khóa cài đặt

  1. Bước 3 : Đăng nhập vào Control Plane

    Mở my.maxipbx.com trong trình duyệt và đăng nhập bằng tài khoản của bạn. Control Plane là nơi bạn quản lý toàn bộ hệ thống PBX của mình.

    Mở Control Plane
  2. Bước 4 : Mở danh sách PBX

    Trong menu, chọn “Hệ thống PBX”, sau đó nhấp vào “PBX”. Tại đây bạn sẽ thấy tất cả các PBX đã liên kết với tài khoản của mình.

  3. Bước 5 : Tạo khóa cài đặt

    Nhấp vào “Tạo khóa cài đặt”. Khóa này liên kết máy chủ tương lai với tài khoản của bạn: sau khi cài đặt, máy chủ sẽ xuất hiện trực tiếp trong hệ thống của bạn.

  4. Bước 6 : Hiển thị và sao chép script cài đặt

    Hiển thị script cài đặt và sao chép toàn bộ. Script đã chứa sẵn khóa của bạn: bạn không cần sửa đổi gì.

    Lưu ýScript chứa một khóa riêng của tài khoản bạn. Không chia sẻ hoặc công bố nó ở bất kỳ đâu.

Trên máy chủ của bạn

Tiến hành cài đặt

  1. Bước 7 : Kết nối qua SSH bằng tài khoản root

    Từ một terminal (hoặc một ứng dụng như PuTTY trên Windows), hãy kết nối đến máy chủ Debian 13 mới của bạn bằng tài khoản root. Thay YOUR_IP bằng địa chỉ IP của máy chủ.

    ssh root@YOUR_IP

    MẹoNếu bạn đăng nhập bằng một tài khoản khác, hãy chuyển sang root bằng lệnh “su -” hoặc “sudo -i” trước khi tiếp tục.

  2. Bước 8 : Dán script và nhấn Enter

    Dán script cài đặt đã sao chép ở bước 6 vào terminal, sau đó nhấn Enter.

  3. Bước 9 : Để quá trình cài đặt tự chạy

    Tiến trình cài đặt được hiển thị trên màn hình theo thời gian thực. Hãy để nó chạy đến khi hoàn tất mà không can thiệp.

    Lưu ýKhông đóng terminal và không ngắt kết nối SSH trong quá trình cài đặt.

Trong trình duyệt của bạn

Hoàn tất cấu hình

  1. Bước 10 : Mở trình hướng dẫn cài đặt

    Khi cài đặt kết thúc, terminal sẽ hiển thị địa chỉ PBX của bạn theo dạng bên dưới. Mở địa chỉ này trong trình duyệt, sau đó làm theo trình hướng dẫn cài đặt: trình hướng dẫn sẽ dẫn dắt bạn qua phần cấu hình ban đầu.

    https://YOUR_IP:8443

    MẹoNếu trình duyệt hiển thị cảnh báo bảo mật về chứng chỉ trong lần truy cập đầu tiên này, bạn có thể tiếp tục truy cập trang để khởi chạy trình hướng dẫn.

    Cần trợ giúp?Nếu có bất kỳ thắc mắc nào khi sử dụng trình hướng dẫn, đừng ngần ngại liên hệ với đối tác đại lý MaxiPBX của bạn: họ luôn sẵn sàng hỗ trợ bạn.

PBX của bạn đã được cài đặt

Khi hoàn tất trình hướng dẫn, PBX của bạn đã sẵn sàng và được liên kết với hệ thống của bạn trong Control Plane. Giờ đây bạn có thể tạo người dùng, điện thoại và đường dây.

Cần hỗ trợ?

Đội ngũ của chúng tôi có thể hỗ trợ bạn trong quá trình cài đặt hoặc thực hiện thay bạn.