3A.COM.VN

Công Cụ AI

Open WebUI là gì: 4 tính năng phân quyền LLM nội bộ

Open WebUI là gì? Giao diện chat LLM tự host có 3 vai trò hệ thống và 5 nhóm quyền chi tiết. Bài này mổ 4 tính năng phân quyền giúp công ty dùng chung mà không lộ dữ liệu.

Quang Minh· Trưởng ban Nghiên cứu & Đo kiểm AI6 phút đọc19/11/20260 lượt xem
Open WebUI là gì: 4 tính năng phân quyền LLM nội bộ

Open WebUI là gì? Một giao diện chat cho LLM chạy trên máy chủ của bạn. Nó có hệ phân quyền ba lớp: vai trò, quyền và nhóm. Bài này mổ bốn tính năng phân quyền trong tài liệu RBAC chính hãng. Mục tiêu là cả công ty dùng chung một cổng chat mà không ai nhìn thấy thứ họ không nên thấy.

Tôi đọc tài liệu theo góc của người phải trả lời câu hỏi "ai được làm gì". Tính năng nào có biến cấu hình thật thì tôi ghi tên biến. Chỗ nào tài liệu chưa nói rõ thì tôi để nguyên là chưa nói.

Laptop màn hình trắng đặt trên bàn làm việc, minh hoạ giao diện chat nội bộ
Laptop màn hình trắng đặt trên bàn làm việc, minh hoạ giao diện chat nội bộNguồn chính hãng / Kho ảnh bản quyền mở · Official / Free Commercial License

Chú thích ảnh: một laptop màn hình trắng trên bàn làm việc. Ảnh: Artem Podrez, Pexels, giấy phép Pexels (link gốc xem mục Nguồn, phần Ảnh).

Dự án nội bộ · 3A AI Stack Advisor

Đừng trả tiền thừa cho SaaS AI — Nhận lộ trình công cụ & chi phí tối ưu trong 10 giây

Mô tả bài toán của doanh nghiệp bạn (CSKH Zalo OA, Coding, RAG tài liệu nội bộ, Báo cáo P&L). Hệ thống cố vấn của 3A sẽ đề xuất bộ công cụ đã qua kiểm thử thực chiến.

Tính năng 1: Ba vai trò hệ thống quyết định ai vào được cổng?

Mọi người dùng mang đúng một trong ba vai trò: admin, user hoặc pending. Người đăng ký đầu tiên của hệ thống tự thành Admin.

Vai trò pending là chốt chặn quan trọng nhất. Người mới đăng ký sẽ chờ ở đó cho tới khi Admin duyệt. Biến DEFAULT_USER_ROLE quyết định vai trò khởi điểm của người đăng ký sau đó, với ba giá trị pending, user hoặc admin.

Đặt DEFAULT_USER_ROLE=admin khiến mọi người mới tự đăng ký đều nhận toàn quyền Admin trên hệ thống. Tránh cấu hình này khi mở dùng chung. Hãy đặt pending và duyệt tay.

Muốn dựng sẵn tài khoản quản trị không cần bấm màn hình, tài liệu có ba biến: WEBUI_ADMIN_EMAIL, WEBUI_ADMIN_PASSWORD và WEBUI_ADMIN_NAME.

bash
docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY=your-secret-key \
  -e DEFAULT_USER_ROLE=pending \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Lệnh trên lấy từ trang quick-start, tôi chỉ thêm dòng DEFAULT_USER_ROLE=pending. Giá trị your-secret-key phải thay bằng chuỗi ngẫu nhiên của bạn.

Tính năng 2: Quyền chi tiết chia làm 5 nhóm nào?

Vai trò chỉ là cổng ngoài. Bên trong, Open WebUI tách quyền thành năm nhóm: Workspace, Sharing, Chat, Features và Settings.

Tài liệu cho phép đặt mặc định chung rồi nới theo nhóm người. Cách nghĩ đúng là ít đặc quyền nhất: tắt hết, mở dần từng quyền cần thiết.

Có một dòng trong tài liệu đáng đọc hai lần. Quyền Tools Access tương đương quyền root, vì công cụ có thể chạy mã Python tuỳ ý. Ai nắm quyền này gần như nắm máy chủ.

Tay cầm một xấp giấy tờ, minh hoạ việc rà từng quyền trong bảng phân quyền
Tay cầm một xấp giấy tờ, minh hoạ việc rà từng quyền trong bảng phân quyềnNguồn chính hãng / Kho ảnh bản quyền mở · Official / Free Commercial License

Chú thích ảnh: một bàn tay cầm xấp giấy tờ. Ảnh: RDNE Stock project, Pexels, giấy phép Pexels (link gốc xem mục Nguồn, phần Ảnh).

Tính năng 3: Nhóm cộng dồn quyền thế nào?

Nhóm là nơi phân quyền thành hiện thực. Bạn gom người vào nhóm kế toán, nhóm dev, nhóm khách rồi gán quyền cho nhóm, không gán từng người.

Hai đặc điểm của nhóm cần nhớ:

  • Quyền cộng dồn (additive). Người thuộc hai nhóm nhận quyền của cả hai.
  • Không có quyền "cấm" (deny). Bạn không thể dùng nhóm B để thu hồi quyền mà nhóm A đã cho.
  • Nhóm có thể lồng nhau.
  • Mỗi nhóm có thể đặt mô hình mặc định riêng.

Hệ quả thực tế rất rõ. Nếu bạn lỡ cho một nhóm rộng quyền, thêm người vào nhóm "hạn chế" cũng không cứu được họ. Muốn bớt quyền thì phải gỡ họ khỏi nhóm rộng.

Tính năng 4: Chia sẻ mô hình, kho tri thức và thu hồi phiên ra sao?

Lớp cuối là danh sách kiểm soát truy cập (ACL) cho tài nguyên. Mô hình và kho tri thức (knowledge) mặc định ở chế độ riêng tư. Bạn chia sẻ chúng cho một nhóm hoặc một người cụ thể.

Còn khi có sự cố, bạn cần cắt phiên đăng nhập. Open WebUI có nút Sign out all devices. Bạn cũng gọi được endpoint POST /api/v1/users/{user_id}/sessions/revoke để thu hồi phiên của một người dùng.

Tính năngCấu hình chínhĐiều cần nhớ
Vai trò hệ thốngDEFAULT_USER_ROLE3 vai trò, người đầu tiên là Admin
Quyền chi tiết5 nhóm quyềnTools Access tương đương root
NhómGán quyền theo nhómCộng dồn, không có deny, lồng được
ACL và phiênChia sẻ model, knowledge; revoke phiênAPI key không bị thu hồi khi đăng xuất
Chồng hồ sơ giấy và một cặp kính, minh hoạ danh sách quyền truy cập cần kiểm kê
Chồng hồ sơ giấy và một cặp kính, minh hoạ danh sách quyền truy cập cần kiểm kêNguồn chính hãng / Kho ảnh bản quyền mở · Official / Free Commercial License

Chú thích ảnh: chồng hồ sơ giấy cạnh một cặp kính. Ảnh: Kindel Media, Pexels, giấy phép Pexels (link gốc xem mục Nguồn, phần Ảnh).

Giới hạn và rủi ro khi phân quyền Open WebUI là gì?

Cảnh báo kỹ thuật

Admin vượt hầu hết kiểm tra quyền. Hãy coi tài khoản Admin như chìa khoá tổng của cả toà nhà.

  • Admin xem được chat? Tài liệu có biến ENABLE_ADMIN_CHAT_ACCESS=False để chặn Admin đọc hội thoại của người khác. Biến BYPASS_ADMIN_ACCESS_CONTROL điều khiển việc Admin có bỏ qua ACL tài nguyên hay không. Hãy đặt cả hai theo chính sách riêng của công ty.
  • API key: khoá API không bị thu hồi khi người dùng đăng xuất. Nút Sign out all devices không đủ khi có người rời công ty.
  • Khoá nhà cung cấp: tài liệu khuyên dùng khoá nhà cung cấp phạm vi thấp khi nối gateway như LiteLLM.
  • Chi phí ẩn: phân quyền tốt cần người ngồi duyệt tài khoản pending. Việc này tốn giờ công, và tôi chưa thấy tài liệu đưa con số nào để ước tính. [CHƯA KIỂM]

Đánh giá của tôi: nên dùng cho nhóm vài chục người cần một cổng chat chung. Điều kiện là có người duyệt quyền đều đặn. Nhóm vài người thì ba vai trò mặc định là đủ.

Đọc thêm trên 3a.com.vn: LM Studio và Ollama, nên chọn gì. Phần mô hình chạy trong máy nằm ở bài mô hình mã nguồn mở chạy trên máy cá nhân. Muốn hiểu giao thức kết nối công cụ, xem MCP là gì.

Nguồn

Nguồn

  • Open WebUI, "Role-Based Access Control (RBAC)", ngày truy cập 2026-11-14. Link: https://docs.openwebui.com/features/authentication-access/rbac/
  • Open WebUI, "Roles", ngày truy cập 2026-11-14. Link: https://docs.openwebui.com/features/authentication-access/rbac/roles/
  • Open WebUI, "Permissions", ngày truy cập 2026-11-14. Link: https://docs.openwebui.com/features/authentication-access/rbac/permissions/
  • Open WebUI, "Groups", ngày truy cập 2026-11-14. Link: https://docs.openwebui.com/features/authentication-access/rbac/groups/
  • Open WebUI, "Quick Start", ngày truy cập 2026-11-14. Link: https://docs.openwebui.com/getting-started/quick-start/

Ảnh

  • Bìa: Artem Podrez, Pexels, giấy phép Pexels, ngày truy cập 2026-11-14. Link gốc: https://www.pexels.com/photo/4884105/
  • Thân bài: RDNE Stock project, Pexels, giấy phép Pexels, ngày truy cập 2026-11-14. Link gốc: https://www.pexels.com/photo/7821547/
  • Thân bài: Kindel Media, Pexels, giấy phép Pexels, ngày truy cập 2026-11-14. Link gốc: https://www.pexels.com/photo/7054757/
— Quang Minh, từ phòng đo kiểm 3A.

Bài liên quan