16  Câu hỏi Thường gặp và Khắc phục Sự cố

16.1 Admin Console Không Mở

docker compose ps
docker compose logs --tail 200

Kiểm tra domain, cổng 80/443, chứng chỉ và log ứng dụng.

16.2 User Không Thấy Trang SaaS

Kiểm tra theo thứ tự: trạng thái trang -> nhóm user -> cấp quyền trang SaaS -> loại tài khoản.

16.3 User Không Thấy Workspace

Kiểm tra cấp quyền workspace trong nhóm.

16.4 Trang Nội bộ Không Mở

  1. Trước tiên xác nhận URL mục tiêu có thể truy cập từ mạng nơi nút trình duyệt Sa2web đặt, sau đó kiểm tra DNS, định tuyến, tường lửa và ACL.
  2. Kiểm tra cấp quyền trang nội bộ trong nhóm.

16.5 MCP Không Kết Nối

Kiểm tra Node.js, @sa2web/mcp, Playwright, SA2_LOGIN_URL, clientId/clientSecret, quyền Agent và HTTPS.

16.6 Passkey Thất Bại

Kiểm tra domain mục tiêu, tin cậy HTTPS, origin trình duyệt, trạng thái gắn Passkey và tương thích trang mục tiêu trước.

Tài liệu chính thức:

  • https://www.sa2web.com/docs/en/operations/troubleshooting