Máy chủ thi
Máy chủ tại Địa điểm thi, điều hành Ca thi khi không có Internet.
Mọi bản cài đặt máy chủ LAN hiện là thử nghiệm có kiểm soát, chưa được duyệt cho thi chính thức.
Mục đích
Máy chủ thi (tên kỹ thuật: Exam Runtime) chạy tại Địa điểm thi. Nó:
- đăng ký với AMG-Cloud qua Yêu cầu đăng ký thiết bị;
- tải Gói đề, Gói danh tính và Chuẩn bị Ca thi;
- duyệt Máy thi, xác thực Thí sinh, cấp đề đã giải mã;
- giữ đồng hồ Ca thi theo giờ máy chủ, nhận bài tự lưu và bản ghi âm;
- đóng Ca thi và gửi bài làm về AMG-Cloud qua Hàng đợi gửi.
Đi kèm là web máy chủ LAN cho Kỹ thuật viên và Giám thị: thiết lập hạ tầng, đăng nhập cán bộ, tổng quan máy chủ, phòng thi của Giám thị.
User Guide: Kỹ thuật viên — máy chủ LAN và Giám thị — điều hành Ca thi.
Địa chỉ truy cập
| Dành cho | Địa chỉ | Ghi chú |
|---|---|---|
| Thí sinh | https://<máy-chủ-LAN>:18443 | Cổng duy nhất mở ra LAN |
| Kỹ thuật viên, Giám thị | https://<máy-chủ-LAN>:18443/server/ | Cùng cổng; mở được từ máy chủ và từ máy khác trong LAN, cần đăng nhập |
Dữ liệu và bảo mật
- Dữ liệu lưu trên ổ đĩa của máy chủ; không có Đáp án.
- Máy chủ tự sinh khóa thiết bị và ký mọi yêu cầu gửi lên AMG-Cloud.
- Không sao chép thư mục dữ liệu sang máy khác; mã hóa mọi bản sao lưu.
- Đăng nhập cán bộ trên máy chủ LAN được chuyển tiếp tới AMG-Cloud để xác thực.
- Log và trace của máy chủ ghi thành tệp trên ổ đĩa (JSON Lines, OpenTelemetry), tách khỏi dữ liệu Ca thi và danh tính thiết bị, không gửi lên AMG-Cloud. Không chứa mật khẩu, mã phiên đăng nhập hay nội dung bài làm. Xem Báo sự cố.
Cách cài đặt
| Cách | Ghi chú |
|---|---|
Gói cài AMG Runtime (Windows .zip, Linux .tar.gz) | Cách được hỗ trợ. Không cần Docker. Máy chủ thi là một tệp chạy Bun độc lập, tự chạy và giám sát Caddy làm proxy HTTPS. Một dịch vụ khởi động cùng máy. Tự tạo CA và chứng chỉ HTTPS cho LAN. Lệnh amg-runtime: status, update --from, rollback, config, uninstall [--purge] |
| Gói Docker | Phương án thay thế cho Linux hoặc Windows có Docker Desktop, kèm HTTPS |
Gói Bun (@edtech/exam-runtime) | Máy chủ thi đã build, cài bằng Bun và chạy như dịch vụ backend. Chỉ cần Bun. exam-runtime cert tạo CA và chứng chỉ LAN; Máy chủ thi tự chạy Caddy. Người vận hành tự lo dịch vụ và tường lửa |
| Từ mã nguồn | Chỉ cho nhà phát triển và kiểm thử |
Các tab quản trị của Cài đặt trên web máy chủ thi cho xem và điều khiển proxy, cổng, chứng chỉ, kết nối AMG-Cloud và cấu hình: trước khi đăng ký chỉ trên chính máy chủ, sau đó cho Quản trị viên hệ thống cấp Đơn vị trở lên. Hướng dẫn cho kỹ thuật viên: Kỹ thuật viên.
Các bước cài cho từng nền tảng: Cài đặt Máy chủ thi. Máy thi phải cài chứng chỉ của máy chủ LAN trước khi thi; xem Cài chứng chỉ trên Máy thi.
Công nghệ
Bun, Elysia, Effect, SQLite. Web máy chủ LAN dùng React và TanStack Router.
Giới hạn hiện tại
- Máy thi hỏng giữa giờ thì chưa đóng được Ca thi.
- Giao diện Giám thị chưa có tạm dừng, cộng giờ hay ghi sự cố.
- Khóa kích hoạt hết hạn 24 giờ sau khi Chuẩn bị Ca thi.
- Chưa có công cụ sao lưu và khôi phục.