Open WebUI installimine ja OmniProxy konfiguratsioon

Open WebUI on isehostitav vestlusliides, mida saab installida oma arvutisse või serverisse ning mis võib töötada ka täiesti võrguühenduseta. See ei ole seotud ühegi mudeliteenuse pakkujaga: see saab ühenduda tööriistadega, nagu Ollama, mis käitavad mudeleid kohapeal, samuti OpenAI-ga ühilduvate lõpp-punktidega – aadressidega, mis pakuvad mudeliteenuseid sama päringuvorminguga. See võimaldab teil samas aknas vahetada kohalike ja pilvemudelite vahel.

See sobib pikaajaliseks kasutamiseks meeskondadele ja organisatsioonidele. Võimalused, mis saavad kiiremaid värskendusi, ilmuvad esimesena Computeris, tootes, mida Open WebUI kasutab uute funktsioonide proovimiseks.

Enne alustamist

Open WebUI on saadaval macOS-il, Linuxil ja Windowsil. Saate selle installida Dockeri, Pythoni või Kubernetesega. Docker pakendab rakenduse ja selle käituskeskkonna suhteliselt isoleeritud konteinerisse ning on soovitatav meetod. Kui Docker pole saadaval, võite kasutada ka allpool testitud Pythoni käsku. Kubernetes on süsteem konteinerite juurutamiseks ja haldamiseks; vastavate sammude kohta vaadake selle juhendi lõpus lingitud kiirjuhendit.

Ametlikult soovitatav

Docker

• Üks docker run käsk
• Avage brauseris 3000
• Andmed salvestatakse köitesse

Soovin lihtsalt vestelda

slim pilt

• Väiksem allalaadimise suurus
• Muutke silt väärtuseks :slim
• Vestlusfunktsioon jääb kättesaadavaks

Siin ei käsitleta

Kaks muud võimalust

• Käsitsi Pythoni installimine
• Kubernetese juurutamine
• Vaadake ametlikku kiirjuhendit

Enne alustamist valmistage ette järgmine:

• Docker on installitud ja töötab.
• Salajane string, mida kasutate ainult teie. Käivitage openssl rand -hex 32 selle genereerimiseks, seejärel sisestage see kui WEBUI_SECRET_KEY. Salvestage see väärtus jäädavalt. Kui muudate seda konteineri uuesti ehitamisel, logitakse juba sisseloginud kasutajad välja.
• Töötav OmniProxy eksemplar ja mudeli ID selle praegusest mudelite loendist. Mudeli ID on täielik nimi, mida kasutatakse konkreetse mudeli valimiseks.

Installimine ja esmakordne käivitamine

Avage terminal ja käivitage käsk kiirjuhendist. Esmalt asendage your-secret-key äsja genereeritud saladusega:

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

Selle käsu järgmised osad täidavad erinevaid eesmärke:

• -p 3000:8080: Võimaldab avada liidese selle arvuti pordi 3000 kaudu. Kui port 3000 on juba kasutusel, muutke vasakpoolset numbrit.
• -v open-webui:/app/backend/data: Salvestab vestlused, kasutajad ja seaded andmeköitesse. Andmeköide on konteinerist väljaspool asuv asukoht, kus andmeid säilitatakse pikaajaliselt, nii et nende sisu jääb alles pärast konteineri värskendamist. Ärge eemaldage seda valikut.
• --add-host=host.docker.internal:host-gateway: Võimaldab konteineril pääseda juurde teistele selles arvutis töötavatele teenustele.
• --restart always: Käivitab konteineri uuesti pärast arvuti taaskäivitamist.

Pärast käsu lõpetamist avage http://localhost:3000 brauseris ja järgige ekraanil kuvatavaid juhiseid esimese konto loomiseks.

Kui peate vestlema ainult API kaudu, saate pildi sildi muuta väärtusest :main väärtuseks :slim. slim on väiksem pilt, mis ei sisalda konteineris kohalikke kõne- ja manustamismudeleid, kuid vestlusliides jääb kättesaadavaks. Jätkake :main kasutamist, kui vajate neid kohalikke võimalusi.

Käsitsi värskendamiseks käivitage esmalt docker rm -f open-webui, seejärel käivitage docker pull ghcr.io/open-webui/open-webui:mainja taaskäivitage see sama docker run käsuga. Hoidke nii andmeköide kui ka WEBUI_SECRET_KEY muutumatuna.

Kui Docker pole saadaval

Kiirjuhend pakub ka Pythoni installimeetodit. 2026-10-09 kasutati macOS-il järgmist käsku Open WebUI v0.11.4 installimiseks ja ühe vestluse lõpetamiseks. Docker Desktop ei olnud sel ajal selles arvutis installitud.

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

Pärast käivitamist avage http://localhost:8080 brauseris. See on Pythoni installimise kasutatav port, mitte Dockeri port 3000.

Manustamismudel laaditakse alla esimese käivitamise ajal, mis võib võtta mitu minutit. Manustamismudel teisendab teksti andmeteks, mida on lihtsam otsida ja sobitada. Enne jätkamist oodake, kuni ilmub sisselogimisleht. Esimene registreeritud konto muutub administraatoriks. Liidese keel järgib süsteemi keelt; selle testi ajal kuvati lihtsustatud hiina keelt.

DATA_DIR peab osutama kataloogile, mida säilitatakse pikaajaliselt ja mida kasutatakse Open WebUI andmete salvestamiseks. Kui seda pole seatud, võidakse andmed salvestada ajutisse kataloogi ja pärast väljalülitamist kaotsi minna. Kui WEBUI_SECRET_KEY pole seatud, kirjutab programm .webui_secret_key praegusesse kataloogi. Käivitage see kataloogist, mida kavatsete säilitada, või määrake see muutuja ise.

Ühenduse üksikasjade hankimine OmniProxyst

Kopeerige oma OmniProxy eksemplarist järgmised kolm üksust:

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

URL on aadress, mida Open WebUI kasutab lõpp-punktiga ühenduse loomiseks ja see peab lõppema /v1. Ärge lisage /chat/completions pärast seda; Open WebUI lisab selle osa automaatselt.

Kopeerige täielik mudeli ID OmniProxy praegusest loendist. Kui ID sisaldab allika eesliidet ja kaldkriipsu, säilitage ka need. Järgmised kaks lühinime on ainult viited teenusepakkuja dokumentatsioonist seisuga 2026-10-09. Ärge kasutage neid, kui neid praeguses loendis ei ole:

• Claude API ID Claude Sonnet 5.5 jaoks: claude-sonnet-5-5
• API nimi Gemini 3.8 Flashi jaoks: gemini-3.8-flash

Ärge sisestage Open WebUI-sse teenusepakkuja võtit. Kui lüüs võtmeid ei valideeri, jätke API võti tühjaks, selle asemel et leiutada teine võti.

Brauser

Kohalik port 3000

• Avage vestlusleht
• Lõpetage esmalt registreerimine
• Seejärel avage seaded

Konteineris

Open WebUI

• Ärge kasutage localhosti
• Kasutage selle asemel hostmasina nime
• URL lõpeb /v1-ga

Sama arvuti

OmniProxy

• Hoidke võtit lüüsis
• Kasutage lüüsi mudelite loendit
• Seejärel vaadake päringulogisid

Kui mudeliteenus töötab hostis, samas kui Open WebUI töötab Dockeri konteineris, asendage localhost URL-is väärtusega host.docker.internal. Host on arvuti, mis käitab Dockerit otse. Kui OmniProxy kuulab ainult selles arvutis, saab URL-i kirjutada kui http://host.docker.internal:port/v1, asendades port pordiga, mida OmniProxy tegelikult kasutab.

Kui Open WebUI töötab kohapeal eelmises jaotises toodud Pythoni käsu kaudu ja OmniProxy töötab samuti kohapeal, kasutage 127.0.0.1 või localhost aadressis. Ärge kasutage host.docker.internal sel juhul.

Konfiguratsiooni sisestamine

2026-10-09 testitud v0.11.4 lihtsustatud hiina keele liideses erinesid nimed ingliskeelsete juhiste jaotisest Settings > Admin > Connections. Järgige testitud liideses kuvatavaid valikuid, mis on allpool tõlgitud:

1. Laiendage vasakut külgriba.
2. Klõpsake allosas kasutajamenüüd.
3. Klõpsake Settings.
4. Allpool olevas administraatori jaotises klõpsake External Connections.
5. Avage OpenAI API.
6. Klõpsake + jaotise Manage OpenAI API Connections paremal pool.
7. Sisestage dialoogis Edit Connection URL, mis lõpeb /v1. Hoidke API tüüp seatuna väärtusele Chat Completions.
8. Hoidke Authentication Method seatuna väärtusele Key (Bearer). Bearer-autentimine paigutab API võtme päringusse identiteedi kontrollimiseks. Kui OmniProxy andis teile võtme, sisestage see jaotisesse API Key. Kui lüüs võtmeid ei valideeri, jätke see väli tühjaks. 2026-10-09 õnnestus nii valideerimine kui ka üks vestlus, kui väli jäeti tühjaks.
9. Klõpsake URL-i kõrval Verify Connection. Kui OmniProxy pakub /models, tuuakse mudelite loend siia.
10. Avage Advanced. Kui Model ID jäetakse tühjaks, kasutatakse kõiki mudeleid, mida tagastab /models sellel aadressil. Ainult juhul, kui valideerimine ebaõnnestub, sisestage jaotisesse Add Model ID loendist täielik ID, seejärel klõpsake Add. Lisage iga ID ainult üks kord; algus- ja lõputühikud eemaldatakse.
11. Klõpsake selles aknas Save, seejärel klõpsake lehe External Connections paremas alanurgas Save.

Konfiguratsiooni salvestamine üksi ei asenda valideerimist. Verify Connection pärib teise teenuse /models lõpp-punkti, mis loetleb saadaolevad mudelid. Mõned teenused seda lõpp-punkti ei paku, seega võib valideerimine teatada veast, kuigi vestlus võib siiski töötada. Sel juhul lisage mudeli ID käsitsi.

Kontrollige tegelikku ülesannet

Naaske vestluslehele, avage sisestuskasti kõrval olev mudelimenüü ja valige OmniProxy loendist täielik ID. Saatke väga lühike sõnum, näiteks paludes sellel vastata ainult ühe sõnaga. Vestluskasti peab tegelikult ilmuma vastus.

2026-10-09 lõpetati see vestlus v0.11.4 Pythoni installimise abil. Docker on endiselt soovitatav meetod, kuid testi Dockeris ei korratud.

Järgmisena avage OmniProxy päringulogid ja kinnitage selle päringu allikas ja mudeli ID. Ainult eduka salvestamise nägemine või ainult mudeli menüüs nägemine ei loeta lõpetatuks.

Liides

Mudelit saab valida

• Ühendused on salvestatud
• Mudel ilmub loendisse
• Saatke lühike küsimus

Vastus

Vestluskast näitab vastust

• See ei ole tühi sõnum
• See ei ole ühenduse viga
• Proovige uuesti teise mudeliga

Logid

Nähtav lüüsis

• Allikas on see ühendus
• Mudeli ID ühtib
• Lehel ei sisestatud võtit

Levinud vead

• localhost või 127.0.0.1 kasutati konteineris: Need aadressid osutavad konteinerile endale, mitte hostile. Muutke aadress väärtuseks host.docker.internal ja veenduge, et käivitamiskäsk sisaldab --add-host=host.docker.internal:host-gateway. Vastupidine kehtib siis, kui Open WebUI ei tööta konteineris: kasutage selle asemel kohalikku aadressi.
• Brauser ei saa lehte avada: Dockeri puhul kontrollige porti 3000; Pythoni puhul kontrollige porti 8080. Esimese käivitamise ajal oodake, kuni manustamismudeli allalaadimine lõpeb. Saate kasutada docker ps et kinnitada, kas konteiner töötab. Kui port 3000 on juba kasutusel, muutke porti -pvasakul küljel.
• Mudelimenüüs olev ID on pikem kui teenusepakkuja lühinimi: Kasutage menüüst täielikku ID-d, sealhulgas kõiki kaldkriipse.
• Kõik logitakse pärast värskendamist välja: WEBUI_SECRET_KEY muutus. Taaskäivitage, kasutades esimesel korral genereeritud saladust.
• Verify Connection ebaõnnestub: Lisage esmalt käsitsi mudeli ID jaotises Advanced, seejärel kinnitage see tegeliku ühelausega vestlusega. Mõned teenused ei paku /models, seega võib vestlus siiski töötada, kui valideerimine teatab veast.
• Mudelit pole olemas: Kopeerige ID uuesti OmniProxy praegusest loendist, selle asemel et jätkata aegunud nime kasutamist.

Ametlikud viited

Installimiskäskude kohta vaadake Open WebUI Quick Start. Ühenduse sammude kohta vaadake OpenAI-compatible connection instructions. Näidetes kasutatud mudeli ID-de kohta vaadake Claude model overview ja Gemini model list.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · Open WebUI ↗