Instrukcja obsługi Jak wdrożyć Open WebUI na urządzeniu QNAP NAS i połączyć je z Ollama

QTS, QuTS hero

Container Station

---

Czym jest Open WebUI?​

Open WebUI to samoobsługowy interfejs webowy w stylu ChatGPT, przeznaczony do łączenia z lokalnymi dużymi modelami językowymi (LLM), takimi jak Ollama. Zapewnia dopracowane, przyjazne dla użytkownika środowisko czatu bez konieczności wykupywania subskrypcji w chmurze ani przesyłania danych do zewnętrznych serwerów. Po wdrożeniu na urządzeniu QNAP NAS można uzyskać dostęp do Open WebUI z dowolnej przeglądarki w sieci.

Czego się nauczysz​

Ten samouczek obejmuje:

1. Tworzenie pliku Docker Compose YAML dla Open WebUI
2. Konfigurowanie łączności sieciowej między Open WebUI a Ollama
3. Wdrażanie kontenera i tworzenie konta administratora
4. Wybieranie modelu LLM i testowanie interfejsu czatu
5. Łączenie ze zdalną instancją Ollama w razie potrzeby

Omówienie sieci Docker​

Gdy zarówno Open WebUI, jak i Ollama działają w oddzielnych kontenerach na tym samym urządzeniu QNAP NAS, komunikują się za pośrednictwem wspólnej sieci Docker. Kluczowa kwestia: kontenery komunikują się przy użyciu nazw usług (na przykład: ollama, ale nie localhost).

Zmienna środowiskowa OLLAMA_BASE_URL informuje Open WebUI, gdzie znaleźć Ollama. Gdy oba kontenery są w tej samej sieci Docker o nazwie ai-network, adres URL to http://ollama:11434 (z użyciem nazwy usługi kontenera).

---

Wymagania wstępne​

• Urządzenie QNAP NAS z systemem QTS 5.2 / QuTS hero h5.2 lub nowszym
• Container Station 3
• Ollama wdrożona na tym samym urządzeniu QNAP NAS
• Co najmniej 2 GB wolnego miejsca na kontener Open WebUI i dane trwałe
• Znajomość podstaw Container Station i Docker Compose

---

Procedura​

Spoiler: Krok 1: Utwórz folder przechowywania

Otwórz SSH lub aplikację File Station na urządzeniu QNAP NAS. Utwórz katalog dla danych trwałych Open WebUI:
/share/Container/open-webui

Ten katalog przechowuje historię czatów, ustawienia użytkownika i dane konfiguracyjne. Bez tego montowania woluminu wszystkie rozmowy zostaną utracone po ponownym uruchomieniu kontenera.

Spoiler: Krok 2: Utwórz aplikację

W aplikacji Container Station utwórz nową aplikację o następującej zawartości:

version: '3.8'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - /share/Container/open-webui:/app/backend/data
    environment:
      OLLAMA_BASE_URL: http://ollama:11434
    networks:
      - ai-network
    restart: unless-stopped

networks:
  ai-network:
    name: ai-network
    driver: bridge

Objaśnienie kluczowej konfiguracji​

• Obraz:ghcr.io/open-webui/open-webui:main — oficjalny obraz Open WebUI z GitHub Container Registry
• Port:3000:8080 — dostęp z przeglądarki pod adresem http://NAS-IP:3000, zmapowany na port kontenera 8080
• Wolumin:/share/Container/open-webui:/app/backend/data — trwałe przechowywanie czatów i ustawień
• OLLAMA_BASE_URL:http://ollama:11434 — musi być zgodny z nazwą usługi kontenera Ollama i portem
• Sieć:ai-network — wspólna sieć mostkowa z kontenerem Ollama
• Restart:unless-stopped — kontener uruchamia się automatycznie po ponownym uruchomieniu urządzenia QNAP

Odczekaj 30–60 sekund na uruchomienie kontenera. Sprawdź dzienniki w aplikacji Container Station.

Spoiler: Krok 3: Utwórz konto administratora i przeprowadź wstępną konfigurację

Otwórz przeglądarkę i przejdź pod adres:
http://YOUR-NAS-IP:3000

Zrzut ekranu: ekran logowania Open WebUI z polami rejestracji

Przy pierwszym dostępie Open WebUI wyświetla formularz rejestracji. Wypełnij:

• Nazwa: Twoja nazwa wyświetlana
• E-mail: Adres e-mail (nie musi być prawdziwy)
• Hasło: Bezpieczne hasło do Twojego konta

Pierwsze utworzone konto automatycznie staje się kontem administratora. Musisz utworzyć to konto, zanim interfejs zostanie odblokowany. Kliknij Create Account.
OstrzeżeniePierwsze utworzone konto uzyskuje uprawnienia administratora z pełnym dostępem do systemu. Jeśli urządzenie QNAP NAS jest dostępne z internetu, natychmiast ustaw silne hasło. Nie pozostawiaj domyślnych ani pustych danych logowania.

Spoiler: Krok 4: Wybierz model i przeprowadź test

Po zalogowaniu Open WebUI wyświetla selektor modeli. Jeśli modele zostały już pobrane w Ollama, pojawią się tu automatycznie. Jeśli żaden model nie jest wymieniony:

1. Przejdź do menu Admin Panel
2. Wybierz Setting -> Models
3. Sprawdź połączenia Ollama i dostępność modeli.
4. Pobierz model bezpośrednio z Open WebUI lub najpierw wróć do Ollama, aby go pobrać

Wybierz model z listy rozwijanej (np. Gemma, Qwen, Deepseek).

Spoiler: Krok 5: Rozpocznij czat

Wpisz wiadomość w polu tekstowym na dole i naciśnij Enter. Open WebUI wysyła wiadomość do Ollama, która przetwarza ją przy użyciu wybranego modelu i zwraca odpowiedź. Interfejs zapisuje całą rozmowę w woluminie trwałym.

Zrzut ekranu: interfejs czatu Open WebUI z przykładową rozmową

Spoiler: Łączenie ze zdalną instancją Ollama

Jeśli chcesz, aby Open WebUI łączyło się z Ollama działającą na innym urządzeniu QNAP NAS lub innej maszynie (nie tym samym hoście fizycznym), zmodyfikuj zmienną środowiskową:
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

Zastąp OTHER-NAS-IP adresem IP zdalnej maszyny z uruchomioną Ollama. Upewnij się, że zapora sieciowa tej maszyny zezwala na ruch przez port 11434 z urządzenia QNAP NAS. Obie maszyny muszą znajdować się w tej samej sieci lub mieć skonfigurowane odpowiednie trasowanie.