Các hướng dẫn này ánh xạ khái niệm của ngành lên đối tượng nền tảng đang có (bouquet, line, gói, tài khoản đối tác, node, API). Đây là ánh xạ khái niệm, không phải tính năng riêng của ngành, và tài khoản đối tác là tài khoản uỷ quyền, không phải tenant tách biệt.
Ánh xạ khái niệm
Không có gì trong panel được gọi là gói thuê bao hay điểm hiện diện. Bảng cho biết đối tượng nào đóng vai trò nào; các chương bên dưới thiết lập chúng theo thứ tự đó.
| Trong ngành của bạn | Trên nền tảng | Ở đâu trong panel |
|---|---|---|
| Tài khoản đại lý hoặc đối tác khu vực | Tài khoản đối tác (reseller): dashboard uỷ quyền có credit, quyền hạn và line riêng | Users → thêm reseller; Groups cho quyền hạn |
| Hạng kênh hoặc gói bổ sung | Bouquet: một tập kênh, phim hay series có tên mà một gói cấp quyền | Bouquets, từ Streams và Movies / Series |
| Kênh truyền hình | Kênh trực tiếp: một luồng với nguồn, EPG và định dạng đầu ra | Streams → thêm live stream (URL nguồn hoặc RTMP push) |
| Thư viện VOD | Danh mục VOD: phim và series có mùa và tập, danh mục và metadata | Movies và Series, hoặc job ingest VOD |
| Quyền xem truyền hình của thuê bao | Line: một quyền truy cập với gói, bouquet, hạn, giới hạn kết nối và đầu ra | Lines → thêm, hoặc mã kích hoạt, hoặc Reseller API |
| Cuối kỳ thanh toán | Ngày hết hạn của line, gia hạn bằng gói, credit hay API | Ngày hết hạn của line và thời lượng của gói |
| Màn hình trên mỗi thuê bao | Số kết nối tối đa của line: bao nhiêu thiết bị xem cùng lúc | Max connections của line |
| Tích hợp thanh toán và cấp phát | Reseller API và webhook: các thao tác của panel từ hệ thống của bạn | Reseller API key và webhook trong dashboard của reseller |
| Node tại điểm hiện diện | Node phát video: máy chủ biên enroll từ panel, một node mỗi cơ sở hay toà nhà | Servers → thêm node, cài qua SSH |
Điều kiện tiên quyết
Những thứ cần có trước khi cài đặt.
- Một máy chủ tại trung tâm lõi (Ubuntu 22.04 hoặc 24.04), bộ cài, một tên miền hoặc địa chỉ mà thuê bao truy cập được, và một máy chủ ở mỗi điểm hiện diện cho các node.
- Các luồng kênh có bản quyền, thư viện VOD, và hệ thống thanh toán nơi các gói thuê bao được quản lý.
- Quyết định về các hạng gói, một kỳ thanh toán kéo dài bao lâu, và đại lý nào được cấp tài khoản đối tác.
Triển khai hạ tầng
Trung tâm lõi, sau đó là các điểm hiện diện.
- Chạy bộ cài trên máy chủ lõi; đặt panel sau reverse proxy của bạn và đặt TRUSTED_PROXIES để log và quy tắc IP thấy địa chỉ thật của thuê bao.
- Đặt địa chỉ gốc phát thành địa chỉ công khai mà thuê bao truy cập, và đặt khoá license trên máy chủ.
- Đăng ký một node cho mỗi điểm hiện diện từ Servers; panel cài nó qua SSH, hoặc node tự đăng ký bằng mã dùng một lần, và định tuyến các thuê bao ở gần tới node.
- Tạo tài khoản đối tác (reseller) cho bộ phận hỗ trợ hoặc đội thanh toán chỉ với quyền về line.
Tổ chức nội dung
Hạng gói và gói bổ sung là bouquet.
- Thêm các kênh trong Streams và thư viện VOD trong Movies và Series, với danh mục và một nguồn EPG.
- Tạo bouquet cho danh sách kênh cơ bản, các kênh cao cấp và thư viện VOD.
- Tạo một gói cho mỗi hạng thuê bao với các bouquet nó cấp, kỳ thanh toán làm thời hạn và giá bằng credit.
- Tạo một gói dùng thử ngắn cho khuyến mãi hoặc khách hàng mới.
Cấu hình đối tác (reseller)
Đại lý có credit.
- Tạo một nhóm cho đại lý với quyền đối với line của chính họ và không truy cập danh mục hay cài đặt.
- Thêm từng đại lý khu vực làm tài khoản đối tác với nhóm đó, các gói được bán và số dư credit; một đại lý có thể có sub-reseller sâu tới năm cấp.
- Webhook credits.low và thông báo credit thấp nhắc đại lý nạp thêm trước khi việc bán dừng lại.
Cấu hình line thuê bao
Một line cho mỗi gói thuê bao.
- Hệ thống thanh toán tạo line khi gói thuê bao bắt đầu, qua connector hoặc action=create_line của Reseller API với gói của hạng và một request id.
- Đặt số kết nối tối đa theo hạng, là số màn hình một hộ được dùng cùng lúc.
- Gắn line với địa chỉ, quốc gia hoặc ISP của thuê bao khi ưu đãi chỉ dành cho mạng của bạn.
- Cho đợt thử nghiệm hoặc ca hỗ trợ, thêm line từ Lines → add và gửi thông tin đăng nhập.
Thư viện VOD
Danh mục theo yêu cầu.
- Thêm phim và series có mùa và tập, nạp bằng tác vụ VOD ingest hoặc tải lên, kèm siêu dữ liệu TMDB cho poster và mô tả.
- Gom các tựa phim vào bouquet theo hạng hoặc gói bổ sung, để một gói cấp đúng những gì gói thuê bao bao gồm.
- Các node cache tệp VOD, nên các tựa phim phổ biến được phục vụ từ điểm hiện diện gần thuê bao.
Kênh trực tiếp
Danh sách kênh.
- Thêm từng kênh có bản quyền trong Streams cùng luồng của nó và chỉ bật catch-up hoặc timeshift ở nơi bản quyền cho phép.
- Thêm một nguồn EPG để ứng dụng và box hiển thị lịch chương trình.
- Mỗi node lấy một kênh trực tiếp một lần từ origin và phân phối lại cho các thuê bao của mình.
Hết hạn, gia hạn và huỷ
Kỳ thanh toán là hiệu lực của line.
- Một line tồn tại trong thời hạn của gói; hệ thống thanh toán gia hạn nó mỗi kỳ bằng action=renew_line hoặc qua connector.
- Khi một gói thuê bao hết hạn hoặc bị huỷ, hệ thống thanh toán gọi action=disable_line, và bật lại line khi kích hoạt lại.
- Đăng ký hệ thống thanh toán vào các webhook để đối soát các line sắp hết hạn và đã hết hạn với số liệu của mình.
Tích hợp với hệ thống thanh toán
Hệ thống thanh toán điều khiển quyền truy cập; player phát.
- Cài connector cho hệ thống thanh toán của bạn ở phía nó (WHMCS, Blesta, Odoo và các hệ thống khác), hoặc gọi Reseller API với một khoá và request id từ hệ thống của bạn.
- Không có đăng nhập một lần cho người xem: thuê bao đăng nhập vào ứng dụng hoặc box bằng thông tin của line, mà hệ thống thanh toán có thể hiển thị trong khu vực khách hàng.
- Dùng khoá Admin API có cờ chỉ đọc, danh sách IP cho phép và ngày hết hạn cho các công cụ báo cáo.
Lưu ý về bảo mật
Giữ dịch vụ cho thuê bao.
- Đặt panel sau reverse proxy có TLS và đặt TRUSTED_PROXIES; giữ lưu lượng quản lý của các node trên mạng riêng.
- Đăng nhập hai lớp cho mọi tài khoản panel và nhóm quyền cho bộ phận hỗ trợ và đại lý; reCAPTCHA hoặc Turnstile ở trang đăng nhập.
- Liên kết phát được ký và có hạn, giới hạn kết nối theo gói thuê bao, và gắn với địa chỉ, quốc gia hoặc ISP khi phù hợp.
- Sao lưu cơ sở dữ liệu mã hoá kèm bản sao ngoài site, và nhật ký kiểm toán cho mọi thay đổi của line và credit.
Xử lý sự cố
Những kiểm tra đầu tiên thường gặp.
- Một thuê bao không có truyền hình: kiểm tra line đang bật và chưa hết hạn, sau đó kiểm tra lệnh gọi của hệ thống thanh toán trong log Reseller API.
- Một kênh thiếu ở một hạng: kiểm tra các bouquet của gói thuộc hạng đó.
- Một điểm hiện diện bị giật: kiểm tra heartbeat của node và các thuê bao của nó có được định tuyến tới node không.
- Một đại lý không tạo được line: kiểm tra credit của họ và gói đó có thuộc loại họ được bán không.