Cài Đặt Open WebUI Trên Ubuntu 26.04 LTS Chi Tiết Từ A-Z

Open WebUI là giao diện web mã nguồn mở giúp bạn sử dụng các mô hình AI theo trải nghiệm gần giống ChatGPT, nhưng có thể tự triển khai trên máy chủ riêng. Open WebUI thường được kết hợp với Ollama, OpenAI-compatible API, vLLM, LiteLLM hoặc các backend AI nội bộ để xây dựng chatbot, trợ lý AI, nền tảng hỏi đáp tài liệu và giải pháp AI riêng cho doanh nghiệp.

Trong bài viết này, CloudX sẽ hướng dẫn bạn cài đặt Open WebUI trên Ubuntu 26.04 LTS bằng Docker Compose, kết nối với Ollama, cấu hình firewall, reverse proxy Nginx, SSL HTTPS và tối ưu quan trọng khi triển khai trên Cloud Server NVMe.

Open WebUI là gì?

Open WebUI là nền tảng giao diện web tự host dành cho các mô hình AI. Thay vì phải dùng dòng lệnh để chat với model, bạn có thể truy cập trình duyệt, đăng nhập tài khoản và trò chuyện với AI qua giao diện trực quan.

Điểm mạnh của Open WebUI là khả năng kết nối linh hoạt với nhiều backend AI khác nhau. Bạn có thể dùng mô hình chạy local qua Ollama, kết nối API tương thích OpenAI, dùng endpoint nội bộ hoặc tích hợp vào hệ thống doanh nghiệp.

Open WebUI dùng để làm gì?

• Xây dựng chatbot AI nội bộ cho doanh nghiệp.
• Triển khai trợ lý AI riêng trên Cloud Server.
• Kết nối Ollama để chạy Llama, Mistral, Qwen, DeepSeek, Gemma.
• Tạo hệ thống hỏi đáp tài liệu nội bộ.
• Thử nghiệm mô hình AI mã nguồn mở.
• Dùng thay thế giao diện chat đơn giản cho OpenAI-compatible API.
• Phục vụ đào tạo, nghiên cứu và triển khai AI trong trường học.

Yêu cầu hệ thống tối thiểu và khuyến nghị

Open WebUI bản thân không quá nặng. Tuy nhiên nếu bạn chạy kèm Ollama và các mô hình AI local, tài nguyên CPU, RAM, GPU và Disk sẽ ảnh hưởng trực tiếp đến tốc độ phản hồi.

Bước 1: Cập nhật Ubuntu 26.04 LTS

Chạy lệnh sau:

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget git ca-certificates gnupg lsb-release nano ufw

Nếu hệ thống cập nhật Kernel hoặc thư viện quan trọng, bạn nên khởi động lại máy chủ.

sudo reboot

Bước 2: Cài đặt Docker và Docker Compose

Cách triển khai Open WebUI ổn định và phổ biến nhất là dùng Docker. Phương pháp này giúp tách biệt môi trường, dễ backup, dễ update và phù hợp với máy chủ production.

Cài Docker bằng script chính thức:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Thêm user hiện tại vào group docker:

sudo usermod -aG docker $USER

Bật Docker tự khởi động cùng hệ thống:

sudo systemctl enable docker
sudo systemctl start docker

Kiểm tra phiên bản Docker và Docker Compose:

docker --version
docker compose version

Bước 3: Cài đặt Ollama làm AI backend

Open WebUI chỉ là giao diện web. Để chạy mô hình AI local, bạn cần một backend như Ollama. Nếu bạn chỉ dùng OpenAI-compatible API bên ngoài, có thể bỏ qua bước này.

Cài Ollama:

curl -fsSL https://ollama.com/install.sh | sh

Bật Ollama tự khởi động:

sudo systemctl enable ollama
sudo systemctl start ollama

Kiểm tra Ollama:

ollama --version
curl http://localhost:11434

Tải thử một model nhỏ:

ollama pull llama3.2:3b

Bước 4: Cài đặt Open WebUI bằng Docker Compose

Tạo thư mục riêng cho Open WebUI:

sudo mkdir -p /opt/open-webui
sudo chown -R $USER:$USER /opt/open-webui
cd /opt/open-webui

Tạo file Docker Compose:

nano docker-compose.yml

Dán nội dung sau vào file:

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    restart: unless-stopped
    ports:
      - "3000:8080"
    environment:
      - OLLAMA_BASE_URL=http://host.docker.internal:11434
      - WEBUI_AUTH=true
      - WEBUI_SECRET_KEY=hay-thay-bang-chuoi-bi-mat-that-dai
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - open-webui-data:/app/backend/data

volumes:
  open-webui-data:

Khởi chạy Open WebUI:

docker compose up -d

Kiểm tra container:

docker compose ps

Xem log nếu cần:

docker compose logs -f

Bước 5: Truy cập giao diện Open WebUI

Sau khi container chạy thành công, mở trình duyệt và truy cập:

http://IP-MAY-CHU:3000

Lần đầu truy cập, bạn sẽ tạo tài khoản quản trị đầu tiên. Tài khoản đầu tiên thường có quyền quản trị hệ thống, vì vậy hãy dùng email và mật khẩu mạnh.

Bước 6: Cấu hình Nginx Reverse Proxy cho Open WebUI

Nếu muốn truy cập Open WebUI bằng domain như ai.example.com, bạn nên cấu hình Nginx làm reverse proxy.

Cài Nginx:

sudo apt install -y nginx

Tạo file cấu hình site:

sudo nano /etc/nginx/sites-available/open-webui

Dán nội dung sau, thay ai.example.com bằng domain thật của bạn:

server {
    listen 80;
    server_name ai.example.com;

    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_read_timeout 3600;
        proxy_send_timeout 3600;
    }
}

Kích hoạt site:

sudo ln -s /etc/nginx/sites-available/open-webui /etc/nginx/sites-enabled/open-webui
sudo nginx -t
sudo systemctl reload nginx

Bước 7: Cài SSL HTTPS với Let’s Encrypt

Cài Certbot:

sudo apt install -y certbot python3-certbot-nginx

Cấp SSL cho domain:

sudo certbot --nginx -d ai.example.com

Kiểm tra gia hạn tự động:

sudo certbot renew --dry-run

Bước 8: Cấu hình firewall và bảo mật

Cho phép SSH, HTTP và HTTPS:

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status

Cấu hình port chỉ lắng nghe localhost:

ports:
  - "127.0.0.1:3000:8080"

Sau khi sửa file, chạy lại:

cd /opt/open-webui
docker compose up -d

Bước 9: Cập nhật Open WebUI

Để cập nhật Open WebUI lên phiên bản mới nhất:

cd /opt/open-webui
docker compose pull
docker compose up -d

Dọn image Docker cũ:

docker image prune -f

Lỗi thường gặp khi cài Open WebUI

1. Không truy cập được http://IP-MAY-CHU:3000

cd /opt/open-webui
docker compose ps
sudo ufw status

2. Open WebUI không thấy model Ollama

sudo systemctl status ollama
curl http://localhost:11434/api/tags

3. Nginx báo lỗi 502 Bad Gateway

ss -tlnp | grep 3000
docker ps
sudo nginx -t

Vì sao nên triển khai Open WebUI trên Cloud Server NVMe CloudX?

Open WebUI kết hợp Ollama hoặc các backend AI cần hạ tầng ổn định, tốc độ cao và dễ mở rộng. Cloud Server NVMe của CloudX phù hợp để triển khai các hệ thống AI nội bộ vì có độ trễ thấp, tốc độ đọc ghi nhanh và khả năng nâng cấp tài nguyên linh hoạt.

• Phù hợp chạy Open WebUI, Ollama, n8n, LangChain, Flowise.
• Ổ cứng NVMe giúp tải model, ghi log và xử lý dữ liệu nhanh hơn.
• Hỗ trợ triển khai reverse proxy, SSL, firewall và backup.
• Phù hợp cho doanh nghiệp, trường học, trung tâm đào tạo và startup AI.

FAQ - Câu hỏi thường gặp

Open WebUI có bắt buộc phải cài Ollama không?

Không bắt buộc. Open WebUI có thể kết nối Ollama, OpenAI-compatible API hoặc các backend AI khác. Tuy nhiên Ollama là lựa chọn phổ biến nếu bạn muốn chạy model local.

Open WebUI có chạy được trên VPS không có GPU không?

Có. Open WebUI chạy được trên VPS không có GPU. Tuy nhiên nếu chạy model AI local bằng Ollama, không có GPU thì tốc độ sinh câu trả lời sẽ phụ thuộc nhiều vào CPU và RAM.

Có nên public port 3000 ra Internet không?

Không nên để port 3000 public lâu dài. Cách tốt hơn là dùng Nginx reverse proxy, HTTPS và giới hạn container chỉ lắng nghe trên localhost.

Dữ liệu Open WebUI được lưu ở đâu?

Nếu cài bằng Docker Compose như bài viết này, dữ liệu được lưu trong Docker volume open-webui-data. Bạn nên backup volume hoặc snapshot máy chủ định kỳ.

Kết luận

Open WebUI là lựa chọn rất đáng dùng nếu bạn muốn triển khai giao diện AI tự host, dễ sử dụng và linh hoạt trong việc kết nối nhiều loại backend AI. Khi kết hợp với Ollama trên Ubuntu 26.04 LTS, bạn có thể xây dựng một hệ thống chatbot AI riêng, chạy trên Cloud Server của mình và chủ động hơn về dữ liệu.

Với Docker Compose, Nginx Reverse Proxy, SSL Let’s Encrypt và Cloud Server NVMe, Open WebUI có thể được triển khai ổn định cho cá nhân, doanh nghiệp, trường học hoặc nhóm nghiên cứu AI.

Hệ sinh thái của CloudX