Namestitev Open WebUI in konfiguracija OmniProxy

Open WebUI je samostojno gostujoč vmesnik za klepet, ki ga lahko namestite v svoj računalnik ali strežnik in lahko deluje tudi popolnoma brez povezave. Ni vezan na nobenega ponudnika modelov: lahko se poveže z orodji, kot je Ollama, ki modele izvaja lokalno, pa tudi s končnimi točkami, združljivimi z OpenAI – naslovi, ki zagotavljajo storitve modelov z uporabo enakega formata zahtev. To vam omogoča preklapljanje med lokalnimi in oblakovnimi modeli v istem oknu.

Primeren je za dolgoročno uporabo s strani ekip in organizacij. Zmogljivosti, ki prejmejo hitrejše posodobitve, se najprej pojavijo v Computer, izdelku, ki ga Open WebUI uporablja za preizkušanje novih funkcij.

Preden začnete

Open WebUI je na voljo v sistemih macOS, Linux in Windows. Namestite ga lahko z uporabo Dockerja, Pythona ali Kubernetesa. Docker zapakira aplikacijo in njeno izvajalno okolje v razmeroma izoliran vsebnik in je priporočena metoda. Če Docker ni na voljo, lahko uporabite tudi spodaj preizkušen ukaz Python. Kubernetes je sistem za uvajanje in upravljanje vsebnikov; za ustrezne korake glejte Quick Start, povezan na koncu tega vodnika.

Uradno priporočeno

Docker

• En ukaz docker run
• Odprite 3000 v brskalniku
• Podatki so shranjeni v nosilcu (volume)

Samo želite klepetati

slim slika

• Manjša velikost prenosa
• Spremenite oznako v :slim
• Funkcionalnost klepeta ostane na voljo

Tukaj ni zajeto

Dve drugi možnosti

• Ročna namestitev Python
• Uvajanje Kubernetes
• Glejte uradni Quick Start

Pred začetkom pripravite naslednje:

• Nameščen in delujoč Docker.
• Skrivni niz, ki ga uporabljate samo vi. Zaženite openssl rand -hex 32, da ga ustvarite, nato ga vnesite kot WEBUI_SECRET_KEY. To vrednost shranite trajno. Če jo spremenite pri ponovni gradnji vsebnika, bodo uporabniki, ki so že prijavljeni, odjavljeni.
• Delujoč primerek OmniProxy in ID modela s trenutnega seznama modelov. ID modela je popolno ime, ki se uporablja za izbiro določenega modela.

Prva namestitev in zagon

Odprite terminal in zaženite ukaz iz Quick Start. Najprej zamenjajte your-secret-key s skrivnostjo, ki ste jo pravkar ustvarili:

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

Naslednji deli tega ukaza služijo različnim namenom:

• -p 3000:8080: Omogoča odpiranje vmesnika prek vrat 3000 v tem računalniku. Če so vrata 3000 že v uporabi, spremenite številko na levi.
• -v open-webui:/app/backend/data: Shranjuje klepete, uporabnike in nastavitve v nosilec podatkov. Nosilec podatkov je lokacija zunaj vsebnika, kjer se podatki dolgoročno hranijo, zato vsebina ostane po posodobitvi vsebnika. Ne odstranjujte te možnosti.
• --add-host=host.docker.internal:host-gateway: Omogoča vsebniku dostop do drugih storitev, ki se izvajajo v tem računalniku.
• --restart always: Znova zažene vsebnik po ponovnem zagonu računalnika.

Ko se ukaz konča, odprite http://localhost:3000 v brskalniku in sledite navodilom na zaslonu, da ustvarite prvi račun.

Če morate klepetati samo prek API-ja, lahko spremenite oznako slike iz :main v :slim. slim je manjša slika, ki ne vključuje lokalnih modelov govora in vdelave (embedding) znotraj vsebnika, vendar vmesnik za klepet ostane na voljo. Še naprej uporabljajte :main, če potrebujete te lokalne zmogljivosti.

Za ročne posodobitve najprej zaženite docker rm -f open-webui, nato zaženite docker pull ghcr.io/open-webui/open-webui:main in ga znova zaženite z istim ukazom docker run. Ohranite nosilec podatkov in WEBUI_SECRET_KEY nespremenjena.

Če Docker ni na voljo

Quick Start ponuja tudi metodo namestitve Python. Na dan 2026-10-09 je bil naslednji ukaz uporabljen v macOS za namestitev Open WebUI v0.11.4 in dokončanje enega pogovora. Docker Desktop takrat v tem računalniku ni bil nameščen.

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Po zagonu odprite http://localhost:8080 v brskalniku. To so vrata, ki jih uporablja namestitev Python, ne vrata 3000 Dockerja.

Model vdelave (embedding) se prenese med prvim zagonom, kar lahko traja nekaj minut. Model vdelave pretvori besedilo v podatke, ki jih je lažje iskati in ujemati. Pred nadaljevanjem počakajte, da se prikaže stran za prijavo. Prvi registrirani račun postane skrbnik. Jezik vmesnika sledi sistemskemu jeziku; med tem testom je bila prikazana poenostavljena kitajščina.

DATA_DIR mora kazati na mapo, ki bo dolgoročno ohranjena in uporabljena za shranjevanje podatkov Open WebUI. Če ni nastavljena, se lahko podatki shranijo v začasno mapo in po zaustavitvi izgubijo. Če WEBUI_SECRET_KEY ni nastavljena, program zapiše .webui_secret_key v trenutno mapo. Zaženite ga iz mape, ki jo nameravate ohraniti, ali sami nastavite to spremenljivko.

Pridobitev podrobnosti povezave iz OmniProxy

Kopirajte naslednje tri elemente iz svojega primerka OmniProxy:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

URL je naslov, ki ga Open WebUI uporablja za povezavo s končno točko in se mora končati z /v1. Za njim ne dodajajte /chat/completions; Open WebUI ta del doda samodejno.

Kopirajte celoten ID modela s trenutnega seznama OmniProxy. Če ID vključuje predpono vira in poševnico, ohranite tudi te. Naslednji dve kratki imeni sta le referenci iz dokumentacije ponudnika od 2026-10-09. Ne uporabljajte ju, če nista na trenutnem seznamu:

• Claude API ID za Claude Sonnet 5.5: claude-sonnet-5-5
• API ime za Gemini 3.8 Flash: gemini-3.8-flash

Ne vnašajte ključa ponudnika v Open WebUI. Če prehod ne preverja ključev, pustite API ključ prazen, namesto da izmišljate drug ključ.

Brskalnik

Lokalna vrata 3000

• Odprite stran za klepet
• Najprej dokončajte registracijo
• Nato odprite nastavitve

Znotraj vsebnika

Open WebUI

• Ne uporabljajte localhost
• Namesto tega uporabite ime gostiteljskega računalnika
• URL se konča z /v1

Isti računalnik

OmniProxy

• Ključ hranite v prehodu
• Uporabite seznam modelov prehoda
• Nato preglejte dnevnike zahtev

Če se storitev modela izvaja v gostitelju, medtem ko Open WebUI deluje v vsebniku Docker, zamenjajte localhost v URL-ju z host.docker.internal. Gostitelj je računalnik, ki neposredno izvaja Docker. Če OmniProxy posluša samo v tem računalniku, se lahko URL zapiše kot http://host.docker.internal:port/v1, pri čemer port zamenjate z vrati, ki jih OmniProxy dejansko uporablja.

Če Open WebUI deluje lokalno prek ukaza Python v prejšnjem razdelku in OmniProxy prav tako deluje lokalno, v naslovu uporabite 127.0.0.1 ali localhost. V tem primeru ne uporabljajte host.docker.internal.

Vnos konfiguracije

V vmesniku v poenostavljeni kitajščini v0.11.4, testiranem 2026-10-09, so se imena razlikovala od Settings > Admin > Connections v angleških navodilih. Sledite možnostim, prikazanim v testiranem vmesniku, prevedenim spodaj:

1. Razširite levo stransko vrstico.
2. Kliknite uporabniški meni na dnu.
3. Kliknite Settings.
4. V spodnjem skrbniškem razdelku kliknite External Connections.
5. Odprite OpenAI API.
6. Kliknite + desno od Manage OpenAI API Connections.
7. V pogovornem oknu Edit Connection vnesite URL, ki se konča z /v1. Vrsto API-ja pustite nastavljeno na Chat Completions.
8. Authentication Method pustite nastavljeno na Key (Bearer). Bearer avtentikacija postavi API ključ v zahtevo za preverjanje identitete. Če vam je OmniProxy dal ključ, ga vnesite pod API Key. Če prehod ne preverja ključev, pustite to polje prazno. Na dan 2026-10-09 sta tako preverjanje kot en pogovor uspela s praznim poljem.
9. Kliknite Verify Connection poleg URL-ja. Če OmniProxy zagotovi /models, bo seznam modelov pridobljen tukaj.
10. Odprite Advanced. Če je Model ID prazen, bodo uporabljeni vsi modeli, ki jih vrne /models na tem naslovu. Samo če preverjanje ne uspe, vnesite celoten ID s seznama pod Add Model ID, nato kliknite Add. Vsak ID dodajte le enkrat; vodilni in končni presledki se odstranijo.
11. Kliknite Save v tem oknu, nato kliknite Save v spodnjem desnem kotu strani External Connections.

Samo shranjevanje konfiguracije ne nadomesti preverjanja. Verify Connection zahteva končno točko /models druge storitve, ki navaja razpoložljive modele. Nekatere storitve ne zagotavljajo te končne točke, zato lahko preverjanje poroča o napaki, čeprav klepet še vedno deluje. V tem primeru ročno dodajte ID modela.

Preverjanje dejanske naloge

Vrnite se na stran za klepet, odprite meni modelov poleg vnosnega polja in izberite celoten ID s seznama OmniProxy. Pošljite zelo kratko sporočilo, na primer tako, da ga prosite, naj odgovori samo z eno besedo. Odgovor se mora dejansko pojaviti v polju za klepet.

Na dan 2026-10-09 je bil ta pogovor opravljen z uporabo namestitve Python v0.11.4. Docker ostaja priporočena metoda, vendar test v Dockerju ni bil ponovljen.

Nato odprite zapise zahtev OmniProxy in potrdite vir ter ID modela za to zahtevo. Videti samo uspešno shranjevanje ali samo videti model v meniju ne šteje kot dokončanje.

Vmesnik

Model je mogoče izbrati

• Povezave so bile shranjene
• Model se prikaže na seznamu
• Pošljite kratko vprašanje

Odgovor

Polje za klepet prikazuje odgovor

• Ni prazno sporočilo
• Ni napaka povezave
• Poskusite znova z drugim modelom

Dnevniki

Vidno v prehodu

• Vir je ta povezava
• ID modela se ujema
• Na strani ni bil vnesen noben ključ

Pogoste napake

• localhost ali 127.0.0.1 sta bila uporabljena znotraj vsebnika: Ti naslovi kažejo na sam vsebnik, ne na gostitelja. Spremenite naslov v host.docker.internal in potrdite, da ukaz za zagon vključuje --add-host=host.docker.internal:host-gateway. Obratno velja, ko Open WebUI ne deluje v vsebniku: namesto tega uporabite lokalni naslov.
• Brskalnik ne more odpreti strani: Za Docker preverite vrata 3000; za Python preverite vrata 8080. Med prvim zagonom počakajte, da se prenos modela vdelave konča. Uporabite docker ps, da potrdite, ali vsebnik deluje. Če so vrata 3000 že v uporabi, spremenite vrata na levi strani -p.
• ID v meniju modelov je daljši od kratkega imena ponudnika: Uporabite celoten ID iz menija, vključno s poševnicami.
• Vsi so odjavljeni po posodobitvi: WEBUI_SECRET_KEY se je spremenil. Znova zaženite s skrivnostjo, ustvarjeno prvič.
• Verify Connection ne uspe: Najprej ročno dodajte ID modela pod Advanced, nato ga potrdite z dejanskim klepetom z enim stavkom. Nekatere storitve ne zagotavljajo /models, zato klepet morda še vedno deluje, ko preverjanje poroča o napaki.
• Model ne obstaja: Ponovno kopirajte ID s trenutnega seznama OmniProxy, namesto da še naprej uporabljate zastarelo ime.

Uradne reference

Za ukaze za namestitev glejte Open WebUI Quick Start. Za korake povezave glejte navodila za povezavo, združljivo z OpenAI. Za ID-je modelov, uporabljene v primerih, glejte pregled modelov Claude in seznam modelov Gemini.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Open WebUI ↗