Pag-install ng Open WebUI at Pag-configure ng OmniProxy

Ang Open WebUI ay isang self-hosted chat interface na maaaring i-install sa sarili mong computer o server at maaari ring tumakbo nang ganap na offline. Hindi ito nakatali sa anumang isang model provider: maaari itong kumonekta sa mga tool gaya ng Ollama na nagpapatakbo ng mga model nang lokal, pati na rin sa mga OpenAI-compatible endpoint—mga address na nagbibigay ng mga model service gamit ang parehong request format. Pinapayagan ka nitong lumipat sa pagitan ng mga lokal at cloud model sa parehong window.

Angkop ito para sa pangmatagalang paggamit ng mga team at organisasyon. Ang mga kakayahan na tumatanggap ng mas mabilis na update ay unang lumalabas sa Computer, ang produktong ginagamit ng Open WebUI para subukan ang mga bagong feature.

Bago Ka Magsimula

Ang Open WebUI ay available sa macOS, Linux, at Windows. Maaari mo itong i-install gamit ang Docker, Python, o Kubernetes. Ang Docker ay nagbabalot ng application at runtime environment nito sa isang medyo isolated na container at ito ang inirerekomendang paraan. Kung hindi available ang Docker, maaari mo ring gamitin ang sinubukang Python command sa ibaba. Ang Kubernetes ay isang system para sa pag-deploy at pamamahala ng mga container; tingnan ang Quick Start na naka-link sa dulo ng gabay na ito para sa mga kaukulang hakbang.

Opisyal na inirerekomenda

Docker

• Isang docker run command
• Buksan ang 3000 sa browser
• Ang data ay iniimbak sa volume

Gusto lang mag-chat

slim image

• Mas maliit na download size
• Baguhin ang tag sa :slim
• Ang functionality ng chat ay nananatiling available

Hindi sakop dito

Dalawa pang opsyon

• Manual na pag-install ng Python
• Kubernetes deployment
• Tingnan ang opisyal na Quick Start

Bago magsimula, ihanda ang sumusunod:

• Naka-install at tumatakbong Docker.
• Isang secret string na ginagamit lamang mo. Patakbuhin ang openssl rand -hex 32 para makagawa ng isa, pagkatapos ay ipasok ito bilang WEBUI_SECRET_KEY. I-save ang value na ito nang permanente. Kung babaguhin mo ito kapag muling binuo ang container, ang mga user na naka-sign in na ay ma-sa-sign out.
• Isang tumatakbong OmniProxy instance at isang model ID mula sa kasalukuyang listahan ng mga model nito. Ang model ID ay ang kumpletong pangalan na ginagamit para pumili ng isang partikular na model.

Pag-install at Unang Paglulunsad

Buksan ang terminal at patakbuhin ang command mula sa Quick Start. Palitan muna ang your-secret-key ng secret na ginawa mo lang:

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

Ang mga sumusunod na bahagi ng command na ito ay nagsisilbi sa iba’t ibang layunin:

• -p 3000:8080: Pinapayagan kang buksan ang interface sa pamamagitan ng port 3000 sa computer na ito. Kung ang port 3000 ay ginagamit na, baguhin ang numero sa kaliwa.
• -v open-webui:/app/backend/data: Iniimbak ang mga chat, user, at setting sa isang data volume. Ang data volume ay isang lokasyon sa labas ng container kung saan ang data ay pinapanatili nang pangmatagalan, kaya ang mga nilalaman nito ay nananatili pagkatapos ma-update ang container. Huwag alisin ang opsyon na ito.
• --add-host=host.docker.internal:host-gateway: Pinapayagan ang container na ma-access ang iba pang serbisyo na tumatakbo sa computer na ito.
• --restart always: Sinisimulan muli ang container pagkatapos mag-reboot ang computer.

Pagkatapos matapos ang command, buksan ang http://localhost:3000 sa isang browser at sundin ang mga tagubilin sa screen para gumawa ng unang account.

Kung kailangan mo lang mag-chat sa pamamagitan ng API, maaari mong baguhin ang image tag mula sa :main patungo sa :slim. Ang slim ay isang mas maliit na image na hindi kasama ang mga lokal na speech at embedding model sa loob ng container, ngunit ang chat interface ay nananatiling available. Ipagpatuloy ang paggamit ng :main kung kailangan mo ang mga lokal na kakayahang iyon.

Para sa mga manual na update, patakbuhin muna ang docker rm -f open-webui, pagkatapos ay patakbuhin ang docker pull ghcr.io/open-webui/open-webui:main, at i-restart ito gamit ang parehong docker run command. Panatilihing hindi nagbabago ang parehong data volume at WEBUI_SECRET_KEY .

Kung Hindi Available ang Docker

Ang Quick Start ay nagbibigay din ng paraan ng pag-install gamit ang Python. Noong 2026-10-09, ang sumusunod na command ay ginamit sa macOS para i-install ang Open WebUI v0.11.4 at kumpletuhin ang isang usapan. Ang Docker Desktop ay hindi naka-install sa computer na iyon noong panahong iyon.

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

Pagkatapos ng startup, buksan ang http://localhost:8080 sa isang browser. Ito ang port na ginagamit ng Python installation, hindi ang port 3000 ng Docker.

Ang isang embedding model ay dina-download sa unang startup, na maaaring tumagal ng ilang minuto. Ang embedding model ay nagko-convert ng text sa data na mas madaling hanapin at itugma. Maghintay para sa sign-in page bago magpatuloy. Ang unang rehistradong account ang nagiging administrator. Ang wika ng interface ay sumusunod sa wika ng system; ang Simplified Chinese ay ipinakita sa panahon ng test na ito.

DATA_DIR ay dapat tumuro sa isang directory na pananatilihin nang pangmatagalan at gagamitin para i-imbak ang data ng Open WebUI. Kung hindi ito naka-set, ang data ay maaaring ma-imbak sa isang temporary directory at mawala pagkatapos ng shutdown. Kung ang WEBUI_SECRET_KEY ay hindi naka-set, ang program ay nagsusulat ng .webui_secret_key sa kasalukuyang directory. Simulan ito mula sa isang directory na balak mong panatilihin, o i-set ang variable na ito nang mag-isa.

Kumuha ng mga Detalye ng Koneksyon mula sa OmniProxy

Kopyahin ang sumusunod na tatlong item mula sa sarili mong OmniProxy instance:

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

Ang URL ay ang address na ginagamit ng Open WebUI para kumonekta sa endpoint at dapat itong magtapos sa /v1. Huwag magdagdag ng /chat/completions pagkatapos nito; ang Open WebUI ay awtomatikong nagdaragdag ng bahaging iyon.

Kopyahin ang kumpletong model ID mula sa kasalukuyang listahan ng OmniProxy. Kung ang ID ay may kasamang source prefix at slash, panatilihin din ang mga ito. Ang sumusunod na dalawang maikling pangalan ay mga sanggunian lamang mula sa dokumentasyon ng provider simula noong 2026-10-09. Huwag gamitin ang mga ito kung wala sila sa kasalukuyang listahan:

• Claude API ID para sa Claude Sonnet 5.5: claude-sonnet-5-5
• API name para sa Gemini 3.8 Flash: gemini-3.8-flash

Huwag magpasok ng provider key sa Open WebUI. Kung hindi i-validate ng gateway ang mga key, iwanang blangko ang API key sa halip na mag-imbento ng isa pang key.

Browser

Lokal na port 3000

• Buksan ang chat page
• Kumpletuhin muna ang pagpaparehistro
• Pagkatapos ay buksan ang mga setting

Sa loob ng container

Open WebUI

• Huwag gamitin ang localhost
• Gamitin ang pangalan ng host machine sa halip
• Ang URL ay nagtatapos sa /v1

Parehong computer

OmniProxy

• Panatilihin ang key sa gateway
• Gamitin ang listahan ng mga model ng gateway
• Pagkatapos ay suriin ang mga request log

Kung ang model service ay tumatakbo sa host habang ang Open WebUI ay tumatakbo sa isang Docker container, palitan ang localhost sa URL ng host.docker.internal. Ang host ay ang computer na direktang nagpapatakbo ng Docker. Kung ang OmniProxy ay nakikinig lamang sa computer na ito, ang URL ay maaaring isulat bilang http://host.docker.internal:port/v1, palitan ang port ng port na aktwal na ginagamit ng OmniProxy.

Kung ang Open WebUI ay tumatakbo nang lokal sa pamamagitan ng Python command sa nakaraang seksyon at ang OmniProxy ay tumatakbo rin nang lokal, gamitin ang 127.0.0.1 o localhost sa address. Huwag gamitin ang host.docker.internal sa kasong ito.

Ipasok ang Configuration

Sa Simplified Chinese interface ng v0.11.4 na sinubukan noong 2026-10-09, ang mga pangalan ay naiiba sa Settings > Admin > Connections sa mga tagubiling Ingles. Sundin ang mga opsyon na ipinapakita sa sinubukang interface, na isinalin sa ibaba:

1. Palawakin ang kaliwang sidebar.
2. I-click ang user menu sa ibaba.
3. I-click ang Settings.
4. Sa administrator section sa ibaba, i-click ang External Connections.
5. Buksan ang OpenAI API.
6. I-click ang + sa kanan ng Manage OpenAI API Connections.
7. Sa dialog na Edit Connection, ipasok ang URL na nagtatapos sa /v1. Panatilihing naka-set ang API type sa Chat Completions.
8. Panatilihing naka-set ang Authentication Method sa Key (Bearer). Ang Bearer authentication ay naglalagay ng API key sa request para sa identity verification. Kung binigyan ka ng OmniProxy ng key, ipasok ito sa ilalim ng API Key. Kung hindi i-validate ng gateway ang mga key, iwanang blangko ang field na ito. Noong 2026-10-09, parehong validation at isang usapan ang nagtagumpay nang iniwang blangko ang field.
9. I-click ang Verify Connection sa tabi ng URL. Kung ang OmniProxy ay nagbibigay ng /models, ang listahan ng mga model ay kukunin dito.
10. Buksan ang Advanced. Kung ang Model ID ay iniwang blangko, lahat ng model na ibinalik ng /models sa address na iyon ay gagamitin. Lamang kung mabigo ang validation, ipasok ang isang kumpletong ID mula sa listahan sa ilalim ng Add Model ID, pagkatapos ay i-click ang Add. Idagdag ang bawat ID nang isang beses lamang; ang mga leading at trailing space ay inaalis.
11. I-click ang Save sa window na ito, pagkatapos ay i-click ang Save sa kanang bahagi sa ibaba ng pahina ng External Connections.

Ang pag-save ng configuration lamang ay hindi pumapalit sa validation. Ang Verify Connection ay nagre-request ng /models endpoint ng kabilang serbisyo, na naglilista ng mga available na model. Ang ilang serbisyo ay hindi nagbibigay ng endpoint na ito, kaya ang validation ay maaaring mag-ulat ng error kahit na ang chat ay maaari pa ring gumana. Sa kasong iyon, idagdag ang model ID nang manual.

I-verify ang Isang Totoong Gawain

Bumalik sa chat page, buksan ang model menu sa tabi ng input box, at piliin ang kumpletong ID mula sa listahan ng OmniProxy. Magpadala ng napakaikling mensahe, gaya ng paghiling dito na sumagot ng isang salita lamang. Ang isang tugon ay dapat aktwal na lumabas sa chat box.

Noong 2026-10-09, ang usapang ito ay nakumpleto gamit ang Python installation ng v0.11.4. Ang Docker ay nananatiling inirerekomendang paraan, ngunit ang test ay hindi inulit sa Docker.

Susunod, buksan ang mga request log ng OmniProxy at kumpirmahin ang source at model ID para sa request na ito. Ang makakita lamang ng matagumpay na save, o makita lamang ang model sa menu, ay hindi binibilang bilang pagkumpleto.

Interface

Ang model ay maaaring piliin

• Ang Connections ay na-save na
• Ang model ay lumalabas sa listahan
• Magpadala ng maikling tanong

Tugon

Ang chat box ay nagpapakita ng sagot

• Hindi ito blangkong mensahe
• Hindi ito connection error
• Subukan muli gamit ang ibang model

Mga Log

Nakikita sa gateway

• Ang source ay ang koneksyong ito
• Ang Model ID ay tumutugma
• Walang key na ipinasok sa pahina

Mga Karaniwang Error

• localhost o 127.0.0.1 ay ginamit sa loob ng container: Ang mga address na ito ay tumuturo sa container mismo, hindi sa host. Baguhin ang address sa host.docker.internal at kumpirmahin na ang startup command ay may kasamang --add-host=host.docker.internal:host-gateway. Ang kabaligtaran ay totoo kapag ang Open WebUI ay hindi tumatakbo sa isang container: gumamit ng lokal na address sa halip.
• Hindi mabuksan ng browser ang pahina: Para sa Docker, suriin ang port 3000; para sa Python, suriin ang port 8080. Sa unang startup, maghintay para matapos ang pag-download ng embedding model. Maaari mong gamitin ang docker ps para kumpirmahin kung tumatakbo ang container. Kung ang port 3000 ay ginagamit na, baguhin ang port sa kaliwang bahagi ng -p.
• Ang ID sa model menu ay mas mahaba kaysa sa maikling pangalan ng provider: Gamitin ang kumpletong ID mula sa menu, kasama ang anumang slash.
• Lahat ay naka-sign out pagkatapos ng update: WEBUI_SECRET_KEY ay nagbago. I-restart gamit ang secret na ginawa noong unang pagkakataon.
• Verify Connection ay nabigo: Idagdag muna nang manual ang model ID sa ilalim ng Advanced, pagkatapos ay kumpirmahin ito gamit ang isang totoong one-sentence chat. Ang ilang serbisyo ay hindi nagbibigay ng /models, kaya ang chat ay maaaring gumana pa rin kapag ang validation ay nag-ulat ng error.
• Hindi umiiral ang model: Kopyahin itong muli mula sa kasalukuyang listahan ng OmniProxy sa halip na patuloy na gumamit ng lumang pangalan.

Mga Opisyal na Sanggunian

Para sa mga installation command, tingnan ang Open WebUI Quick Start. Para sa mga hakbang sa koneksyon, tingnan ang OpenAI-compatible connection instructions. Para sa mga model ID na ginamit sa mga halimbawa, tingnan ang Claude model overview at Gemini model list.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · Open WebUI ↗