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.

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).
Đừ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.
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:mainLệ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ủ.

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ăng | Cấu hình chính | Điều cần nhớ |
|---|---|---|
| Vai trò hệ thống | DEFAULT_USER_ROLE | 3 vai trò, người đầu tiên là Admin |
| Quyền chi tiết | 5 nhóm quyền | Tools Access tương đương root |
| Nhóm | Gán quyền theo nhóm | Cộng dồn, không có deny, lồng được |
| ACL và phiên | Chia sẻ model, knowledge; revoke phiên | API key không bị thu hồi khi đăng xuất |

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ếnBYPASS_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/



