„Open WebUI“ diegimas ir „OmniProxy“ konfigūravimas

„Open WebUI“ yra savarankiškai priglobta pokalbių sąsaja, kurią galima įdiegti savo kompiuteryje ar serveryje ir kuri taip pat gali veikti visiškai neprisijungus. Ji nėra susieta su jokiu vienu modelių teikėju: ji gali prisijungti prie įrankių, tokių kaip „Ollama“, kurie vykdo modelius vietoje, taip pat prie „OpenAI“ suderinamų galinių punktų – adresų, kurie teikia modelių paslaugas naudodami tą patį užklausos formatą. Tai leidžia tame pačiame lange perjungti vietinius ir debesies modelius.

Ji tinka ilgalaikiam naudojimui komandoms ir organizacijoms. Funkcijos, kurios gauna greitesnius atnaujinimus, pirmiausia pasirodo „Computer“ – produkte, kurį „Open WebUI“ naudoja naujoms funkcijoms išbandyti.

Prieš pradedant

„Open WebUI“ galima naudoti „macOS“, „Linux“ ir „Windows“ sistemose. Galite įdiegti naudodami „Docker“, „Python“ arba „Kubernetes“. „Docker“ supakuoja programą ir jos vykdymo aplinką į palyginti izoliuotą konteinerį ir yra rekomenduojamas metodas. Jei „Docker“ nepasiekiamas, taip pat galite naudoti žemiau pateiktą išbandytą „Python“ komandą. „Kubernetes“ yra konteinerių diegimo ir valdymo sistema; atitinkamus veiksmus rasite šio vadovo pabaigoje pateiktoje greitojo paleidimo nuorodoje.

Oficialiai rekomenduojama

Docker

• Viena „docker run“ komanda
• Atidarykite 3000 naršyklėje
• Duomenys saugomi tome

Tiesiog noriu pabendrauti

slim atvaizdas

• Mažesnis atsisiuntimo dydis
• Pakeiskite žymą į :slim
• Pokalbių funkcionalumas išlieka prieinamas

Čia neaprašyta

Dvi kitos parinktys

• Rankinis „Python“ diegimas
• „Kubernetes“ diegimas
• Žr. oficialų greitąjį paleidimą

Prieš pradedant, paruoškite šiuos dalykus:

• Įdiegtas ir veikiantis „Docker“.
• Slapta eilutė, naudojama tik jūsų. Paleiskite openssl rand -hex 32 kad sugeneruotumėte vieną, tada įveskite ją kaip WEBUI_SECRET_KEY. Išsaugokite šią reikšmę visam laikui. Jei pakeisite ją perstatydami konteinerį, vartotojai, kurie jau yra prisijungę, bus atjungti.
• Veikiantis „OmniProxy“ egzempliorius ir modelio ID iš dabartinio modelių sąrašo. Modelio ID yra visas pavadinimas, naudojamas konkrečiam modeliui pasirinkti.

Pirmasis diegimas ir paleidimas

Atidarykite terminalą ir paleiskite komandą iš greitojo paleidimo. Pirmiausia pakeiskite your-secret-key savo ką tik sugeneruotu slaptu raktu:

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

Šios komandos dalys atlieka skirtingas funkcijas:

• -p 3000:8080: Leidžia atidaryti sąsają per 3000 prievadą šiame kompiuteryje. Jei 3000 prievadas jau naudojamas, pakeiskite skaičių kairėje.
• -v open-webui:/app/backend/data: Saugo pokalbius, vartotojus ir nustatymus duomenų tome. Duomenų tomas yra vieta už konteinerio ribų, kur duomenys saugomi ilgą laiką, todėl jų turinys išlieka po konteinerio atnaujinimo. Nešalinkite šios parinkties.
• --add-host=host.docker.internal:host-gateway: Leidžia konteineriui pasiekti kitas šiame kompiuteryje veikiančias paslaugas.
• --restart always: Iš naujo paleidžia konteinerį po kompiuterio perkrovimo.

Kai komanda baigiasi, atidarykite http://localhost:3000 naršyklėje ir vadovaukitės ekrane pateikiamomis instrukcijomis, kad sukurtumėte pirmąją paskyrą.

Jei bendrauti reikia tik per API, galite pakeisti atvaizdo žymą iš :main į :slim. „slim“ yra mažesnis atvaizdas, kuriame nėra vietinių kalbos ir įterpimo modelių konteinerio viduje, tačiau pokalbių sąsaja išlieka prieinama. Tęskite naudoti :main jei jums reikia tų vietinių galimybių.

Rankiniam atnaujinimui pirmiausia paleiskite docker rm -f open-webui, tada paleiskite docker pull ghcr.io/open-webui/open-webui:main, ir iš naujo paleiskite su ta pačia docker run komanda. Išlaikykite duomenų tomą ir WEBUI_SECRET_KEY nepakeistus.

Jei „Docker“ nepasiekiamas

Greitasis paleidimas taip pat suteikia „Python“ diegimo metodą. 2026-10-09 ši komanda buvo naudojama „macOS“ sistemoje „Open WebUI v0.11.4“ įdiegti ir vienam pokalbiui užbaigti. „Docker Desktop“ tame kompiuteryje tuo metu nebuvo įdiegtas.

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

Po paleidimo atidarykite http://localhost:8080 naršyklėje. Tai prievadas, kurį naudoja „Python“ diegimas, o ne „Docker“ 3000 prievadas.

Įterpimo modelis atsisiunčiamas pirmojo paleidimo metu, tai gali užtrukti kelias minutes. Įterpimo modelis konvertuoja tekstą į duomenis, kuriuos lengviau ieškoti ir suderinti. Prieš tęsdami palaukite, kol pasirodys prisijungimo puslapis. Pirmoji užregistruota paskyra tampa administratoriumi. Sąsajos kalba atitinka sistemos kalbą; šio bandymo metu buvo rodoma supaprastinta kinų kalba.

DATA_DIR turi rodyti katalogą, kuris bus saugomas ilgą laiką ir naudojamas „Open WebUI“ duomenims saugoti. Jei jis nenustatytas, duomenys gali būti saugomi laikiname kataloge ir prarasti po išjungimo. Jei WEBUI_SECRET_KEY nenustatytas, programa įrašo .webui_secret_key dabartiniame kataloge. Paleiskite jį iš katalogo, kurį ketinate išsaugoti, arba patys nustatykite šį kintamąjį.

Ryšio duomenų gavimas iš „OmniProxy“

Nukopijuokite šiuos tris elementus iš savo „OmniProxy“ egzemplioriaus:

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

URL yra adresas, kurį „Open WebUI“ naudoja prisijungti prie galinio punkto, ir jis turi baigtis /v1. Nepridėkite /chat/completions po jo; „Open WebUI“ tą dalį prideda automatiškai.

Nukopijuokite visą modelio ID iš dabartinio „OmniProxy“ sąrašo. Jei ID apima šaltinio priešdėlį ir pasvirąjį brūkšnį, išsaugokite ir juos. Šie du trumpieji pavadinimai yra tik nuorodos iš teikėjo dokumentacijos 2026-10-09 duomenimis. Nenaudokite jų, jei jų nėra dabartiniame sąraše:

• „Claude API ID“ skirtas „Claude Sonnet 5.5“: claude-sonnet-5-5
• API pavadinimas skirtas „Gemini 3.8 Flash“: gemini-3.8-flash

Neįveskite teikėjo rakto „Open WebUI“. Jei „gateway“ nepatvirtina raktų, palikite API raktą tuščią, užuot sugalvoję kitą raktą.

Naršyklė

Vietinis 3000 prievadas

• Atidarykite pokalbių puslapį
• Pirmiausia užbaikite registraciją
• Tada atidarykite nustatymus

Konteinerio viduje

Open WebUI

• Nenaudokite localhost
• Vietoj to naudokite pagrindinio kompiuterio pavadinimą
• URL baigiasi /v1

Tas pats kompiuteris

OmniProxy

• Išlaikykite raktą „gateway“
• Naudokite „gateway“ modelių sąrašą
• Tada peržiūrėkite užklausų žurnalus

Jei modelių paslauga veikia pagrindiniame kompiuteryje, o „Open WebUI“ veikia „Docker“ konteineryje, pakeiskite localhost URL adrese į host.docker.internal. Pagrindinis kompiuteris yra kompiuteris, kuriame tiesiogiai veikia „Docker“. Jei „OmniProxy“ klauso tik šiame kompiuteryje, URL galima įrašyti kaip http://host.docker.internal:port/v1, pakeičiant port prievadu, kurį iš tikrųjų naudoja „OmniProxy“.

Jei „Open WebUI“ veikia vietoje per „Python“ komandą ankstesniame skyriuje, o „OmniProxy“ taip pat veikia vietoje, naudokite 127.0.0.1 arba localhost adrese. Nenaudokite host.docker.internal šiuo atveju.

Konfigūracijos įvedimas

2026-10-09 išbandytoje v0.11.4 supaprastintos kinų kalbos sąsajoje pavadinimai skyrėsi nuo „Settings > Admin > Connections“ angliškose instrukcijose. Vadovaukitės išbandytoje sąsajoje rodomomis parinktimis, išverstomis žemiau:

1. Išskleiskite kairę šoninę juostą.
2. Spustelėkite vartotojo meniu apačioje.
3. Spustelėkite Settings.
4. Žemiau esančiame administratoriaus skyriuje spustelėkite External Connections.
5. Atidarykite OpenAI API.
6. Spustelėkite + į dešinę nuo Manage OpenAI API Connections.
7. Dialogo lange Edit Connection įveskite URL, kuris baigiasi /v1. Palikite API tipą nustatytą į Chat Completions.
8. Palikite Authentication Method nustatytą į Key (Bearer). „Bearer“ autentifikavimas įdeda API raktą į užklausą tapatybei patvirtinti. Jei „OmniProxy“ davė jums raktą, įveskite jį po API Key. Jei „gateway“ nepatvirtina raktų, palikite šį lauką tuščią. 2026-10-09 tiek patvirtinimas, tiek vienas pokalbis pavyko palikus tuščią lauką.
9. Spustelėkite Verify Connection šalia URL. Jei „OmniProxy“ pateikia /models, modelių sąrašas bus gautas čia.
10. Atidarykite Advanced. Jei Model ID paliktas tuščias, bus naudojami visi modeliai, grąžinti /models tuo adresu. Tik jei patvirtinimas nepavyksta, įveskite visą ID iš sąrašo po Add Model ID, tada spustelėkite Add. Kiekvieną ID pridėkite tik vieną kartą; priekiniai ir galiniai tarpai pašalinami.
11. Spustelėkite Save šiame lange, tada spustelėkite Save apatiniame dešiniajame „External Connections“ puslapio kampe.

Konfigūracijos išsaugojimas savaime nepakeičia patvirtinimo. Verify Connection užklauso kitos paslaugos /models galinį punktą, kuriame išvardyti prieinami modeliai. Kai kurios paslaugos nepateikia šio galinio punkto, todėl patvirtinimas gali pranešti apie klaidą, nors pokalbiai vis tiek gali veikti. Tokiu atveju pridėkite modelio ID rankiniu būdu.

Tikros užduoties patikrinimas

Grįžkite į pokalbių puslapį, atidarykite modelių meniu šalia įvesties lauko ir pasirinkite visą ID iš „OmniProxy“ sąrašo. Išsiųskite labai trumpą pranešimą, pavyzdžiui, paprašydami atsakyti tik vienu žodžiu. Atsakymas tikrai turi pasirodyti pokalbių lauke.

2026-10-09 šis pokalbis buvo užbaigtas naudojant „v0.11.4“ „Python“ diegimą. „Docker“ išlieka rekomenduojamas metodas, tačiau bandymas „Docker“ nebuvo kartojamas.

Tada atidarykite „OmniProxy“ užklausų žurnalus ir patvirtinkite šios užklausos šaltinį bei modelio ID. Tik sėkmingo išsaugojimo matymas arba tik modelio matymas meniu nereiškia užbaigimo.

Sąsaja

Modelį galima pasirinkti

• Ryšiai išsaugoti
• Modelis pasirodo sąraše
• Išsiųskite trumpą klausimą

Atsakymas

Pokalbių lauke rodomas atsakymas

• Tai nėra tuščias pranešimas
• Tai nėra ryšio klaida
• Pabandykite dar kartą su kitu modeliu

Žurnalai

Matomi „gateway“

• Šaltinis yra šis ryšys
• Modelio ID sutampa
• Puslapyje nebuvo įvestas joks raktas

Dažnos klaidos

• localhost arba 127.0.0.1 buvo naudojami konteinerio viduje: Šie adresai rodo į patį konteinerį, o ne į pagrindinį kompiuterį. Pakeiskite adresą į host.docker.internal ir patvirtinkite, kad paleidimo komanda apima --add-host=host.docker.internal:host-gateway. Atvirkščiai galioja, kai „Open WebUI“ neveikia konteineryje: naudokite vietinį adresą.
• Naršyklė negali atidaryti puslapio: „Docker“ atveju patikrinkite 3000 prievadą; „Python“ atveju patikrinkite 8080 prievadą. Pirmojo paleidimo metu palaukite, kol baigsis įterpimo modelio atsisiuntimas. Galite naudoti docker ps patvirtinti, ar konteineris veikia. Jei 3000 prievadas jau naudojamas, pakeiskite prievadą kairėje -ppusėje.
• ID modelių meniu yra ilgesnis nei teikėjo trumpasis pavadinimas: Naudokite visą ID iš meniu, įskaitant visus pasviruosius brūkšnius.
• Visi atjungiami po atnaujinimo: WEBUI_SECRET_KEY pasikeitė. Paleiskite iš naujo naudodami pirmą kartą sugeneruotą slaptą raktą.
• Verify Connection nepavyksta: Pirmiausia rankiniu būdu pridėkite modelio ID po Advanced, tada patvirtinkite jį tikru vieno sakinio pokalbiu. Kai kurios paslaugos nepateikia /models, todėl pokalbiai vis tiek gali veikti, kai patvirtinimas praneša apie klaidą.
• Modelis neegzistuoja: Nukopijuokite ID dar kartą iš dabartinio „OmniProxy“ sąrašo, užuot toliau naudoję pasenusį pavadinimą.

Oficialios nuorodos

Diegimo komandas rasite Open WebUI Quick Start. Ryšio veiksmus rasite OpenAI-compatible connection instructions. Pavyzdžiuose naudojamus modelių ID rasite Claude model overview ir Gemini model list.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · Open WebUI ↗