Razzia: tự dựng quiz kiểu Kahoot miễn phí cho sự kiện
Razzia là phần mềm quiz trực tiếp mã nguồn mở, tự host bằng Docker, gắn được thương hiệu. Cách cài, soạn câu hỏi và checklist dùng cho sự kiện doanh nghiệp.

Cứ đến mùa tất niên, hội nghị khách hàng hay buổi đào tạo nội bộ, câu hỏi quen thuộc lại xuất hiện: làm sao cho cả hội trường cùng cầm điện thoại lên chơi một phần quiz sôi nổi, có bảng xếp hạng, có bục vinh danh, mà không phải trả phí theo số người chơi hay lo dữ liệu nhân viên, khách hàng nằm trên máy chủ của bên thứ ba? Nhiều đơn vị chọn các nền tảng quiz trả phí quen thuộc, số khác thuê đội lập trình làm riêng với chi phí không nhỏ.
Có một lựa chọn thứ ba ít người để ý: dùng phần mềm quiz mã nguồn mở và tự cài lên máy chủ của mình. Trong số các dự án trên GitHub, Razzia (trước đây mang tên Rahoot) là cái tên đáng chú ý nhất hiện nay. Dự án tự giới thiệu là “nền tảng quiz tự host, mã nguồn mở dành cho các sự kiện quy mô nhỏ”, dùng giấy phép MIT và đã có khoảng 1.100 lượt gắn sao.
Bài viết này giới thiệu Razzia làm được gì, cách cài bằng Docker, cách soạn câu hỏi và gắn nhận diện thương hiệu, so sánh nhanh với ClassQuiz, kèm checklist để bạn dùng an toàn trong sự kiện thật của doanh nghiệp.
Câu trả lời ngắn: Razzia là phần mềm quiz trực tiếp miễn phí, mã nguồn mở (MIT), cài trên máy chủ của bạn bằng Docker. Quản trò chiếu câu hỏi lên màn hình lớn, người chơi vào bằng mã PIN hoặc mã QR và trả lời trên điện thoại; trả lời đúng và nhanh thì được nhiều điểm, cuối ván có bục vinh danh top 3. Hợp với tất niên, đào tạo, hội thảo quy mô vừa và nhỏ.
Tóm tắt nhanh
- Razzia là nền tảng quiz trực tiếp tự host, giấy phép MIT, khoảng 1.100 sao trên GitHub (tháng 11/2026).
- Có 4 kiểu câu hỏi: một đáp án, nhiều đáp án, ước lượng con số và thăm dò không chấm điểm.
- Mỗi câu chỉnh được thời gian (5–120 giây), điểm tối đa (mặc định 1000), điểm trừ khi sai, kèm ảnh, video hoặc âm thanh.
- Cài bằng một container Docker, dữ liệu nằm gọn trong thư mục
config.- Gắn được tên, màu, font, logo, hình nền theo thương hiệu qua tệp
theme.json.
Nội dung chính:
- Razzia là gì?
- Một ván quiz diễn ra thế nào?
- Bốn kiểu câu hỏi và cách dùng
- Cài đặt bằng Docker
- Soạn bộ câu hỏi
- Gắn nhận diện thương hiệu
- So sánh với ClassQuiz
- Hiểu lầm phổ biến
- Checklist trước sự kiện
- Câu hỏi thường gặp
- Kết luận
Razzia là gì?
Razzia là một ứng dụng web cho phép bạn tổ chức quiz trực tiếp nhiều người chơi, theo mô hình đã rất quen ở các sự kiện: một màn hình lớn hiển thị câu hỏi, mỗi người chơi dùng điện thoại hoặc máy tính của mình để chọn đáp án, hệ thống tự chấm điểm và cập nhật bảng xếp hạng. Trang chủ của dự án gọi Razzia là một “lựa chọn thay thế Kahoot miễn phí, mã nguồn mở và tự host”, đồng thời ghi rõ đây là dự án độc lập, không liên kết hay được tài trợ bởi bất kỳ nền tảng quiz nào khác.
Điểm khác biệt lớn nhất nằm ở chữ “tự host”. Bạn tải phần mềm về và chạy trên máy chủ của mình, có thể là một máy chủ ảo thuê theo tháng, máy chủ nội bộ công ty hay thậm chí một máy tính trong phòng sự kiện. Trang chủ Razzia nhấn mạnh: dữ liệu ở lại với bạn. Với doanh nghiệp, điều đó có nghĩa là danh sách người chơi, kết quả và nội dung câu hỏi (có thể chứa thông tin nội bộ trong buổi đào tạo) không phải gửi sang dịch vụ bên ngoài.
Về kỹ thuật, Razzia viết bằng TypeScript, chạy trên Node.js 24 trở lên, đóng gói sẵn ảnh Docker ralex91/razzia. Dự án có trình soạn quiz trong trang quản trò, hỗ trợ đặt sau các reverse proxy phổ biến như Traefik, Nginx, Caddy, và mở cả giao thức WebSocket lẫn HTTP API để bạn tự làm thiết bị hoặc giao diện riêng. Tài liệu của dự án còn đưa ví dụ một nút bấm vật lý dùng vi điều khiển ESP32, gợi ý hướng làm “nút bấm giành quyền trả lời” cho các gameshow trên sân khấu.

Một ván quiz diễn ra thế nào?
Luồng chơi của Razzia gần như giống hệt những gì người tham dự sự kiện đã quen, nên bạn không cần hướng dẫn nhiều. Người chơi mở trang chủ của ứng dụng và thấy ngay ô nhập mã PIN gồm 6 chữ số.

Phía quản trò (MC hoặc người phụ trách kỹ thuật) mở đường dẫn /manager, nhập mật khẩu quản trị, chọn bộ câu hỏi rồi tạo phòng. Màn hình chờ hiển thị đường dẫn tham gia, mã PIN cỡ lớn và một mã QR để người chơi quét bằng camera điện thoại. Tên người chơi hiện dần lên màn hình khi họ vào phòng, tạo không khí rất tốt khi chiếu lên màn LED sân khấu.

Khi quản trò bấm bắt đầu, câu hỏi lần lượt hiện lên màn hình lớn cùng đồng hồ đếm ngược và số người đã trả lời. Người chơi chọn đáp án trên máy của mình; theo mô tả trên trang chủ, ai trả lời đúng càng nhanh thì càng được nhiều điểm. Kết thúc ván, bục vinh danh hiện ba người dẫn đầu, đúng khoảnh khắc để MC mời lên trao quà.

Một chi tiết hữu ích cho sự kiện dài: nếu bạn đặt trường category (tên vòng) cho các câu hỏi liên tiếp, bảng xếp hạng chỉ hiện khi chuyển sang vòng mới. Nhờ vậy bạn chia được chương trình thành nhiều vòng như “Khởi động”, “Hiểu sản phẩm”, “Về đích” mà không làm gián đoạn nhịp chơi sau mỗi câu.
Bốn kiểu câu hỏi và cách dùng
Razzia có bốn kiểu câu hỏi. Mỗi kiểu hợp với một mục tiêu khác nhau, nên khi lên kịch bản bạn nên phối hợp thay vì chỉ dùng một kiểu suốt ván.

1. Một đáp án
Dạng quen thuộc nhất: chỉ một lựa chọn đúng trong 2–4 phương án. Đây là kiểu câu nên chiếm phần lớn bộ quiz vì dễ hiểu, dễ chấm và tạo cảm giác “đua tốc độ” rõ nhất.
2. Nhiều đáp án
Người chơi phải chọn tất cả các ý đúng. Razzia cho ba cách chấm: strict (khắt khe), balanced (cân bằng, mặc định) và lenient (dễ tính). Kiểu này hợp với câu hỏi đào tạo như “Những bước nào bắt buộc trong quy trình đổi trả?” vì buộc người chơi nhớ đủ, không đoán may.
3. Ước lượng
Người chơi đoán một con số bằng thanh trượt hoặc ô nhập, ví dụ năm thành lập công ty, số cửa hàng trên toàn quốc hay số km đường chạy của giải marathon nội bộ. Bạn đặt khoảng sai số chấp nhận (margin): đoán trúng tuyệt đối được điểm tối đa, chạm mép sai số được một nửa, ngoài khoảng thì không có điểm. Đây là kiểu câu tạo nhiều tiếng cười nhất trong hội trường.
4. Thăm dò
Bật chế độ survey thì không có đáp án đúng sai, không chấm điểm, kết quả hiện ngay trên màn hình. Bạn dùng được cho khảo sát nhanh sau buổi đào tạo, bình chọn tiết mục văn nghệ hay hỏi khách hàng tính năng họ muốn nhất.

Cài đặt bằng Docker
Tác giả khuyên dùng Docker vì chỉ cần một container, không phải cài cơ sở dữ liệu riêng. Nếu máy chủ của bạn đã có Docker và Docker Compose, quy trình gồm bốn bước.
1. Tạo tệp compose.yml
Khai báo dịch vụ dùng ảnh ralex91/razzia:latest (cũng có bản trên GHCR là ghcr.io/ralex91/razzia:latest), mở cổng 3000:3000, gắn thư mục ./config vào /app/config và đọc biến môi trường từ tệp .env.
2. Tạo tệp .env
Ghi dòng MANAGER_PASSWORD=mat-khau-cua-ban. Đây là biến bắt buộc: thiếu nó, trang quản trò sẽ từ chối truy cập. Bạn nên đặt thêm JWT_SECRET dài ít nhất 32 ký tự (ngắn hơn sẽ bị bỏ qua); nếu để trống, mỗi lần khởi động máy chủ sẽ tự tạo khoá mới.
3. Khởi chạy
Chạy docker compose up -d. Ở lần chạy đầu, thư mục config được tạo tự động kèm một bộ quiz mẫu để bạn thử ngay.
4. Mở trình duyệt
Người chơi truy cập cổng 3000 của máy chủ, quản trò vào đường dẫn /manager. Khi chạy thật cho sự kiện, bạn nên trỏ một tên miền phụ (ví dụ quiz.tencongty.vn) và đặt Razzia sau reverse proxy để có HTTPS.

Nếu không dùng Docker, bạn có thể tải mã nguồn, cài bằng pnpm (phiên bản 10.16 trở lên), sao chép .env.example thành .env, rồi chạy pnpm build và pnpm start. Khi đó trang web mặc định chạy cổng 3000 và kết nối thời gian thực chạy cổng 3001. Cách này hợp với đội kỹ thuật muốn sửa giao diện sâu hơn.
Soạn bộ câu hỏi
Mỗi bộ quiz là một tệp JSON nằm trong config/quizz, có thể soạn bằng trình soạn trong trang quản trò hoặc sửa trực tiếp trên máy chủ. Tệp gồm chế độ chơi (quiz hoặc survey), tên chủ đề và danh sách câu hỏi. Những thông số bạn sẽ chỉnh thường xuyên nhất được tóm tắt trong bảng dưới.
| Trường | Ý nghĩa | Giới hạn |
|---|---|---|
| answers | Các phương án trả lời | 2–4 phương án (câu ước lượng để trống) |
| time | Thời gian trả lời | 5–120 giây |
| cooldown | Thời gian chờ trước khi lộ đáp án | 3–15 giây |
| maxPoints | Điểm cho câu trả lời đúng | Mặc định 1000 |
| penalty | Điểm trừ khi trả lời sai | Tuỳ chọn, tổng điểm không xuống dưới 0 |
| note | Lời giải thích hiện khi công bố đáp án | Tuỳ chọn |

Vài kinh nghiệm khi soạn cho sự kiện doanh nghiệp:
- Thời gian: câu đọc nhanh để 15–20 giây, câu có ảnh hoặc video để 25–30 giây. Đặt quá dài làm hội trường chùng xuống.
- Trường note: tận dụng để chèn thông điệp, ví dụ sau câu hỏi về sản phẩm mới thì hiện một dòng giới thiệu ưu đãi hoặc giá trị cốt lõi. Đây là chỗ “lồng” thông điệp thương hiệu tự nhiên nhất.
- Điểm trừ: chỉ dùng ở vòng cuối để tăng kịch tính; dùng sớm dễ khiến người chơi ngại bấm.
- Media: ảnh, video, âm thanh có thể tải lên qua trình soạn (lưu ở
config/media) hoặc dẫn link ngoài. Ảnh sản phẩm, đoạn nhạc hiệu quảng cáo hay đoạn clip ngắn về hành trình công ty đều là chất liệu tốt.
Thư mục config chứa toàn bộ dữ liệu của Razzia, nên sao lưu nó là giữ được mọi bộ câu hỏi và kết quả.

Gắn nhận diện thương hiệu
Với marketing, phần đáng giá nhất của Razzia là khả năng khoác “áo” thương hiệu mà không cần sửa mã nguồn. Bạn tạo thư mục config/branding và một tệp theme.json; mọi trường đều không bắt buộc, trường nào bỏ trống sẽ giữ giao diện mặc định.
- appName: tên ứng dụng và tiêu đề tab trình duyệt, ví dụ “Quiz Tất Niên 2026”.
- colors: tối thiểu nên khai báo màu chính và màu phụ; có thêm màu cho đáp án đúng.
- answerColors: màu cho tối đa bốn nút trả lời.
- font: tên font và link stylesheet, ví dụ một font Google Fonts có hỗ trợ tiếng Việt như Be Vietnam Pro.
- logo, favicon, background: tệp ảnh đặt trong thư mục branding.
Trang chủ Razzia giới thiệu sẵn các theme mẫu như Campus, Arcade, Bistro, Forest và Corporate. Bạn có thể bắt đầu từ một mẫu gần với phong cách công ty rồi thay logo, màu theo bộ nhận diện.

Một lưu ý về ngôn ngữ: trang chủ razzia.app đã có bản tiếng Việt và giao diện ứng dụng có nút chọn ngôn ngữ, nhưng bạn vẫn nên chạy thử để kiểm tra từng màn hình. Câu hỏi và đáp án do bạn soạn nên hiển thị tiếng Việt bình thường; hãy chọn font hỗ trợ đủ dấu để tránh lỗi chữ.
So sánh với ClassQuiz
Nếu tìm “Kahoot mã nguồn mở” trên GitHub, bạn sẽ gặp thêm ClassQuiz, dự án hướng tới giáo viên, dùng giấy phép MPL-2.0, có khoảng 734 sao. ClassQuiz dùng FastAPI ở phía máy chủ và SvelteKit ở giao diện, đi kèm Postgres, Redis và Meilisearch; bản chạy sẵn tại classquiz.de đặt ở Đức. Tài liệu ClassQuiz cũng ghi rõ dự án dùng hai dịch vụ đóng là Mapbox (bản đồ) và hCaptcha (chống bot).
| Tiêu chí | Razzia | ClassQuiz |
|---|---|---|
| Giấy phép | MIT | MPL-2.0 |
| Sao GitHub | Khoảng 1.100 | 734 |
| Công nghệ | Node.js, TypeScript | FastAPI, SvelteKit |
| Thành phần cần chạy | Một container | Postgres, Redis, Meilisearch, Caddy |
| Hợp với | Sự kiện nhỏ, đào tạo, tất niên | Lớp học, nhiều người cùng soạn quiz |

Tóm lại, nếu đội của bạn cần dựng nhanh cho một sự kiện và ít người trực kỹ thuật, Razzia gọn hơn hẳn. Nếu bạn cần một kho quiz lâu dài, nhiều người soạn và tìm kiếm, ClassQuiz đáng cân nhắc dù cài đặt phức tạp hơn.
Hiểu lầm phổ biến
“Mã nguồn mở là không an toàn.” Mã nguồn công khai giúp ai cũng kiểm tra được phần mềm làm gì. Rủi ro thực sự thường đến từ cách cài đặt: để lộ cổng không mã hoá, đặt mật khẩu quản trò yếu, không cập nhật phiên bản mới. Bạn có thể đọc thêm bài hướng dẫn tổ chức minigame an toàn, chống gian lận và giả mạo để áp dụng cùng.
“Phải biết lập trình mới dùng được.” Người cài đặt cần biết Docker cơ bản, nhưng người soạn câu hỏi và người dẫn chương trình chỉ dùng giao diện web.
“Miễn phí nên không tốn gì.” Phần mềm miễn phí, nhưng bạn vẫn trả tiền máy chủ, tên miền, và quan trọng nhất là thời gian của người trực kỹ thuật trong ngày sự kiện. Hãy tính các chi phí này khi so với dịch vụ trả phí.

Checklist trước sự kiện
Razzia tự nhận là dành cho sự kiện quy mô nhỏ và tài liệu không công bố giới hạn số người chơi, nên phần chuẩn bị kỹ thuật là thứ quyết định ván quiz trên sân khấu có trơn tru hay không. Hãy làm theo năm việc sau.
1. Chạy HTTPS qua reverse proxy
Đặt Razzia sau Traefik, Nginx hoặc Caddy, dùng chứng chỉ SSL cho tên miền phụ. Kết nối WebSocket cũng phải đi qua proxy; tài liệu Razzia có riêng một trang hướng dẫn phần này.
2. Đổi mật khẩu quản trò
Dùng MANAGER_PASSWORD dài, khó đoán, chỉ người dẫn và kỹ thuật biết. Đặt JWT_SECRET từ 32 ký tự trở lên để phiên đăng nhập không bị mất khi khởi động lại.
3. Thử tải với nhóm nhỏ
Một tuần trước sự kiện, mời 20–30 đồng nghiệp chơi thử cùng lúc qua đúng mạng wifi của địa điểm. Quan sát độ trễ khi hiện câu hỏi và khi gửi đáp án. Nếu dự kiến hàng trăm người, hãy thử với số đông hơn hoặc chia thành nhiều phòng theo bàn, theo phòng ban.
4. Chuẩn bị mã QR và đường link ngắn
Mã QR trên màn hình chờ rất tiện, nhưng người ngồi xa sân khấu khó quét. In thêm mã QR lên thẻ bàn và đọc to một đường link ngắn.
5. Sao lưu thư mục config
Sao lưu trước sự kiện để không mất bộ câu hỏi, và sau sự kiện để giữ kết quả làm căn cứ trao giải.

Ngoài phần kỹ thuật, hãy công bố thể lệ và cơ cấu giải thưởng rõ ràng ngay từ đầu, và chỉ nên thu tên hiển thị thay vì số điện thoại hay thông tin cá nhân nếu không thực sự cần. Nếu bạn đang lên chương trình cuối năm, bài 10 minigame Year End Party chơi bằng điện thoại có thêm nhiều ý tưởng để kết hợp với một vòng quiz Razzia.
Câu hỏi thường gặp
Razzia có mất phí không?
Không. Razzia là phần mềm mã nguồn mở giấy phép MIT, bạn được dùng miễn phí, kể cả cho mục đích thương mại. Chi phí thực tế là máy chủ, tên miền và công sức vận hành.
Một ván Razzia chơi được bao nhiêu người?
Tài liệu chính thức không công bố con số giới hạn và dự án tự mô tả là dành cho sự kiện quy mô nhỏ. Sức chịu tải phụ thuộc vào máy chủ và mạng của bạn, vì vậy hãy chạy thử trước với số người gần với thực tế.
Người chơi có phải cài ứng dụng không?
Không. Người chơi chỉ cần mở trình duyệt trên điện thoại hoặc máy tính, nhập mã PIN hoặc quét mã QR.
Có xuất kết quả để trao giải không?
Kết quả các ván được lưu trong thư mục config/results, và Razzia có HTTP API để quản lý quiz, kết quả. Định dạng tệp kết quả không được mô tả chi tiết trong tài liệu, nên bạn nên chụp màn hình bục vinh danh làm bằng chứng ngay tại sự kiện.
Có dùng cho khảo sát khách hàng được không?
Được. Bật chế độ survey để hỏi ý kiến không chấm điểm, kết quả hiện trực tiếp trên màn hình. Nếu cần lưu trữ khảo sát dài hạn có phân tích, bạn nên kết hợp thêm công cụ khảo sát chuyên dụng.
Kết luận
Razzia là lựa chọn đáng thử cho doanh nghiệp muốn có một phần quiz trực tiếp mang đúng màu thương hiệu, chạy trên máy chủ của mình và không phụ thuộc phí theo người chơi. Bốn kiểu câu hỏi, trường giải thích đáp án và tệp theme.json đủ để bạn biến một ván đố vui thành công cụ truyền thông nội bộ, đào tạo hay kích hoạt thương hiệu tại sự kiện. Đổi lại, bạn cần một người nắm Docker và dành thời gian chạy thử kỹ trước ngày diễn ra.
Bạn đã từng tự dựng phần mềm quiz cho sự kiện của công ty chưa, và gặp khó khăn gì? Hãy chia sẻ ở phần bình luận, và theo dõi minigame.vn để nhận thêm các công cụ, ý tưởng minigame cho doanh nghiệp.
Nguồn tham khảo: kho mã GitHub Ralex91/Razzia và tài liệu đi kèm (docs/quiz.md, docs/configuration.md, docs/branding.md), trang chủ razzia.app, kho mã GitHub mawoka-myblock/ClassQuiz.
Đọc tiếp trong Cẩm nang
- Hướng dẫnPhaser 4: tự làm minigame HTML5 mang thương hiệu riêngPhaser là framework game 2D HTML5 mã nguồn mở, nay đã lên Phaser 4. Cách khởi tạo, 4…
- Hướng dẫnMinigame an toàn mùa cuối năm: chống gian lận lượt chơi, chống giả mạo thương hiệu và bảo vệ dữ liệu người chơiCuối năm là cao điểm của minigame và cũng là cao điểm của lừa đảo "trúng thưởng" giả…
- Hướng dẫnCách đặt tỷ lệ trúng vòng quay may mắn để không vỡ ngân sách quàCông thức tính chi phí quà cho mỗi lượt quay, ví dụ cụ thể với 2.000 lượt chơi…