Open WebUI

Triển khai Open WebUI và quản lý kết nối máy chủ với quyền quản trị.

Cài đặt và chuẩn bị

Cài Docker, làm theo hướng dẫn Open WebUI hoặc chạy lệnh dưới đây. Giữ volume có tên để bảo toàn tài khoản và cài đặt. Mở http://localhost:3000 và tạo tài khoản quản trị đầu tiên. Tạo khóa tại routerra.ai Keys và lấy ID được phép trong danh sách cổng.

Cấu hình kết nối

Với quyền quản trị, mở Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection. URL: https://routerra.ai/v1; API Key: YOUR_API_KEY. Bật loại kết nối tương thích OpenAI mặc định rồi lưu. Mô hình thường lấy từ /models; nếu không được, thêm YOUR_MODEL_ID vào danh sách Model IDs. Đây là kết nối máy chủ dùng chung theo quyền của phiên bản triển khai, không phải Direct Connection riêng trong trình duyệt.

docker run -d --name open-webui -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --restart always ghcr.io/open-webui/open-webui:main

Chọn mô hình và xử lý lỗi

Chọn YOUR_MODEL_ID trong chat mới. Nếu thiếu, kiểm tra bật kết nối và danh sách cho phép rồi lưu để làm mới. Giá trị trong cơ sở dữ liệu có thể ghi đè OPENAI_API_BASE_URL và OPENAI_API_KEY khi khởi động lại: sửa trực tiếp kết nối Admin. ENABLE_PERSISTENT_CONFIG=False ép dùng môi trường nhưng thay đổi Admin không được lưu lâu dài. Với lỗi mạng, xem docker logs open-webui và kiểm tra HTTPS ra ngoài của container.