~/ / Artykuły o AI / Lokalne LLM na VPS / Open WebUI na VPS: uruchom go w Dockerze i połącz z Ollama
Open WebUI na VPS: uruchom go w Dockerze i połącz z Ollama
Okno czatu w przeglądarce to najprostszy sposób korzystania z modelu działającego na własnym serwerze. Open WebUI jest jednym z takich interfejsów, a jego dokumentacja pokazuje, jak uruchomić go w Dockerze i jak połączyć z Ollama. Ten artykuł krok po kroku podąża za oficjalnym przewodnikiem szybkiego startu i przewodnikami łączenia oraz zaznacza, gdzie oba przewodniki opisują połączenie inaczej.
Opublikowano: · 4 min czytania · Sprawdzono z oficjalną dokumentacją Open WebUI w dniu 2026-10-26. Polecenia, tagi obrazów i ustawienia zmieniają się między wersjami, więc zanim uruchomisz cokolwiek na serwerze, potwierdź je w aktualnych dokumentach.
Najpierw sprawdź pamięć
Open WebUI to dodatkowy program na tym samym serwerze, a dokumentacja nie podaje dla niego żadnej wartości pamięci. Według przewodnika szybkiego startu standardowy obraz, z tagiem main, zawiera wbudowane modele zamiany mowy na tekst i modele osadzeń. Najpierw oszacuj pamięć potrzebną dla swojego modelu i zostaw zapas na interfejs oraz system operacyjny.
Wypróbuj: Local LLM Memory Estimator
Oszacowanie
- Wagi modelu
- 4.84 GiB
- KV cache
- 0.56 GiB
- Rezerwa
- 1.00 GiB
- Suma
- 6.41 GiB (6.88 GB)
- Najmniejszy popularny rozmiar pamięci, który to pomieści
- 8 GiB
To jest oszacowanie. Nie obejmuje buforów obliczeniowych środowiska uruchomieniowego i zakłada, że każda warstwa ma ten sam kształt KV. Zanim wybierzesz plan, zmierz prawdziwe uruchomienie.
Dane modelu sprawdzono: 2026-10-26.
Źródła: Ollama library · Konfiguracja modelu (config.json) · Ollama FAQ
Wszystko działa w Twojej przeglądarce. Nic nie jest przesyłane.
Uruchom go w Dockerze
Przewodnik szybkiego startu udostępnia Open WebUI pod adresem http://localhost:3000 i uruchamia go jednym poleceniem docker run. Zamień your-secret-key na wartość, którą sam wygenerujesz, na przykład poleceniem, które podaje do tego przewodnik.
| Krok | Polecenie |
|---|---|
| Wygeneruj tajny klucz | openssl rand -hex 32 |
| Uruchom Open WebUI | 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 --name open-webui --restart always ghcr.io/open-webui/open-webui:main |
| Śledź logi | docker logs -f open-webui |
- -p 3000:8080 mapuje port 3000 hosta na port 8080 kontenera.
- Wolumen open-webui przechowuje twoje czaty, użytkowników i ustawienia. Przewodnik mówi, że przetrwa on aktualizacje i że nigdy nie należy uruchamiać kontenera bez niego.
- WEBUI_SECRET_KEY: przewodnik mówi, aby ustawić go raz i zachować, ponieważ bez stałego klucza każdy ponownie utworzony kontener wylogowuje wszystkich, a nowy klucz wylogowuje wszystkich.
- Tagi obrazów: main to obraz standardowy, cuda dodaje obsługę GPU NVIDIA i wymaga --gpus all, a ollama dołącza Ollama do tego samego kontenera.
Pierwsze konto jest kontem administratora
Pierwszy ekran proponuje utworzenie konta administratora. Według przewodnika to pierwsze konto jest administratorem, który zarządza użytkownikami i wszystkimi ustawieniami całej instancji, a rejestracja wyłącza się sama, gdy konto administratora już istnieje.
Nasza rekomendacja, nie stwierdzenie z dokumentów: utwórz konto administratora zaraz po uruchomieniu kontenera, zanim komukolwiek podasz adres, ponieważ konto może utworzyć ten, kto pierwszy otworzy stronę.
Połączenie z Ollama: dwa sposoby w dokumentacji
Strony Open WebUI, które sprawdziliśmy, opisują połączenie na dwa różne sposoby. Korzystaj ze strony odpowiadającej uruchomionej przez ciebie wersji i sprawdź w Ustawienia, Administrator, Połączenia, który typ oferuje twoja wersja.
| Połączenie | Co mówi strona |
|---|---|
| Protokół Ollama API | W Ustawienia > Administrator > Połączenia, Zarządzaj połączeniami Ollama API. Strona podaje port 11434 jako typowy i mówi, aby użyć http://host.docker.internal:11434, gdy Open WebUI działa w Dockerze, a Ollama na hoście. |
| Połączenie typu OpenAI | Dodaj połączenie typu OpenAI z adresem bazowym (Base URL) http://localhost:11434/v1 i dowolnym tekstem jako kluczem API. Strona mówi, że Ollama nie sprawdza klucza, ale pole nie może być puste, oraz że wpisanie ollama działa. |
- Pobrane modele są wykrywane automatycznie i pojawiają się w selektorze modeli. Możesz je ograniczyć listą rozdzieloną przecinkami.
- Możesz dodać kilka instancji Ollama. Strona mówi, że żądania są rozdzielane przez losowy wybór, identyfikatory modeli muszą być dokładnie takie same we wszystkich instancjach, a prefiks, taki jak remote/, pozwala odróżnić instancje o tych samych nazwach modeli.
- Dla wolnego lub nieosiągalnego punktu końcowego strona sugeruje ustawienie AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=3 (domyślnie jest to 10 sekund), aby przełączenie na inną instancję było szybsze.
- Jeśli połączenie się nie udaje, strona wskazuje jako najczęstszą przyczynę błędną konfigurację sieci i odsyła do swojego przewodnika rozwiązywania problemów.
Strony, które sprawdziliśmy, nie mówią, czy kontener może połączyć się z Ollama nasłuchującą tylko na 127.0.0.1, i nie opisują rozszerzania adresu Ollama. Według jej FAQ Ollama domyślnie wiąże się z 127.0.0.1. Nasza rekomendacja: nie otwieraj Ollama na całą sieć bez reguły zapory, która ogranicza dostęp do adresów, z których korzystasz.
Aktualizacja i usuwanie
| Zadanie | Polecenia z przewodnika szybkiego startu |
|---|---|
| Aktualizacja ręczna | docker rm -f open-webui, potem docker pull ghcr.io/open-webui/open-webui:main, potem to samo polecenie docker run co wcześniej |
| Aktualizacja przez Watchtower | docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock nickfedor/watchtower --run-once open-webui |
| Odinstalowanie | docker rm -f open-webui, potem docker rmi ghcr.io/open-webui/open-webui:main, potem docker volume rm open-webui |
Usunięcie wolumenu kasuje twoje czaty, użytkowników i ustawienia. Przewodnik mówi, że twoje dane znajdują się w wolumenie, więc zachowaj go podczas aktualizacji.
Zachowaj prywatność
- Przewodnik szybkiego startu pokazuje wariant z WEBUI_AUTH=False. Nasza rekomendacja, nie stwierdzenie z dokumentów: nie używaj go na serwerze, do którego ma dostęp ktokolwiek.
- Zanim udostępnisz adres, umieść przed portem 3000 HTTPS i regułę zapory, a tajny klucz trzymaj poza wszystkim, co trafia do repozytorium.
- Przewodnik szybkiego startu pokazuje też, jak skierować Open WebUI na inny serwer za pomocą OLLAMA_BASE_URL. Jeśli to zrobisz, traktuj to połączenie również jako część swojej sieci prywatnej.
Źródła
Czytaj dalej
- nginx przed Ollamą: uwierzytelnianie podstawowe, HTTPS i ustawienia dla strumieniowaniaBezpieczny dostęp do Ollamy z zewnątrz: nginx jako proxy, uwierzytelnianie podstawowe, HTTPS, ustawienia strumieniowania i limitów czasu oraz reguła zapory sieciowej, na podstawie oficjalnej dokumentacji.
- Wywołanie lokalnego modelu z własnego kodu: ustrukturyzowane odpowiedzi i API zgodne z OpenAI w OllamaOgranicz odpowiedź lokalnego modelu za pomocą JSON Schema i wywołuj Ollama z klientów w stylu OpenAI: co mówi oficjalna dokumentacja i czego nie obsługuje.
- Co potrafi model lokalny? Tools, thinking, vision i embeddings w Ollamie oraz co zmieści się na VPSTools, thinking, vision, embeddings: co znaczą etykiety w bibliotece Ollama, które modele je mają i jak duże są pobrania.
- Instalacja Ollama na VPS i utrzymanie jej w ruchu: instalacja, usługa systemd, ustawienia i aktualizacjeInstalacja Ollama na VPS z Linuksem i utrzymanie jej w ruchu: polecenie instalacji, usługa systemd, zmienne środowiskowe, przechowywanie modeli i aktualizacje, na podstawie oficjalnej dokumentacji.