Open WebUI telepítése és OmniProxy konfigurálása

Az Open WebUI egy saját üzemeltetésű csevegőfelület, amely telepíthető a saját számítógépére vagy szerverére, és teljesen offline is futtatható. Nem kötődik egyetlen modellszolgáltatóhoz sem: csatlakozhat olyan eszközökhöz, mint az Ollama, amely helyben futtat modelleket, valamint OpenAI-kompatibilis végpontokhoz—olyan címekhez, amelyek ugyanazt a kérésformátumot használó modellszolgáltatásokat biztosítanak. Ez lehetővé teszi, hogy ugyanabban az ablakban váltson a helyi és a felhőalapú modellek között.

Csapatok és szervezetek számára hosszú távú használatra alkalmas. A gyorsabb frissítéseket kapó képességek először a Computerben jelennek meg, az Open WebUI által az új funkciók kipróbálására használt termékben.

Mielőtt elkezdené

Az Open WebUI elérhető macOS, Linux és Windows rendszereken. Telepítheti Docker, Python vagy Kubernetes használatával. A Docker viszonylag elszigetelt konténerbe csomagolja az alkalmazást és annak futtatókörnyezetét, és ez az ajánlott módszer. Ha a Docker nem érhető el, használhatja az alábbi tesztelt Python parancsot is. A Kubernetes egy rendszer a konténerek telepítésére és kezelésére; a megfelelő lépésekért lásd az útmutató végén található Gyors üzembe helyezést.

Hivatalosan ajánlott

Docker

• Egy docker run parancs
• Nyissa meg a 3000-et a böngészőben
• Az adatok a kötetben tárolódnak

Csak csevegni szeretne

slim kép

• Kisebb letöltési méret
• Változtassa a címkét :slim-re
• A csevegési funkció továbbra is elérhető

Itt nem tárgyaltuk

Két másik lehetőség

• Kézi Python telepítés
• Kubernetes telepítés
• Lásd a hivatalos Gyors üzembe helyezést

Kezdés előtt készítse elő a következőket:

• Docker telepítve és fut.
• Egy csak Ön által használt titkos karakterlánc. Futtassa a openssl rand -hex 32-t egy generálásához, majd adja meg WEBUI_SECRET_KEY-ként. Mentse el ezt az értéket véglegesen. Ha a konténer újraépítésekor megváltoztatja, a már bejelentkezett felhasználók kijelentkeznek.
• Egy futó OmniProxy példány és egy modellazonosító az aktuális modelllistájából. A modellazonosító az a teljes név, amelyet egy adott modell kiválasztására használnak.

Telepítés és első indítás

Nyisson meg egy terminált, és futtassa a parancsot a Gyors üzembe helyezésből. Először cserélje le a your-secret-key-t a most generált titokra:

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

Ennek a parancsnak a következő részei különböző célokat szolgálnak:

• -p 3000:8080: Lehetővé teszi az interfész megnyitását a 3000-es porton ezen a számítógépen. Ha a 3000-es port már használatban van, változtassa meg a bal oldali számot.
• -v open-webui:/app/backend/data: Csevegéseket, felhasználókat és beállításokat tárol egy adatkötetben. Az adatkötet a konténeren kívüli hely, ahol az adatok hosszú távon megmaradnak, így a tartalma a konténer frissítése után is megmarad. Ne távolítsa el ezt az opciót.
• --add-host=host.docker.internal:host-gateway: Lehetővé teszi a konténer számára, hogy hozzáférjen a számítógépen futó egyéb szolgáltatásokhoz.
• --restart always: A számítógép újraindítása után újra elindítja a konténert.

Miután a parancs befejeződött, nyissa meg a http://localhost:3000-t egy böngészőben, és kövesse a képernyőn megjelenő utasításokat az első fiók létrehozásához.

Ha csak API-n keresztül kell csevegnie, megváltoztathatja a kép címkéjét :main-ről :slim-re. A slim egy kisebb kép, amely nem tartalmazza a helyi beszéd- és beágyazási modelleket a konténeren belül, de a csevegőfelület továbbra is elérhető. Továbbra is használja a :main-t, ha szüksége van ezekre a helyi képességekre.

Kézi frissítéshez először futtassa a docker rm -f open-webui-t, majd futtassa a docker pull ghcr.io/open-webui/open-webui:main-t, és indítsa újra ugyanazzal a docker run paranccsal. Tartsa változatlanul az adatkötetet és a WEBUI_SECRET_KEY-et.

Ha a Docker nem érhető el

A Gyors üzembe helyezés Python telepítési módszert is biztosít. 2026-10-09-én a következő parancsot használták macOS-en az Open WebUI v0.11.4 telepítéséhez és egy beszélgetés befejezéséhez. A Docker Desktop akkor nem volt telepítve azon a számítógépen.

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

Indítás után nyissa meg a http://localhost:8080-t egy böngészőben. Ez a Python telepítés által használt port, nem a Docker 3000-es portja.

Az első indítás során egy beágyazási modell töltődik le, ami több percig is eltarthat. A beágyazási modell a szöveget olyan adatokká alakítja, amelyeket könnyebb keresni és párosítani. Várja meg, amíg a bejelentkezési oldal megjelenik, mielőtt folytatná. Az első regisztrált fiók lesz a rendszergazda. Az interfész nyelve követi a rendszer nyelvét; a teszt során egyszerűsített kínai jelent meg.

A DATA_DIR-nek egy olyan könyvtárra kell mutatnia, amely hosszú távon megmarad, és az Open WebUI adatok tárolására szolgál. Ha nincs beállítva, az adatok ideiglenes könyvtárba kerülhetnek, és leállítás után elveszhetnek. Ha a WEBUI_SECRET_KEY nincs beállítva, a program a .webui_secret_key-t írja az aktuális könyvtárba. Indítsa el egy olyan könyvtárból, amelyet meg kíván tartani, vagy állítsa be ezt a változót saját maga.

Csatlakozási adatok beszerzése az OmniProxytól

Másolja ki a következő három elemet a saját OmniProxy példányából:

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

Az URL az a cím, amelyet az Open WebUI a végponthoz való csatlakozáshoz használ, és a /v1-vel kell végződnie. Ne adjon hozzá /chat/completions-et utána; az Open WebUI automatikusan hozzáfűzi ezt a részt.

Másolja ki a teljes modellazonosítót az OmniProxy aktuális listájából. Ha az azonosító forráselőtagot és perjelt tartalmaz, őrizze meg azokat is. A következő két rövid név csak a szolgáltatói dokumentációból származó hivatkozás 2026-10-09-től. Ne használja őket, ha nem szerepelnek az aktuális listában:

• Claude API azonosító a Claude Sonnet 5.5-höz: claude-sonnet-5-5
• API név a Gemini 3.8 Flash-hez: gemini-3.8-flash

Ne adjon meg szolgáltatói kulcsot az Open WebUI-ban. Ha a gateway nem érvényesíti a kulcsokat, hagyja üresen az API-kulcsot, ahelyett, hogy másik kulcsot találna ki.

Böngésző

Helyi 3000-es port

• Nyissa meg a csevegőoldalt
• Először fejezze be a regisztrációt
• Ezután nyissa meg a beállításokat

A konténeren belül

Open WebUI

• Ne használja a localhostot
• Használja helyette a gazdagép nevét
• Az URL /v1-re végződik

Ugyanaz a számítógép

OmniProxy

• Tartsa a kulcsot a gateway-ben
• Használja a gateway modelllistáját
• Ezután tekintse át a kérésnaplókat

Ha a modellszolgáltatás a gazdagépen fut, miközben az Open WebUI Docker-konténerben fut, cserélje le a localhost-t az URL-ben host.docker.internal-re. A gazdagép az a számítógép, amely közvetlenül futtatja a Dockert. Ha az OmniProxy csak ezen a számítógépen figyel, az URL írható http://host.docker.internal:port/v1-ként, a port-et az OmniProxy által ténylegesen használt portra cserélve.

Ha az Open WebUI helyben fut az előző szakaszban leírt Python parancson keresztül, és az OmniProxy is helyben fut, használja a 127.0.0.1-t vagy localhost-at a címben. Ebben az esetben ne használja a host.docker.internal-t.

A konfiguráció megadása

A 2026-10-09-én tesztelt v0.11.4 egyszerűsített kínai felületén a nevek eltértek az angol utasításokban szereplő Beállítások > Rendszergazda > Csatlakozások (Settings > Admin > Connections) menüponttól. Kövesse a tesztelt felületen megjelenő opciókat, amelyeket alább lefordítottunk:

1. Bontsa ki a bal oldali oldalsávot.
2. Kattintson a felhasználói menüre alul.
3. Kattintson a Beállítások (Settings) elemre.
4. Az alábbi rendszergazdai szakaszban kattintson a Külső csatlakozások (External Connections) elemre.
5. Nyissa meg az OpenAI API-t.
6. Kattintson a + jelre az OpenAI API-csatlakozások kezelése (Manage OpenAI API Connections) jobb oldalán.
7. A Csatlakozás szerkesztése (Edit Connection) párbeszédpanelen adja meg a /v1-re végződő URL-t. Tartsa az API-típust Chat Completions-re állítva.
8. Tartsa a Hitelesítési módszer (Authentication Method) beállítást Kulcs (Bearer) (Key (Bearer)) értéken. A Bearer hitelesítés az API-kulcsot a kérésbe helyezi az azonosság ellenőrzéséhez. Ha az OmniProxy adott Önnek kulcsot, adja meg az API-kulcs (API Key) alatt. Ha a gateway nem érvényesíti a kulcsokat, hagyja üresen ezt a mezőt. 2026-10-09-én mind az érvényesítés, mind egy beszélgetés sikeres volt üresen hagyott mezővel.
9. Kattintson az URL melletti Csatlakozás ellenőrzése (Verify Connection) elemre. Ha az OmniProxy biztosítja a /models-t, a modelllista itt kerül lekérésre.
10. Nyissa meg a Speciális (Advanced) részt. Ha a Modellazonosító (Model ID) üresen marad, az adott címen a /models által visszaadott összes modell használatban lesz. Csak akkor, ha az érvényesítés sikertelen, adja meg a listából származó teljes azonosítót a Modellazonosító hozzáadása (Add Model ID) alatt, majd kattintson a Hozzáadás (Add) gombra. Minden azonosítót csak egyszer adjon hozzá; a vezető és záró szóközök eltávolításra kerülnek.
11. Kattintson a Mentés (Save) gombra ebben az ablakban, majd kattintson a Mentés (Save) gombra a Külső csatlakozások oldal jobb alsó sarkában.

A konfiguráció mentése önmagában nem helyettesíti az érvényesítést. A Csatlakozás ellenőrzése (Verify Connection) lekéri a másik szolgáltatás /models végpontját, amely felsorolja az elérhető modelleket. Egyes szolgáltatások nem biztosítják ezt a végpontot, így az érvényesítés hibát jelezhet, annak ellenére, hogy a csevegés továbbra is működhet. Ebben az esetben adja hozzá a modellazonosítót manuálisan.

Valódi feladat ellenőrzése

Térjen vissza a csevegőoldalra, nyissa meg a modellmenüt a beviteli mező mellett, és válassza ki a teljes azonosítót az OmniProxy listából. Küldjön egy nagyon rövid üzenetet, például kérje meg, hogy csak egy szóval válaszoljon. A válasznak ténylegesen meg kell jelennie a csevegődobozban.

2026-10-09-én ezt a beszélgetést a v0.11.4 Python telepítésével fejezték be. A Docker továbbra is az ajánlott módszer, de a tesztet nem ismételték meg Dockerben.

Ezután nyissa meg az OmniProxy kérésnaplóit, és erősítse meg a kérés forrását és modellazonosítóját. Csak a sikeres mentés látása, vagy csak a modell látása a menüben nem számít befejezésnek.

Interfész

A modell kiválasztható

• A csatlakozások mentve lettek
• A modell megjelenik a listában
• Küldjön egy rövid kérdést

Válasz

A csevegődoboz mutat egy választ

• Ez nem egy üres üzenet
• Ez nem egy csatlakozási hiba
• Próbálja újra egy másik modellel

Naplók

Látható a gateway-ben

• A forrás ez a csatlakozás
• A modellazonosító egyezik
• Nem lett kulcs megadva az oldalon

Gyakori hibák

• A localhost vagy 127.0.0.1 a konténeren belül lett használva: Ezek a címek magára a konténerre mutatnak, nem a gazdagépre. Változtassa meg a címet host.docker.internal-re, és győződjön meg arról, hogy az indítási parancs tartalmazza a --add-host=host.docker.internal:host-gateway-t. Az ellenkezője érvényes, amikor az Open WebUI nem konténerben fut: használjon helyi címet helyette.
• A böngésző nem tudja megnyitni az oldalt: Docker esetén ellenőrizze a 3000-es portot; Python esetén ellenőrizze a 8080-as portot. Az első indítás során várja meg, amíg a beágyazási modell letöltése befejeződik. Használhatja a docker ps-t annak megerősítésére, hogy a konténer fut-e. Ha a 3000-es port már használatban van, változtassa meg a portot a -p bal oldalán.
• A modellmenüben lévő azonosító hosszabb, mint a szolgáltató rövid neve: Használja a menüből származó teljes azonosítót, beleértve a perjelt is.
• Mindenki kijelentkezik frissítés után: A WEBUI_SECRET_KEY megváltozott. Indítsa újra az első alkalommal generált titokkal.
• A Csatlakozás ellenőrzése (Verify Connection) sikertelen: Először manuálisan adja hozzá a modellazonosítót a Speciális (Advanced) alatt, majd erősítse meg egy valódi, egy mondatos csevegéssel. Egyes szolgáltatások nem biztosítják a /models-t, így a csevegés akkor is működhet, ha az érvényesítés hibát jelez.
• A modell nem létezik: Másolja ki újra az azonosítót az OmniProxy aktuális listájából, ahelyett, hogy továbbra is elavult nevet használna.

Hivatalos hivatkozások

A telepítési parancsokért lásd az Open WebUI Gyors üzembe helyezést. A csatlakozási lépésekért lásd az OpenAI-kompatibilis csatlakozási utasításokat. A példákban használt modellazonosítókért lásd a Claude modell áttekintést és a Gemini modell listát.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · Open WebUI ↗