Installazzjoni ta’ Open WebUI u konfigurazzjoni ta’ OmniProxy

Open WebUI huwa interfaċċa taċ-chat li tista’ tħaddem int stess fuq il-kompjuter jew is-server tiegħek, u jista’ jaħdem kompletament offline. Mhuwiex marbut ma’ fornitur wieħed ta’ mudelli: jista’ jikkonnettja ma’ għodod bħal Ollama li jħaddmu mudelli lokalment, kif ukoll ma’ endpoints kompatibbli mal-format ta’ OpenAI, jiġifieri indirizzi li jipprovdu servizz ta’ mudelli bl-istess format ta’ talbiet. B’hekk tista’ taqleb bejn mudelli lokali u mudelli fil-cloud mill-istess tieqa.

Huwa adattat għal użu fit-tul minn timijiet u organizzazzjonijiet. Kapaċitajiet li jiġu aġġornati aktar malajr jidhru l-ewwel f’Computer, il-prodott li Open WebUI juża biex jittestja funzjonijiet ġodda.

Tħejjija qabel l-installazzjoni

Open WebUI jista’ jintuża fuq macOS, Linux u Windows. Tista’ tinstallah permezz ta’ Docker, Python jew Kubernetes. Docker ipoġġi l-applikazzjoni u l-ambjent tat-tħaddim f’container relattivament iżolat u huwa l-metodu rakkomandat. Jekk m’għandekx Docker, tista’ tuża wkoll il-kmand Python ittestjat hawn taħt. Kubernetes huwa sistema għall-iskjerament u l-ġestjoni ta’ containers; il-passi tiegħu jinsabu fil-Quick Start imsemmi fl-aħħar.

Rakkomandat uffiċjalment

Docker

Kmand docker run wieħed
Iftaħ 3000 fil-browser
Id-data tinsab fil-volum tad-data

Trid biss tiċċettja

Immaġni slim

Id-daqs tat-tniżżil huwa iżgħar
Ibdel it-tag għal :slim
Il-funzjoni taċ-chat tibqa' disponibbli

Mhux kopert hawn

Żewġ għażliet oħra

Installazzjoni manwali ta' Python
Skjerament b'Kubernetes
Ara l-Quick Start uffiċjali

L-ewwel installa Docker, imbagħad ibda bis-saħħa tal-kmand rakkomandat. Jekk se tuża biss iċ-chat permezz ta’ endpoint, tista’ tibdel it-tikketta tal-immaġni għal slim.

Qabel tibda, ħejji dawn li ġejjin:

Docker installat u jaħdem.
String sigriet għall-użu tiegħek biss. Iġġenerah billi tħaddem openssl rand -hex 32, imbagħad daħħlu f’WEBUI_SECRET_KEY. Żomm dan il-valur fiss; jekk jinbidel meta terġa’ tinbena l-container, l-utenti li jkunu diġà illoggjati jiġu skonnettjati.
OmniProxy li jkun qed jaħdem, flimkien mal-ID tal-mudell mil-lista attwali tal-mudelli tiegħu. L-ID tal-mudell huwa l-isem sħiħ użat biex jintgħażel mudell speċifiku.

Installazzjoni u l-ewwel tħaddim

Iftaħ terminal u ħaddem il-kmand mill-Quick Start. L-ewwel ibdel your-secret-key bis-string sigriet li għadek kif iġġenerajt:

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

Il-partijiet ewlenin ta’ dan il-kmand jagħmlu dan li ġej:

-p 3000:8080: jippermettilek tiftaħ l-interfaċċa permezz tal-port 3000 ta’ dan il-kompjuter. Jekk 3000 ikun diġà qed jintuża, ibdel in-numru fuq ix-xellug.
-v open-webui:/app/backend/data: jaħżen iċ-chats, l-utenti u s-settings f’data volume. Data volume huwa post barra l-container fejn id-data tinżamm fit-tul, għalhekk il-kontenut jibqa’ hemm wara aġġornament tal-container. Tneħħix din l-għażla.
--add-host=host.docker.internal:host-gateway: jippermetti lill-container jaċċessa servizzi oħra li jkunu qed jaħdmu fuq dan il-kompjuter.
--restart always: jerġa’ jibda l-container wara li l-kompjuter jerġa’ jinxtegħel.

Wara li jitħaddem il-kmand, iftaħ http://localhost:3000 fil-browser u segwi l-istruzzjonijiet fuq il-paġna biex toħloq l-ewwel kont.

Jekk teħtieġ biss iċ-chat permezz ta’ endpoint, tista’ tibdel it-tikketta tal-immaġni minn :main għal :slim. slim hija immaġni iżgħar li ma tinkludix il-mudelli lokali tad-diskors u tal-embedding fil-container, iżda l-interfaċċa taċ-chat tibqa’ disponibbli. Kompli uża :main jekk teħtieġ dawn il-kapaċitajiet lokali.

Biex taġġorna manwalment, l-ewwel ħaddem docker rm -f open-webui, imbagħad docker pull ghcr.io/open-webui/open-webui:main, u erġa’ ibda bl-istess kmand docker run. Kemm id-data volume kif ukoll WEBUI_SECRET_KEY għandhom jibqgħu l-istess.

Meta ma jkollokx Docker

Il-Quick Start jipprovdi wkoll metodu ta’ installazzjoni b’Python. Fid-2026-10-09, il-kmand li ġej intuża fuq macOS biex jiġi installat Open WebUI v0.11.4 u titlesta konverżazzjoni waħda. Dak il-kompjuter ma kellux Docker Desktop.

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

Wara li jibda, iftaħ http://localhost:8080 fil-browser. Dan huwa l-port użat mill-installazzjoni b’Python, mhux il-port 3000 ta’ Docker.

Fl-ewwel tħaddim jitniżżel mudell ta’ embedding, u dan jista’ jieħu ftit minuti. Il-mudell ta’ embedding jikkonverti t-test f’data adattata għat-tiftix u t-tqabbil. Stenna sakemm tidher il-paġna tal-login qabel tkompli; l-ewwel kont irreġistrat isir amministratur. Il-lingwa tal-interfaċċa ssegwi dik tas-sistema, u f’dan it-test dehret biċ-Ċiniż Simplifikat.

DATA_DIR għandu jindika direttorju li se jinżamm fit-tul biex jaħżen id-data ta’ Open WebUI. Jekk ma jiġix issettjat, id-data tista’ tinħażen f’direttorju temporanju u tintilef wara li tagħlaq il-programm. Jekk WEBUI_SECRET_KEY ma jkunx issettjat, il-programm jikteb .webui_secret_key fid-direttorju attwali. Ibda minn direttorju li biħsiebek iżżomm, jew issettja din il-varjabbli int stess.

Ikseb il-parametri tal-konnessjoni minn OmniProxy

Ikkopja dawn it-tliet valuri mill-OmniProxy tiegħek:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Ikkopja l-ID sħiħ mil-lista attwali tal-mudelli ta’ OmniProxy

Il-URL huwa l-indirizz li Open WebUI juża biex jikkonnettja mal-endpoint, u għandu jispiċċa b’/v1. Iżżidx /chat/completions warajh, għax Open WebUI iżid din il-parti awtomatikament.

L-ID tal-mudell għandu jiġi kkupjat kollu kemm hu mil-lista attwali ta’ OmniProxy. Jekk l-ID jinkludi prefiss tas-sors u slash, żommhom ukoll. Iż-żewġ ismijiet qosra li ġejjin huma biss referenzi mid-dokumentazzjoni tal-fornituri fid-2026-10-09; tużahomx jekk ma jkunux fil-lista attwali:

L-ID ta’ Claude API għal Claude Sonnet 5.5: claude-sonnet-5-5
L-isem tal-endpoint għal Gemini 3.8 Flash: gemini-3.8-flash

Iddaħħalx iċ-ċavetta tal-fornitur f’Open WebUI. Jekk il-gateway ma jivverifikax iċ-ċwievet, tista’ tħalli l-API key vojta; tivvintax ċavetta oħra.

Browser

3000 lokali

Iftaħ il-paġna taċ-chat
L-ewwel lesti r-reġistrazzjoni
Imbagħad iftaħ is-settings

Fil-container

Open WebUI

Tużax localhost
Uża l-isem tal-host minflok
Il-URL għandu jispiċċa b'/v1

Fuq l-istess kompjuter

OmniProxy

Ħalli ċ-ċavetta fil-gateway
Uża l-lista tal-mudelli tal-gateway bħala referenza
Imbagħad ara r-reġistru tas-sejħiet

Meta Open WebUI jkun f’Docker u OmniProxy jkun fuq il-host, tużax localhost tal-container fl-indirizz.

Jekk is-servizz tal-mudelli jkun qed jaħdem fuq il-host filwaqt li Open WebUI ikun qed jaħdem f’container Docker, ibdel localhost fil-URL b’host.docker.internal. Il-host huwa l-kompjuter li fuqu qed jaħdem Docker direttament. Jekk OmniProxy jisma’ biss fuq dan il-kompjuter, il-URL jista’ jkun http://host.docker.internal:port/v1, fejn port għandu jinbidel bil-port li effettivament juża OmniProxy.

Jekk Open WebUI ikun qed jaħdem lokalment permezz tal-kmand Python fit-taqsima preċedenti, u OmniProxy ikun ukoll fuq l-istess kompjuter, uża 127.0.0.1 jew localhost fl-indirizz. F’dan il-każ tużax host.docker.internal.

Daħħal il-konfigurazzjoni tal-għodda

Fl-interfaċċa biċ-Ċiniż Simplifikat ta’ v0.11.4 fid-2026-10-09, l-ismijiet kienu differenti minn Settings > Admin > Connections fl-istruzzjonijiet bl-Ingliż. Segwi l-għażliet li jidhru fl-interfaċċa:

Iftaħ il-sidebar tax-xellug.
Ikklikkja l-menu tal-utent fil-qiegħ.
Ikklikkja Settings.
Fil-grupp tal-amministratur fin-naħa t’isfel, ikklikkja External Connections.
Iftaħ OpenAI API.
Ikklikkja + fuq il-lemin ta’ Manage OpenAI API Connections.
Fit-tieqa Edit Connection li tidher, daħħal il-URL sa /v1. Ħalli t-tip tal-endpoint bħala Chat Completions.
Żomm Authentication Method bħala Key (Bearer). Bearer huwa metodu ta’ awtentikazzjoni li jqiegħed l-API key fit-talba. Meta OmniProxy jagħtik ċavetta, daħħalha f’API Key. Jekk il-gateway ma jivverifikax iċ-ċwievet, ħalli dan il-qasam vojt. Fid-2026-10-09, kemm il-verifika kif ukoll konverżazzjoni waħda rnexxew bil-qasam vojt.
Ikklikkja Verify Connection ħdejn il-URL. Jekk OmniProxy jipprovdi /models, il-lista tal-mudelli tinkiseb minn hemm.
Iftaħ Advanced. Meta Model ID jitħalla vojt, jintużaw il-mudelli kollha rritornati minn /models f’dak l-indirizz. Huwa biss jekk il-verifika tfalli li għandek iddaħħal l-ID sħiħ mil-lista f’Add Model ID, imbagħad tikklikkja Add. Żid kull ID darba waħda biss; l-ispazji fil-bidu u fit-tmiem jitneħħew.
Ikklikkja Save f’din it-tieqa, imbagħad ikklikkja Save fir-rokna t’isfel tal-lemin tal-paġna tal-konnessjonijiet esterni.

Is-salvataġġ tal-konfigurazzjoni waħdu ma jissostitwixxix il-verifika. Verify Connection jitlob /models mingħand is-servizz l-ieħor, jiġifieri l-endpoint li jelenka l-mudelli disponibbli. Xi servizzi m’għandhomx dan l-endpoint, għalhekk il-verifika tista’ turi żball minkejja li ċ-chat xorta jista’ jaħdem. F’dak il-każ, żid l-ID tal-mudell manwalment.

Ivverifika kompitu reali

Erġa’ lura għall-paġna taċ-chat, iftaħ il-menu tal-mudelli ħdejn il-kaxxa tad-dħul u agħżel l-ID sħiħ mil-lista ta’ OmniProxy. Ibgħat sentenza qasira ħafna, pereżempju talba biex iwieġeb b’kelma waħda biss. Ir-risposta għandha effettivament tidher fil-kaxxa taċ-chat.

Fid-2026-10-09, din il-konverżazzjoni tlestiet bl-installazzjoni Python ta’ v0.11.4. Docker jibqa’ l-metodu rakkomandat, iżda dan it-test ma ġiex ripetut f’Docker.

Imbagħad iftaħ ir-rekords tat-talbiet ta’ OmniProxy u kkonferma s-sors u l-ID tal-mudell għal din it-talba. Konfigurazzjoni ssejvjata b’suċċess, jew mudell li jidher biss fil-menu, għadhom mhumiex biżżejjed biex il-proċess jitqies komplut.

Interfaċċa

Il-mudell jista' jintgħażel

Connections ġie ssejvjat
Il-mudell jidher fil-lista
Ibgħat mistoqsija qasira

Tweġiba

Hemm tweġiba fiċ-chat

Mhijiex messaġġ vojt
Mhijiex żball ta' konnessjoni
Erġa' pprova b'mudell ieħor

Reġistru

Jidher fil-gateway

Is-sors huwa din il-konnessjoni
L-ID tal-mudell jaqbel
Ma ddaħħlet ebda ċavetta fil-paġna

Il-konnessjoni titqies li taħdem biss meta dawn it-tliet punti jaqblu.

Żbalji komuni

Użajt localhost jew 127.0.0.1 fil-container: dawn iż-żewġ indirizzi jirreferu għall-container innifsu, mhux għall-host. Ibdel l-indirizz għal host.docker.internal u kkonferma li l-kmand tat-tħaddim fih --add-host=host.docker.internal:host-gateway. Jekk Open WebUI ma jkunx f’container, japplika l-oppost u għandek tuża indirizz lokali.
Il-browser ma jiftaħx: għal Docker iċċekkja l-port 3000, u għal Python iċċekkja l-port 8080. Fl-ewwel tħaddim, stenna sakemm jitlesta t-tniżżil tal-mudell ta’ embedding. Tista’ tuża docker ps biex tikkonferma jekk il-container hux qed jaħdem. Jekk il-port 3000 ikun okkupat, ibdel il-port fuq ix-xellug ta’ -p.
L-ID fil-menu tal-mudelli huwa itwal mill-isem qasir tal-fornitur: uża l-ID sħiħ mill-menu, inklużi s-slashes.
Kulħadd ġie skonnettjat wara aġġornament: WEBUI_SECRET_KEY inbidel. Erġa’ ibda billi tuża l-istess string sigriet iġġenerat l-ewwel darba.
Verify Connection ifalli: l-ewwel żid manwalment l-ID tal-mudell f’Advanced, imbagħad ikkonferma b’messaġġ reali taċ-chat. Xi servizzi m’għandhomx /models, għalhekk iċ-chat xorta jista’ jaħdem meta l-verifika turi żball.
Il-mudell ma jeżistix: erġa’ kkopja l-ID mil-lista attwali ta’ OmniProxy u tkomplix tuża isem skadut.

Referenzi uffiċjali

Għall-kmand tal-installazzjoni, ara Open WebUI Quick Start. Għall-passi tal-konnessjoni, ara l-istruzzjonijiet għall-konnessjoni OpenAI-compatible. Għall-IDs tal-mudelli użati fl-eżempji, ara l-ħarsa ġenerali tal-mudelli Claude u l-lista tal-mudelli Gemini.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · Open WebUI ↗