Các vấn đề thường gặp

403: Bạn không có quyền truy cập vào cuộc trò chuyện này

Điều này thường xảy ra khi chạy Chat UI qua HTTP mà không có cấu hình cookie phù hợp.

Khuyến nghị: Thiết lập một proxy ngược (NGINX, Caddy) để xử lý HTTPS.

Phương án thay thế: Nếu bạn bắt buộc phải chạy qua HTTP, hãy đặt biến môi trường sau:

COOKIE_SECURE=false

Điều này tự động đặt COOKIE_SAMESITE thành lax, đây là giá trị chính xác cho các triển khai HTTP.

Cũng đảm bảo rằng PUBLIC_ORIGIN khớp với URL thực tế của bạn:

PUBLIC_ORIGIN=http://localhost:5173

Mô hình không tải được

Nếu các model không xuất hiện trong giao diện người dùng:

1. Kiểm tra xem OPENAI_BASE_URL có chính xác và có thể truy cập được không
2. Kiểm tra xem OPENAI_API_KEY có hợp lệ không
3. Đảm bảo rằng endpoint trả về các model tại ${OPENAI_BASE_URL}/models

Lỗi kết nối cơ sở dữ liệu

Để phát triển, bạn có thể bỏ qua MongoDB hoàn toàn - Chat UI sẽ sử dụng cơ sở dữ liệu nhúng.

Đối với môi trường sản xuất, hãy kiểm tra:

• MONGODB_URL là chuỗi kết nối hợp lệ
• IP của bạn đã được đưa vào danh sách trắng (cho MongoDB Atlas)
• Người dùng cơ sở dữ liệu có quyền đọc/ghi