Cài o3o Meet lên máy chủ của bạn

o3o Meet là nền tảng họp và dạy học trực tuyến tự chủ hạ tầng: video/âm thanh WebRTC, bảng vẽ thời gian thực trên bài giảng, ghi hình, phòng chờ, điểm danh, trang quản trị và app Windows cho người chủ trì. Toàn bộ chạy trên máy chủ của chính bạn — dữ liệu, bản ghi hình, danh sách người dùng không rời khỏi máy.

Tổng quan

Cài đặt chỉ cần một dòng lệnh trên máy Ubuntu sạch. Bộ cài tự cài Docker, nginx, certbot; kéo mã nguồn; sinh mọi bí mật; xin chứng chỉ HTTPS; dựng dịch vụ; cài bộ cập nhật; rồi in đường vào trang chào mừng để bạn tự cấu hình logo, tên tổ chức, đăng nhập SSO và giấy phép trên trình duyệt. Thời gian cài trọn bộ khoảng 5–10 phút tuỳ tốc độ mạng của máy chủ.

curl -fsSL https://install.o3o.vn/meet/cai-o3o-meet.sh \
  | sudo bash -s -- --domain meet.congty.vn --email it@congty.vn

Thay meet.congty.vn bằng tên miền đã trỏ về máy và it@congty.vn bằng email nhận thông báo chứng chỉ. Chi tiết từng bước ở dưới.

1. Trước khi cài

Bộ cài kiểm và nhắc, nhưng không làm thay ba việc: chuẩn bị máy, trỏ DNS và mở tường lửa ở nhà cung cấp. Làm đủ ba việc này trước thì lần cài đầu sẽ xong ngay, không phải chạy lại.

Máy chủ

Mạng & tường lửa

Mở các cổng sau ở tường lửa của nhà cung cấp (security group / firewall của VPS). Bộ cài không tự mở vì mỗi nhà cung cấp một kiểu.

Tên miền (DNS)

Tạo một bản ghi A trỏ tên miền về IP công khai của máy, ví dụ meet.congty.vn → 203.0.113.10. Mặc định bộ cài dùng một tên miền duy nhất: LiveKit và máy chủ nét vẽ đi chung tên miền theo đường dẫn, cùng một chứng chỉ.

Muốn tách riêng (một số hệ thống proxy/CDN cần), thêm cờ --tach-ten-mien và tạo thêm ba bản ghi A cho livekit., ws., turn. nằm dưới tên miền chính (livekit.meet.congty.vn…). Cài kèm Keycloak thì thêm id.meet.congty.vn.

Kiểm DNS đã lan chưa (kết quả phải là IP máy):

dig +short A meet.congty.vn @1.1.1.1

2. Cài đặt

Đăng nhập SSH vào máy rồi chạy đúng một dòng. Bộ cài in tiến trình theo 7 bước và dừng ngay tại dòng gặp lỗi (có báo số dòng và lệnh hỏng).

curl -fsSL https://install.o3o.vn/meet/cai-o3o-meet.sh \
  | sudo bash -s -- --domain meet.congty.vn --email it@congty.vn

Cài xong, màn hình in ra ba thứ cần giữ lại:

• Đường vào trang chào mừng kèm khoá một lần: https://meet.congty.vn/chao-mung?khoa=…
• Mã chủ trì dùng chung (8 chữ số) — cách vào lớp khi chưa nối SSO
• Kết quả 7 phép kiểm tại chỗ (web, nét vẽ, LiveKit, ghi hình, bộ cập nhật, HTTPS) — mỗi dòng ĐẠT hoặc HỎNG kèm lý do

Tuỳ chọn dòng lệnh

Bộ cài làm gì (7 bước)

1. Phần mềm nền — cài Docker, nginx, certbot, git, dnsutils (chờ tối đa 5 phút nếu máy vừa khởi động còn đang tự cập nhật).
2. Mã nguồn — kéo kho vào /opt/o3o-meet (hoặc chép từ --nguon).
3. Sinh cấu hình — tạo /opt/o3o-meet/cai-dat/.env chứa toàn bộ bí mật (quyền 600), cấu hình LiveKit và ghi hình. Chạy lại thì giữ nguyên bí mật cũ; đổi --domain thì chỉ cập nhật tên miền.
4. nginx — site riêng cho tên miền, chuyển tiếp /rtc tới LiveKit và /ws tới máy chủ nét vẽ.
5. DNS và chứng chỉ — kiểm từng tên miền có trỏ về máy chưa, xin chứng chỉ Let's Encrypt (webroot), cài hook gia hạn tự động. DNS chưa đúng thì dịch vụ vẫn dựng; chạy lại sau khi DNS đúng.
6. Dựng dịch vụ — docker compose build + up -d: redis, livekit, egress (ghi hình), annotation-server, web-app (và keycloak nếu chọn); cài dịch vụ cập nhật o3o-cap-nhat.
7. Kiểm tại chỗ — 7 phép ĐẠT/HỎNG kèm log khi hỏng, rồi in đường vào trang chào mừng và mã chủ trì.

3. Sau khi cài

Trang chào mừng

Mở đường dẫn https://meet.congty.vn/chao-mung?khoa=… mà bộ cài in ra. Khoá dùng một lần; lỡ đóng terminal thì đọc lại trên máy chủ: sudo cat /data/config/khoa-cai-dat.txt. Trang gồm 5 bước:

1. Tổ chức & logo — tên tổ chức hiện trên trang vào, ngôn ngữ, logo PNG/JPEG (logo ngang, logo vuông, biểu tượng).
2. Đăng nhập SSO & quản trị viên — địa chỉ Keycloak/OIDC (issuer, client id, client secret) và email quản trị viên. Đây là bước quan trọng nhất: trang /admin chỉ vào được bằng SSO với email trong danh sách này.
3. Máy chủ media — thường bỏ qua. Chỉ điền khi muốn đặt LiveKit ở máy khác hoặc thêm máy chia tải.
4. Giấy phép — dán khoá giấy phép nếu đã có (có thể nhập sau ở trang admin).
5. Hoàn tất — hệ thống ghi cờ đã cài rồi mới xoá khoá một lần; ghi không được (đĩa đầy…) thì báo lỗi và giữ khoá để bạn thử lại.

Quản trị & đường vào

Mã chủ trì dùng chung (in ra cuối bộ cài, lưu ở TEACHER_CODE trong .env) là phương án khi chưa nối SSO: ai có mã này mở được phòng với vai chủ trì. Nối SSO xong nên tắt công tắc này ở /admin › Hệ thống.

4. Giấy phép

o3o Meet chạy được ngay không cần giấy phép ở mức tối đa 2 phòng mở cùng lúc — đủ để dùng thử và cho tổ chức nhỏ. Giấy phép nâng hạn mức số phòng theo tên miền và thời hạn; hết hạn có 30 ngày ân hạn rồi mới về mức 2 phòng. Phòng đang mở không bao giờ bị cắt — giấy phép chỉ chặn mở thêm phòng quá hạn mức.

• Nhập khoá ở bước 4 trang chào mừng, hoặc bất cứ lúc nào tại /admin › Giấy phép.
• Khoá được kiểm ngoại tuyến bằng chữ ký số — máy chủ của bạn không gọi về đâu cả.
• Xin hoặc gia hạn giấy phép: liên hệ o3o qua o3o.vn, cung cấp tên miền đang cài và số phòng cần dùng cùng lúc.

5. Cập nhật

Vào /admin › Hệ thống, khối Phiên bản & cập nhật: bấm Kiểm bản mới để so với kho, rồi Cập nhật ngay. Việc cập nhật do dịch vụ o3o-cap-nhat trên máy chủ thực hiện (trang web không có quyền chạy docker — cố ý, để ai chiếm được web cũng không chiếm được máy). Mất 1–3 phút; web-app dựng lại nên người đang trong phòng bị ngắt khoảng 10 giây rồi tự nối lại — trang admin hỏi lại và cho biết đang có mấy phòng mở.

Dịch vụ tự kiểm bản mới mỗi ngày. Nhật ký cập nhật hiện ngay dưới nút; lần cập nhật lỗi thì nút đổi thành Thử cập nhật lại.

Máy cài từ --nguon chưa nối kho nên nút báo "chưa nối kho từ xa". Nối một lần trên máy chủ (bí mật và dữ liệu nằm ngoài git, không mất):

sudo o3o-cap-nhat noi-kho https://gitlab.apps.vn/khahuyvu/o3o-meet.git

Chạy tay khi cần: sudo o3o-cap-nhat kiem · sudo o3o-cap-nhat cap-nhat · nhật ký ở /data/config/cap-nhat.log.

6. Đổi tên miền · cài lại

Cài thử bằng tên tạm rồi đổi sang tên thật, hay chuyển tên miền: trỏ DNS mới về máy, rồi chạy lại bộ cài với --domain mới. Bí mật giữ nguyên; tên miền trong cấu hình, chứng chỉ, bản dựng web được làm lại; LiveKit tự khởi động lại với cấu hình mới. Đổi từ một tên miền sang bốn tên miền (thêm --tach-ten-mien) cũng làm y như vậy.

curl -fsSL https://install.o3o.vn/meet/cai-o3o-meet.sh \
  | sudo bash -s -- --domain meet-moi.congty.vn --email it@congty.vn

7. Sao lưu · gỡ cài

cd /opt/o3o-meet/cai-dat
sudo docker compose --env-file .env down -v
sudo systemctl disable --now o3o-cap-nhat
sudo rm -rf /opt/o3o-meet /data /usr/local/bin/o3o-cap-nhat \
  /etc/systemd/system/o3o-cap-nhat.service \
  /etc/nginx/sites-enabled/o3o-* /etc/nginx/sites-available/o3o-*
sudo nginx -t && sudo systemctl reload nginx

8. Khắc phục sự cố

Ba lệnh xem tình trạng trên máy chủ:

cd /opt/o3o-meet/cai-dat
sudo docker compose --env-file .env ps
sudo docker compose --env-file .env logs --tail 50 livekit egress web-app
sudo systemctl status o3o-cap-nhat --no-pager

Tài liệu thêm

• Bản script bộ cài (đọc trước khi chạy, nếu muốn): cai-o3o-meet.sh
• Kho mã nguồn: gitlab.apps.vn/khahuyvu/o3o-meet — tài liệu vận hành chi tiết (SERVER.md) và giấy phép sử dụng (LICENSE.md) nằm trong kho.
• Sổ tay cho người chủ trì sau khi cài: https://<tên miền của bạn>/sotay/
• Dùng thử không cần cài: meet.o3o.vn