Namestitev Open WebUI in konfiguracija OmniProxy

Open WebUI je samostojno gostujoč vmesnik za klepet, ki ga lahko namestite na svoj računalnik ali strežnik in lahko deluje popolnoma brez povezave. Ni vezan na nobenega ponudnika modelov: lahko se poveže z orodji, kot je Ollama, ki modele poganjajo lokalno, ter 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 v ekipah in organizacijah. Zmogljivosti, ki prejemajo 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 na macOS, Linux in Windows. Namestite ga lahko z Dockerjem, Pythonom ali Kubernetesom. Docker pakira aplikacijo in njeno izvajalno okolje v razmeroma izoliran vsebnik in je priporočena metoda. Če Docker ni na voljo, lahko uporabite tudi preizkušen ukaz Python spodaj. 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 trajno shranite. Č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 polno ime, ki se uporablja za izbiro določenega modela.

Namestitev in prvi zagon

Odprite terminal in zaženite ukaz iz Quick Starta. 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 na 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 podatkovni nosilec (data volume). Podatkovni nosilec je lokacija zunaj vsebnika, kjer se podatki dolgoročno hranijo, zato vsebina ostane po posodobitvi vsebnika. Te možnosti ne odstranjujte.
• --add-host=host.docker.internal:host-gateway: Omogoča vsebniku dostop do drugih storitev, ki se izvajajo na tem računalniku.
• --restart always: Znova zažene vsebnik po ponovnem zagonu računalnika.

Ko se ukaz konča, v brskalniku odprite http://localhost:3000 in sledite navodilom na zaslonu za ustvarjanje prvega računa.

Če morate klepetati samo prek API-ja, lahko oznako slike spremenite iz :main v :slim. slim je manjša slika, ki ne vključuje lokalnih modelov za govor in vdelavo (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 podatkovni nosilec in WEBUI_SECRET_KEY nespremenjena.

Če Docker ni na voljo

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

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

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

Model za vdelavo (embedding model) se prenese med prvim zagonom, kar lahko traja nekaj minut. Model za vdelavo 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 imenik, ki bo dolgoročno ohranjen in uporabljen za shranjevanje podatkov Open WebUI. Če ni nastavljen, se podatki lahko shranijo v začasni imenik in po zaustavitvi izgubijo. Če WEBUI_SECRET_KEY ni nastavljen, program zapiše .webui_secret_key v trenutni imenik. Zaženite ga iz imenika, ki ga želite ohraniti, ali pa to spremenljivko nastavite sami.

Pridobitev podrobnosti povezave iz OmniProxy

Iz svojega primerka OmniProxy kopirajte naslednje tri elemente:

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 z dne 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

V Open WebUI ne vnašajte ključa ponudnika. Č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 gatewayu
• Uporabite seznam modelov gatewaya
• Nato preglejte dnevnike zahtev

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

Č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 različice v0.11.4, testirani 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 ohranite nastavljeno na Chat Completions.
8. Authentication Method ohranite 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. Dne 2026-10-09 sta tako preverjanje kot en pogovor uspela s praznim poljem.
9. Kliknite Verify Connection poleg URL-ja. Če OmniProxy zagotovi /models, se bo tukaj pridobil seznam modelov.
10. Odprite Advanced. Če je Model ID prazen, se bodo uporabili 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 te končne točke ne zagotavljajo, zato lahko preverjanje poroča o napaki, čeprav klepet še vedno deluje. V tem primeru ročno dodajte ID modela.

Preverjanje z dejansko nalogo

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

Dne 2026-10-09 je bil ta pogovor dokončan z uporabo namestitve Python različice v0.11.4. Docker ostaja priporočena metoda, vendar test v Dockerju ni bil ponovljen.

Nato odprite dnevnike 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

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

Dnevniki

Vidno v gatewayu

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

Pogoste napake

• localhost ali 127.0.0.1 je bil uporabljen 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 za vdelavo konča. Z docker ps lahko 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 OpenAI-compatible connection instructions. Za ID-je modelov, uporabljene v primerih, glejte Claude model overview in Gemini model list.

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 Agentov. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Open WebUI ↗