Open WebUI:n asennus ja OmniProxyn konfigurointi

Open WebUI on itse isännöity chat-käyttöliittymä, joka voidaan asentaa omalle tietokoneelle tai palvelimelle ja joka voi toimia myös täysin offline-tilassa. Se ei ole sidottu yhteen mallipalveluntarjoajaan: se voi yhdistää työkaluihin, kuten Ollamaan, jotka ajavat malleja paikallisesti, sekä OpenAI-yhteensopiviin päätepisteisiin – osoitteisiin, jotka tarjoavat mallipalveluita samalla pyyntömuodolla. Tämän avulla voit vaihtaa paikallisten ja pilvipohjaisten mallien välillä samassa ikkunassa.

Se sopii tiimien ja organisaatioiden pitkäaikaiseen käyttöön. Nopeammin päivityksiä saavat ominaisuudet ilmestyvät ensin Computer-tuotteeseen, jota Open WebUI käyttää uusien ominaisuuksien kokeilemiseen.

Ennen kuin aloitat

Open WebUI on saatavilla macOS-, Linux- ja Windows-järjestelmiin. Voit asentaa sen Dockerin, Pythonin tai Kubernetesin avulla. Docker paketoi sovelluksen ja sen suoritusympäristön suhteellisen eristettyyn konttiin ja on suositeltu menetelmä. Jos Docker ei ole käytettävissä, voit käyttää myös alla olevaa testattua Python-komentoa. Kubernetes on järjestelmä konttien käyttöönottoon ja hallintaan; katso tämän oppaan lopussa linkitetty Quick Start vastaavia vaiheita varten.

Virallisesti suositeltu

Docker

• Yksi docker run -komento
• Avaa 3000 selaimessa
• Data tallennetaan taltioon

Haluat vain chattailla

slim-kuva

• Pienempi latauskoko
• Vaihda tagiksi :slim
• Chat-toiminnallisuus pysyy käytettävissä

Ei käsitellä tässä

Kaksi muuta vaihtoehtoa

• Manuaalinen Python-asennus
• Kubernetes-käyttöönotto
• Katso virallinen Quick Start

Valmistele ennen aloittamista seuraavat:

• Docker asennettuna ja käynnissä.
• Vain sinun käyttämäsi salainen merkkijono. Suorita openssl rand -hex 32 luodaksesi sellaisen, syötä se sitten muodossa WEBUI_SECRET_KEY. Tallenna tämä arvo pysyvästi. Jos muutat sitä konttia uudelleenrakennettaessa, jo kirjautuneet käyttäjät kirjataan ulos.
• Käynnissä oleva OmniProxy-instanssi ja mallin tunniste sen nykyisestä malliluettelosta. Mallin tunniste on täydellinen nimi, jota käytetään tietyn mallin valitsemiseen.

Asennus ja ensimmäinen käynnistys

Avaa pääte ja suorita Quick Startin komento. Korvaa ensin your-secret-key juuri luomallasi salaisuudella:

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

Tämän komennon seuraavat osat palvelevat eri tarkoituksia:

• -p 3000:8080: Antaa sinun avata käyttöliittymän portin 3000 kautta tällä tietokoneella. Jos portti 3000 on jo käytössä, vaihda vasemmalla olevaa numeroa.
• -v open-webui:/app/backend/data: Tallentaa chatit, käyttäjät ja asetukset datataltioon. Datataltio on kontin ulkopuolella oleva sijainti, jossa data säilyy pitkäaikaisesti, joten sen sisältö pysyy kontin päivittämisen jälkeen. Älä poista tätä valintaa.
• --add-host=host.docker.internal:host-gateway: Sallii kontin käyttää muita tällä tietokoneella käynnissä olevia palveluita.
• --restart always: Käynnistää kontin uudelleen tietokoneen uudelleenkäynnistyksen jälkeen.

Kun komento on valmis, avaa http://localhost:3000 selaimessa ja seuraa näytön ohjeita ensimmäisen tilin luomiseksi.

Jos tarvitset vain chattausta API:n kautta, voit vaihtaa kuvan tagin muodosta :main muotoon :slim. slim on pienempi kuva, joka ei sisällä paikallisia puhe- ja upotusmalleja kontin sisällä, mutta chat-käyttöliittymä pysyy käytettävissä. Jatka :main käyttöä, jos tarvitset kyseisiä paikallisia ominaisuuksia.

Manuaalisia päivityksiä varten suorita ensin docker rm -f open-webui, suorita sitten docker pull ghcr.io/open-webui/open-webui:main ja käynnistä se uudelleen samalla docker run -komennolla. Pidä sekä datataltio että WEBUI_SECRET_KEY muuttumattomina.

Jos Docker ei ole käytettävissä

Quick Start tarjoaa myös Python-asennustavan. 9.10.2026 seuraavaa komentoa käytettiin macOS:ssä Open WebUI v0.11.4:n asentamiseen ja yhden keskustelun suorittamiseen. Docker Desktopia ei ollut asennettu kyseiselle tietokoneelle tuolloin.

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

Avaa käynnistyksen jälkeen http://localhost:8080 selaimessa. Tämä on Python-asennuksen käyttämä portti, ei Dockerin portti 3000.

Upotusmalli (embedding model) ladataan ensimmäisen käynnistyksen aikana, mikä voi kestää useita minuutteja. Upotusmalli muuntaa tekstin dataksi, jota on helpompi etsiä ja vastata. Odota kirjautumissivun ilmestymistä ennen jatkamista. Ensimmäisestä rekisteröidystä tilistä tulee ylläpitäjä. Käyttöliittymän kieli seuraa järjestelmän kieltä; yksinkertaistettu kiina näkyi tämän testin aikana.

DATA_DIR on osoitettava hakemistoon, joka säilytetään pitkäaikaisesti ja jota käytetään Open WebUI -datan tallentamiseen. Jos sitä ei ole asetettu, data voidaan tallentaa väliaikaiseen hakemistoon ja menettää sammutuksen jälkeen. Jos WEBUI_SECRET_KEY ei ole asetettu, ohjelma kirjoittaa .webui_secret_key nykyiseen hakemistoon. Käynnistä se hakemistosta, jonka aiot säilyttää, tai aseta tämä muuttuja itse.

Hae yhteystiedot OmniProxysta

Kopioi seuraavat kolme kohdetta omasta OmniProxy-instanssistasi:

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

URL-osoite on osoite, jota Open WebUI käyttää päätepisteeseen yhdistämiseen, ja sen on päätyttävä /v1. Älä lisää /chat/completions sen jälkeen; Open WebUI lisää kyseisen osan automaattisesti.

Kopioi koko mallin tunniste OmniProxyn nykyisestä luettelosta. Jos tunniste sisältää lähde-etuliitteen ja vinoviivan, säilytä myös ne. Seuraavat kaksi lyhyttä nimeä ovat vain viitteitä palveluntarjoajan dokumentaatiosta 9.10.2026 alkaen. Älä käytä niitä, jos ne eivät ole nykyisessä luettelossa:

• Claude API-tunniste Claude Sonnet 5.5:lle: claude-sonnet-5-5
• API-nimi Gemini 3.8 Flashille: gemini-3.8-flash

Älä syötä palveluntarjoajan avainta Open WebUI:hin. Jos yhdyskäytävä ei validoi avaimia, jätä API-avain tyhjäksi sen sijaan, että keksit toisen avaimen.

Selain

Paikallinen portti 3000

• Avaa chat-sivu
• Suorita rekisteröinti ensin
• Avaa sitten asetukset

Kontin sisällä

Open WebUI

• Älä käytä localhostia
• Käytä sen sijaan isäntäkoneen nimeä
• URL päättyy /v1

Sama tietokone

OmniProxy

• Pidä avain yhdyskäytävässä
• Käytä yhdyskäytävän malliluetteloa
• Tarkista sitten pyyntölokit

Jos mallipalvelu toimii isäntäkoneessa, kun taas Open WebUI toimii Docker-kontissa, korvaa localhost URL-osoitteessa arvolla host.docker.internal. Isäntä on tietokone, joka käyttää Dockeria suoraan. Jos OmniProxy kuuntelee vain tällä tietokoneella, URL-osoite voidaan kirjoittaa muodossa http://host.docker.internal:port/v1, korvaten port OmniProxyn todellisuudessa käyttämällä portilla.

Jos Open WebUI toimii paikallisesti edellisen osion Python-komennon kautta ja OmniProxy toimii myös paikallisesti, käytä 127.0.0.1 tai localhost osoitteessa. Älä käytä host.docker.internal tässä tapauksessa.

Syötä konfiguraatio

9.10.2026 testatussa v0.11.4:n yksinkertaistetun kiinan käyttöliittymässä nimet erosivat englanninkielisten ohjeiden Settings > Admin > Connections -kohdista. Seuraa testatussa käyttöliittymässä näkyviä vaihtoehtoja, jotka on käännetty alla:

1. Laajenna vasen sivupalkki.
2. Napsauta alareunassa olevaa käyttäjävalikkoa.
3. Napsauta Settings.
4. Napsauta alla olevassa ylläpitäjäosiossa External Connections.
5. Avaa OpenAI API.
6. Napsauta + kohdan Manage OpenAI API Connections oikealla puolella.
7. Syötä Edit Connection -valintaikkunassa URL-osoite, joka päättyy /v1. Pidä API-tyyppinä Chat Completions.
8. Pidä Authentication Method -asetuksena Key (Bearer). Bearer-todennus asettaa API-avaimen pyyntöön henkilöllisyyden todentamista varten. Jos OmniProxy antoi sinulle avaimen, syötä se kohtaan API Key. Jos yhdyskäytävä ei validoi avaimia, jätä tämä kenttä tyhjäksi. 9.10.2026 sekä validointi että yksi keskustelu onnistuivat kentän ollessa tyhjä.
9. Napsauta Verify Connection URL-osoitteen vieressä. Jos OmniProxy tarjoaa /models, malliluettelo haetaan tässä.
10. Avaa Advanced. Jos Model ID jätetään tyhjäksi, kaikkia osoitteessa /models palautettuja malleja käytetään. Vain jos validointi epäonnistuu, syötä täydellinen tunniste luettelosta kohtaan Add Model ID ja napsauta sitten Add. Lisää jokainen tunniste vain kerran; johtavat ja päättävät välilyönnit poistetaan.
11. Napsauta Save tässä ikkunassa ja napsauta sitten Save External Connections -sivun oikeassa alakulmassa.

Konfiguraation tallentaminen yksinään ei korvaa validointia. Verify Connection pyytää toisen palvelun /models päätepistettä, joka luettelee käytettävissä olevat mallit. Jotkin palvelut eivät tarjoa tätä päätepistettä, joten validointi voi raportoida virheen, vaikka chat voi silti toimia. Lisää siinä tapauksessa mallin tunniste manuaalisesti.

Vahvista todellisella tehtävällä

Palaa chat-sivulle, avaa syöttökentän vieressä oleva mallivalikko ja valitse täydellinen tunniste OmniProxy-luettelosta. Lähetä hyvin lyhyt viesti, kuten pyyntö vastata vain yhdellä sanalla. Vastauksen on todellisuudessa ilmestyttävä chat-ruutuun.

9.10.2026 tämä keskustelu suoritettiin v0.11.4:n Python-asennuksella. Docker on edelleen suositeltu menetelmä, mutta testiä ei toistettu Dockerissa.

Avaa seuraavaksi OmniProxyn pyyntölokit ja vahvista tämän pyynnön lähde ja mallin tunniste. Pelkkä onnistunut tallennus tai mallin näkyminen valikossa ei tarkoita suoritusta.

Käyttöliittymä

Malli voidaan valita

• Yhteydet on tallennettu
• Malli ilmestyy luetteloon
• Lähetä lyhyt kysymys

Vastaus

Chat-ruutu näyttää vastauksen

• Se ei ole tyhjä viesti
• Se ei ole yhteysvirhe
• Yritä uudelleen toisella mallilla

Lokit

Näkyvissä yhdyskäytävässä

• Lähde on tämä yhteys
• Mallin tunniste täsmää
• Sivulle ei syötetty avainta

Yleiset virheet

• localhost tai 127.0.0.1 käytettiin kontin sisällä: Nämä osoitteet osoittavat konttiin itseensä, eivät isäntään. Muuta osoite muotoon host.docker.internal ja varmista, että käynnistyskomento sisältää --add-host=host.docker.internal:host-gateway. Käänteinen pätee, kun Open WebUI ei toimi kontissa: käytä sen sijaan paikallista osoitetta.
• Selain ei voi avata sivua: Tarkista Dockerin portti 3000; Pythonin kohdalla tarkista portti 8080. Odota ensimmäisen käynnistyksen aikana, että upotusmallin lataus valmistuu. Voit käyttää docker ps vahvistaaksesi, onko kontti käynnissä. Jos portti 3000 on jo käytössä, vaihda porttia -pvasemmalla puolella.
• Mallivalikon tunniste on pidempi kuin palveluntarjoajan lyhyt nimi: Käytä valikon täydellistä tunnistetta, mukaan lukien mahdolliset vinoviivat.
• Kaikki kirjataan ulos päivityksen jälkeen: WEBUI_SECRET_KEY muuttui. Käynnistä uudelleen käyttämällä ensimmäisellä kerralla luotua salaisuutta.
• Verify Connection epäonnistuu: Lisää ensin mallin tunniste manuaalisesti kohdassa Advanced, vahvista se sitten todellisella yhden lauseen chatilla. Jotkin palvelut eivät tarjoa /models, joten chat voi silti toimia, kun validointi raportoi virheen.
• Mallia ei ole olemassa: Kopioi tunniste uudelleen OmniProxyn nykyisestä luettelosta sen sijaan, että jatkaisit vanhentuneen nimen käyttöä.

Viralliset viitteet

Katso asennuskomennot kohdasta Open WebUI Quick Start. Katso yhteysvaiheet kohdasta OpenAI-compatible connection instructions. Katso esimerkeissä käytetyt mallitunnisteet kohdista Claude model overview ja Gemini model list.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · Open WebUI ↗