Usakinishaji wa Open WebUI na Usanidi wa OmniProxy

Open WebUI ni kiolesura cha gumzo kinachojiendesha ambacho kinaweza kusakinishwa kwenye kompyuta yako mwenyewe au seva na kinaweza pia kufanya kazi nje ya mtandao kabisa. Hakijafungwa kwa mtoa huduma mmoja wa muundo: kinaweza kuunganisha kwenye zana kama vile Ollama zinazoendesha miundo ndani ya mfumo, pamoja na mwisho unaooana na OpenAI—anwani zinazotoa huduma za muundo kwa kutumia umbizo sawa la ombi. Hii inakuwezesha kubadili kati ya miundo ya ndani na ya wingu katika dirisha moja.

Inafaa kwa matumizi ya muda mrefu na timu na mashirika. Uwezo unaopokea masasisho ya haraka huonekana kwanza kwenye Computer, bidhaa ambayo Open WebUI hutumia kujaribu vipengele vipya.

Kabla Hujaanza

Open WebUI inapatikana kwenye macOS, Linux, na Windows. Unaweza kuisakinisha kwa kutumia Docker, Python, au Kubernetes. Docker hupakia programu na mazingira yake ya utekelezaji kwenye kontena lililotengwa kiasi na ndiyo njia inayopendekezwa. Ikiwa Docker haipatikani, unaweza pia kutumia amri ya Python iliyojaribiwa hapa chini. Kubernetes ni mfumo wa kutuma na kudhibiti kontena; angalia Quick Start iliyounganishwa mwishoni mwa mwongozo huu kwa hatua husika.

Inapendekezwa rasmi

Docker

• Amri moja ya docker run
• Fungua 3000 kwenye kivinjari
• Data imehifadhiwa kwenye volume

Nataka tu kuzungumza

slim image

• Ukubwa mdogo wa upakuaji
• Badilisha tag kuwa :slim
• Utendaji wa gumzo unabaki kupatikana

Haijashughulikiwa hapa

Chaguo mbili nyingine

• Usakinishaji wa mwongozo wa Python
• Utumaji wa Kubernetes
• Angalia Quick Start rasmi

Kabla ya kuanza, tayarisha yafuatayo:

• Docker imesakinishwa na inafanya kazi.
• Kamba ya siri inayotumiwa na wewe pekee. Endesha openssl rand -hex 32 ili kuzalisha moja, kisha uiingize kama WEBUI_SECRET_KEY. Hifadhi thamani hii kabisa. Ikiwa utaibadilisha wakati wa kujenga upya kontena, watumiaji ambao tayari wameingia wataondolewa.
• Instansi ya OmniProxy inayofanya kazi na kitambulisho cha muundo kutoka kwa orodha yake ya sasa ya miundo. Kitambulisho cha muundo ni jina kamili linalotumiwa kuchagua muundo mahususi.

Sakinisha na Uzindue kwa Mara ya Kwanza

Fungua terminal na uendeshe amri kutoka kwa Quick Start. Kwanza badilisha your-secret-key na siri uliyozalisha hivi punde:

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

Sehemu zifuatazo za amri hii hutumikia madhumuni tofauti:

• -p 3000:8080: Inakuwezesha kufungua kiolesura kupitia bandari 3000 kwenye kompyuta hii. Ikiwa bandari 3000 tayari inatumika, badilisha nambari iliyo upande wa kushoto.
• -v open-webui:/app/backend/data: Huhifadhi gumzo, watumiaji, na mipangilio kwenye data volume. Data volume ni eneo nje ya kontena ambapo data huhifadhiwa kwa muda mrefu, kwa hivyo yaliyomo hubaki baada ya kontena kusasishwa. Usiondoe chaguo hili.
• --add-host=host.docker.internal:host-gateway: Inaruhusu kontena kufikia huduma nyingine zinazofanya kazi kwenye kompyuta hii.
• --restart always: Inaanza kontena tena baada ya kompyuta kuwaka upya.

Baada ya amri kumalizika, fungua http://localhost:3000 kwenye kivinjari na ufuate maagizo kwenye skrini ili kuunda akaunti ya kwanza.

Ikiwa unahitaji tu kuzungumza kupitia API, unaweza kubadilisha tag ya picha kutoka :main hadi :slim. slim ni picha ndogo ambayo haijumuishi miundo ya ndani ya usemi na embedding ndani ya kontena, lakini kiolesura cha gumzo kinabaki kupatikana. Endelea kutumia :main ikiwa unahitaji uwezo huo wa ndani.

Kwa masasisho ya mwongozo, kwanza endesha docker rm -f open-webui, kisha endesha docker pull ghcr.io/open-webui/open-webui:main, na uianzishe upya na amri hiyo hiyo ya docker run. Weka data volume na WEBUI_SECRET_KEY bila kubadilika.

Ikiwa Docker Haipatikani

Quick Start pia inatoa njia ya usakinishaji wa Python. Mnamo 2026-10-09, amri ifuatayo ilitumiwa kwenye macOS kusakinisha Open WebUI v0.11.4 na kukamilisha mazungumzo moja. Docker Desktop haikusakinishwa kwenye kompyuta hiyo wakati huo.

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

Baada ya kuanza, fungua http://localhost:8080 kwenye kivinjari. Hii ndiyo bandari inayotumiwa na usakinishaji wa Python, si bandari 3000 ya Docker.

Muundo wa embedding hupakuliwa wakati wa kuanza kwa kwanza, ambayo inaweza kuchukua dakika kadhaa. Muundo wa embedding hubadilisha maandishi kuwa data ambayo ni rahisi kutafuta na kulinganisha. Subiri ukurasa wa kuingia uonekane kabla ya kuendelea. Akaunti ya kwanza iliyosajiliwa inakuwa msimamizi. Lugha ya kiolesura hufuata lugha ya mfumo; Kichina Kilichorahisishwa kilionyeshwa wakati wa jaribio hili.

DATA_DIR lazima ielekeze kwenye saraka ambayo itahifadhiwa kwa muda mrefu na kutumika kuhifadhi data ya Open WebUI. Ikiwa haijawekwa, data inaweza kuhifadhiwa kwenye saraka ya muda na kupotea baada ya kuzima. Ikiwa WEBUI_SECRET_KEY haijawekwa, programu huandika .webui_secret_key kwenye saraka ya sasa. Ianzishe kutoka kwa saraka unayokusudia kuhifadhi, au weka kigeu hiki mwenyewe.

Pata Maelezo ya Muunganisho kutoka OmniProxy

Nakili vitu vitatu vifuatavyo kutoka kwa mfano wako wa OmniProxy:

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

URL ni anwani ambayo Open WebUI hutumia kuunganisha kwenye mwisho na lazima iishe na /v1. Usiongeze /chat/completions baada yake; Open WebUI huongeza sehemu hiyo kiotomatiki.

Nakili kitambulisho kamili cha muundo kutoka kwa orodha ya sasa ya OmniProxy. Ikiwa kitambulisho kinajumuisha kiambishi awali cha chanzo na mkwaju, hifadhi hizo pia. Majina mawili mafupi yafuatayo ni marejeleo tu kutoka kwa nyaraka za mtoa huduma kufikia 2026-10-09. Usiyatumie ikiwa hayapo kwenye orodha ya sasa:

• Claude API ID kwa Claude Sonnet 5.5: claude-sonnet-5-5
• Jina la API kwa Gemini 3.8 Flash: gemini-3.8-flash

Usiingize ufunguo wa mtoa huduma katika Open WebUI. Ikiwa gateway haithibitishi funguo, acha ufunguo wa API wazi badala ya kubuni ufunguo mwingine.

Kivinjari

Bandari ya ndani 3000

• Fungua ukurasa wa gumzo
• Kamilisha usajili kwanza
• Kisha fungua mipangilio

Ndani ya kontena

Open WebUI

• Usitumie localhost
• Tumia jina la mashine mwenyeji badala yake
• URL inaishia na /v1

Kompyuta hiyo hiyo

OmniProxy

• Weka ufunguo kwenye gateway
• Tumia orodha ya miundo ya gateway
• Kisha kagua kumbukumbu za ombi

Ikiwa huduma ya muundo inafanya kazi kwenye mwenyeji wakati Open WebUI inafanya kazi kwenye kontena la Docker, badilisha localhost kwenye URL na host.docker.internal. Mwenyeji ni kompyuta inayoendesha Docker moja kwa moja. Ikiwa OmniProxy inasikiliza tu kwenye kompyuta hii, URL inaweza kuandikwa kama http://host.docker.internal:port/v1, ikibadilisha port na bandari ambayo OmniProxy inatumia kweli.

Ikiwa Open WebUI inafanya kazi ndani ya mfumo kupitia amri ya Python katika sehemu iliyotangulia na OmniProxy pia inafanya kazi ndani ya mfumo, tumia 127.0.0.1 au localhost kwenye anwani. Usitumie host.docker.internal katika kesi hii.

Ingiza Usanidi

Katika kiolesura cha Kichina Kilichorahisishwa cha v0.11.4 kilichojaribiwa mnamo 2026-10-09, majina yalitofautiana na Settings > Admin > Connections katika maagizo ya Kiingereza. Fuata chaguo zilizoonyeshwa kwenye kiolesura kilichojaribiwa, kilichotafsiriwa hapa chini:

1. Panua upau wa pembeni wa kushoto.
2. Bofya menyu ya mtumiaji chini.
3. Bofya Settings.
4. Katika sehemu ya msimamizi hapa chini, bofya External Connections.
5. Fungua OpenAI API.
6. Bofya + upande wa kulia wa Manage OpenAI API Connections.
7. Katika kisanduku cha Edit Connection, ingiza URL inayoishia na /v1. Weka aina ya API kuwa Chat Completions.
8. Weka Authentication Method kuwa Key (Bearer). Uthibitishaji wa Bearer huweka ufunguo wa API kwenye ombi kwa uthibitishaji wa utambulisho. Ikiwa OmniProxy ilikupa ufunguo, ingiza chini ya API Key. Ikiwa gateway haithibitishi funguo, acha sehemu hii wazi. Mnamo 2026-10-09, uthibitishaji na mazungumzo moja vilifanikiwa na sehemu hiyo ikiwa wazi.
9. Bofya Verify Connection karibu na URL. Ikiwa OmniProxy inatoa /models, orodha ya miundo itapatikana hapa.
10. Fungua Advanced. Ikiwa Model ID imeachwa wazi, miundo yote iliyorejeshwa na /models kwenye anwani hiyo itatumika. Tu ikiwa uthibitishaji utashindwa, ingiza kitambulisho kamili kutoka kwenye orodha chini ya Add Model ID, kisha bofya Add. Ongeza kila kitambulisho mara moja tu; nafasi za mwanzo na mwisho huondolewa.
11. Bofya Save kwenye dirisha hili, kisha bofya Save kwenye kona ya chini ya kulia ya ukurasa wa External Connections.

Kuhifadhi usanidi pekee hakubadilishi uthibitishaji. Verify Connection huomba mwisho wa /models wa huduma nyingine, ambayo huorodhesha miundo inayopatikana. Baadhi ya huduma hazitoi mwisho huu, kwa hivyo uthibitishaji unaweza kuripoti kosa ingawa gumzo bado linaweza kufanya kazi. Katika kesi hiyo, ongeza kitambulisho cha muundo kwa mwongozo.

Thibitisha Kazi Halisi

Rudi kwenye ukurasa wa gumzo, fungua menyu ya muundo karibu na kisanduku cha kuingiza, na uchague kitambulisho kamili kutoka kwenye orodha ya OmniProxy. Tuma ujumbe mfupi sana, kama vile kumwambia ajibu kwa neno moja tu. Jibu lazima lionekane kwenye kisanduku cha gumzo.

Mnamo 2026-10-09, mazungumzo haya yalikamilishwa kwa kutumia usakinishaji wa Python wa v0.11.4. Docker inabaki kuwa njia inayopendekezwa, lakini jaribio halikurudiwa kwenye Docker.

Kisha, fungua kumbukumbu za ombi za OmniProxy na uthibitishe chanzo na kitambulisho cha muundo kwa ombi hili. Kuona tu uhifadhi uliofanikiwa, au kuona tu muundo kwenye menyu, haimaanishi kukamilika.

Kiolesura

Muundo unaweza kuchaguliwa

• Connections imehifadhiwa
• Muundo unaonekana kwenye orodha
• Tuma swali fupi

Jibu

Kisanduku cha gumzo kinaonyesha jibu

• Si ujumbe tupu
• Si kosa la muunganisho
• Jaribu tena na muundo mwingine

Kumbukumbu

Inaonekana kwenye gateway

• Chanzo ni muunganisho huu
• Kitambulisho cha muundo kinalingana
• Hakuna ufunguo ulioingizwa kwenye ukurasa

Makosa ya Kawaida

• localhost au 127.0.0.1 ilitumiwa ndani ya kontena: Anwani hizi zinaelekeza kwenye kontena yenyewe, si mwenyeji. Badilisha anwani kuwa host.docker.internal na uthibitishe kuwa amri ya kuanza inajumuisha --add-host=host.docker.internal:host-gateway. Kinyume chake hutumika wakati Open WebUI haifanyi kazi kwenye kontena: tumia anwani ya ndani badala yake.
• Kivinjari hakiwezi kufungua ukurasa: Kwa Docker, angalia bandari 3000; kwa Python, angalia bandari 8080. Wakati wa kuanza kwa kwanza, subiri upakuaji wa muundo wa embedding umalizike. Unaweza kutumia docker ps kuthibitisha ikiwa kontena inafanya kazi. Ikiwa bandari 3000 tayari inatumika, badilisha bandari upande wa kushoto wa -p.
• Kitambulisho kwenye menyu ya muundo ni kirefu kuliko jina fupi la mtoa huduma: Tumia kitambulisho kamili kutoka kwenye menyu, ikijumuisha mikwaju yoyote.
• Kila mtu anaondolewa baada ya sasisho: WEBUI_SECRET_KEY ilibadilika. Ianzishe upya kwa kutumia siri iliyozalishwa mara ya kwanza.
• Verify Connection inashindwa: Kwanza ongeza kitambulisho cha muundo kwa mwongozo chini ya Advanced, kisha uthibitishe na gumzo halisi la sentensi moja. Baadhi ya huduma hazitoi /models, kwa hivyo gumzo bado linaweza kufanya kazi wakati uthibitishaji unaripoti kosa.
• Muundo haupo: Nakili kitambulisho tena kutoka kwa orodha ya sasa ya OmniProxy badala ya kuendelea kutumia jina la zamani.

Marejeleo Rasmi

Kwa amri za usakinishaji, angalia Open WebUI Quick Start. Kwa hatua za muunganisho, angalia OpenAI-compatible connection instructions. Kwa vitambulisho vya muundo vinavyotumiwa katika mifano, angalia Claude model overview na Gemini model list.

Badilisha kila nafasi yenye thamani kutoka kwenye usanidi wako wa OmniProxy. Usitangaze funguo halisi.

Matokeo yaliyohifadhiwa au HTTP 200 pekee hayathibitishi utangamano kamili wa Agent. Angalia chanzo na mfano katika rekodi ya maombi ya OmniProxy.

Vyanzo rasmi · Open WebUI ↗