Open WebUI là gì? Cách tự host giao diện AI cho Ollama và OpenAI API

Tóm tắt nhanh:

Open WebUI là nền tảng giao diện AI self-hosted, hỗ trợ Ollama và OpenAI-compatible APIs theo README chính thức. Bạn có thể cài bằng pip với Python 3.11 hoặc chạy Docker. Với Docker, nguồn chính thức nhấn mạnh phải mount volume open-webui:/app/backend/data để tránh mất database.

Open WebUI là một self-hosted AI platform có giao diện web thân thiện cho việc dùng LLM. README chính thức mô tả nó có thể hoạt động offline và hỗ trợ nhiều LLM runner như Ollama cùng các API tương thích OpenAI.

Với người tự host, Open WebUI phù hợp khi bạn muốn có giao diện chat nội bộ, kết nối Ollama đang chạy trong máy, hoặc dùng một OpenAI-compatible endpoint mà không phải tự viết frontend.

Khi nào bạn nên dùng Open WebUI?

Bạn nên dùng Open WebUI khi muốn dựng web UI cho Ollama, cần giao diện quản lý hội thoại, muốn thử RAG/web search/plugin theo tài liệu dự án, hoặc cần một dashboard AI chạy trong homelab/VPS.

Bạn chưa nên mở Open WebUI công khai nếu chưa cấu hình tài khoản, HTTPS, backup volume, biến môi trường và quyền truy cập API. Một giao diện AI thường chứa prompt, file tải lên và API key nên phải xử lý như dữ liệu nhạy cảm.

Cần chuẩn bị gì trước khi cài

Nếu cài bằng pip, README ghi cần Python 3.11 để tránh lỗi tương thích. Nếu dùng Docker, bạn cần Docker và một cổng trống trên máy host. Nếu muốn dùng GPU với image CUDA, README nhắc cần Nvidia CUDA container toolkit trên Linux/WSL.

Nếu dùng Ollama đã chạy trên máy host, lệnh Docker chính thức dùng –add-host=host.docker.internal:host-gateway để container truy cập dịch vụ trên host.

Cách cài bằng pip

README chính thức ghi:

pip install open-webui

Sau đó chạy server:

open-webui serve

Theo README, server có thể truy cập tại:

http://localhost:8080

Cách này hợp với môi trường Python đã kiểm soát tốt. Nếu bạn không muốn đụng dependency hệ thống, hãy dùng virtual environment hoặc Docker.

Cách chạy Docker khi Ollama ở cùng máy

Lệnh default trong README là:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Sau khi chạy, mở:

http://localhost:3000

Phần quan trọng là -v open-webui:/app/backend/data. README cảnh báo volume này giúp database được mount đúng và tránh mất dữ liệu.

Cách kết nối Ollama ở server khác

Nếu Ollama nằm ở server khác, README yêu cầu đổi OLLAMA_BASE_URL sang URL của server đó:

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Bạn cần thay https://example.com bằng endpoint thật của Ollama hoặc gateway nội bộ. Không đưa endpoint private ra public nếu chưa có bảo mật.

Cách chạy chỉ với OpenAI API

Nếu chỉ dùng OpenAI API, README có ví dụ:

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

Không commit API key vào Git, không paste key thật vào bài viết, và nên dùng biến môi trường hoặc secret manager khi triển khai thật.

Cách dùng image kèm Ollama

README có image bundled Ollama. CPU-only:

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

GPU:

docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

Chỉ dùng –gpus=all khi Docker và driver GPU đã sẵn sàng.

Cách kiểm tra sau khi chạy

Bạn kiểm tra container open-webui đang running, mở được http://localhost:3000 hoặc http://localhost:8080 tùy cách cài, volume open-webui tồn tại, và Open WebUI kết nối được tới Ollama hoặc OpenAI-compatible API.

Nếu không thấy model Ollama, lỗi thường nằm ở OLLAMA_BASE_URL hoặc việc container không truy cập được 127.0.0.1 của host. README gợi ý một số môi trường có thể cần cấu hình mạng khác.

Lỗi thường gặp

Lỗi đầu tiên là quên volume /app/backend/data, dẫn tới mất database. Hãy giữ -v open-webui:/app/backend/data trong lệnh Docker.

Lỗi thứ hai là container không gọi được Ollama trên host. Hãy kiểm tra –add-host=host.docker.internal:host-gateway hoặc đặt OLLAMA_BASE_URL đúng.

Lỗi thứ ba là dùng image CUDA khi máy chưa có Nvidia CUDA container toolkit. Hãy dùng image main hoặc ollama CPU-only nếu chưa cần GPU.

Lưu ý an toàn và pháp lý

Open WebUI có nhiều thành phần license. README ghi codebase hiện có Open WebUI License với yêu cầu giữ branding và các đóng góp cũ theo license tương ứng. Nếu dùng thương mại hoặc đóng gói lại, bạn cần đọc LICENSE và LICENSE_HISTORY chính thức.

Về an toàn, hãy bảo vệ tài khoản admin, API key, file upload và log hội thoại. Đừng public dashboard AI nội bộ nếu chưa có HTTPS và access control.

FAQ

Open WebUI có cần Ollama không?

Không bắt buộc trong mọi trường hợp. README nói Open WebUI hỗ trợ Ollama và OpenAI-compatible APIs, đồng thời có ví dụ OpenAI API only.

Nên dùng pip hay Docker?

Nếu chỉ thử nhanh trong môi trường Python 3.11, pip được README hỗ trợ. Nếu tự host lâu dài, Docker với volume rõ ràng dễ quản lý hơn.

Vì sao phải mount volume open-webui?

README cảnh báo mount volume vào /app/backend/data là bước quan trọng để database được lưu đúng và tránh mất dữ liệu.