Инсталација Open WebUI-а и конфигурација OmniProxy-а

Open WebUI је self-hosted интерфејс за ћаскање који се може инсталирати на вашем рачунару или серверу, а може радити и потпуно ван мреже. Није везан за ниједног провајдера модела: може се повезати са алатима као што је Ollama који покрећу моделе локално, као и са endpoint-има компатибилним са OpenAI-ом — адресама које пружају сервисе модела користећи исти формат захтева. Ово вам омогућава да прелазите између локалних и облачних модела у истом прозору.

Погодан је за дуготрајну употребу од стране тимова и организација. Могућности које добијају бржа ажурирања прво се појављују у Computer-у, производу који Open WebUI користи за испробавање нових функција.

Пре почетка

Open WebUI је доступан на macOS-у, Linux-у и Windows-у. Можете га инсталирати користећи Docker, Python или Kubernetes. Docker пакује апликацију и њено извршно окружење у релативно изоловани контејнер и то је препоручени метод. Ако Docker није доступан, можете користити и тестирану Python команду испод. Kubernetes је систем за распоређивање и управљање контејнерима; погледајте Quick Start повезан на крају овог водича за одговарајуће кораке.

Званично препоручено

Docker

Једна docker run команда
Отворите 3000 у прегледачу
Подаци се чувају у волумену

Само желим да ћаскам

slim слика

Мања величина преузимања
Промените ознаку у :slim
Функционалност ћаскања остаје доступна

Није овде покривено

Две друге опције

Ручна Python инсталација
Kubernetes распоређивање
Погледајте званични Quick Start

Прво инсталирајте Docker, затим покрените апликацију са препорученом командом. Ако ћаскате само преко API-ја, можете променити ознаку слике у slim.

Пре почетка, припремите следеће:

Инсталиран и покренут Docker.
Тајни стринг који користите само ви. Покрените openssl rand -hex 32 да бисте га генерисали, затим га унесите као WEBUI_SECRET_KEY. Сачувајте ову вредност трајно. Ако је промените приликом поновне изградње контејнера, корисници који су већ пријављени биће одјављени.
Покренуту OmniProxy инстанцу и ID модела са њене тренутне листе модела. ID модела је пуно име које се користи за одабир одређеног модела.

Инсталација и прво покретање

Отворите терминал и покрените команду из Quick Start-а. Прво замените your-secret-key тајном коју сте управо генерисали:

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

Следећи делови ове команде служе различитим сврхама:

-p 3000:8080: Омогућава вам да отворите интерфејс преко порта 3000 на овом рачунару. Ако је порт 3000 већ у употреби, промените број са леве стране.
-v open-webui:/app/backend/data: Чува ћаскања, кориснике и подешавања у волумену података. Волумен података је локација ван контејнера где се подаци дугорочно задржавају, тако да садржај остаје након ажурирања контејнера. Немојте уклањати ову опцију.
--add-host=host.docker.internal:host-gateway: Омогућава контејнеру приступ другим сервисима који раде на овом рачунару.
--restart always: Поново покреће контејнер након поновног покретања рачунара.

Након што се команда заврши, отворите http://localhost:3000 у прегледачу и пратите упутства на екрану да бисте креирали први налог.

Ако треба да ћаскате само преко API-ја, можете променити ознаку слике из :main у :slim. slim је мања слика која не укључује локалне моделе за говор и уграђивање (embedding) унутар контејнера, али интерфејс за ћаскање остаје доступан. Наставите да користите :main ако су вам потребне те локалне могућности.

За ручна ажурирања, прво покрените docker rm -f open-webui, затим покрените docker pull ghcr.io/open-webui/open-webui:main, и поново га покрените са истом docker run командом. Задржите и волумен података и WEBUI_SECRET_KEY непромењеним.

Ако Docker није доступан

Quick Start такође пружа метод Python инсталације. Дана 09.10.2026, следећа команда је коришћена на macOS-у за инсталацију Open WebUI v0.11.4 и завршетак једног разговора. Docker Desktop у то време није био инсталиран на том рачунару.

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

Након покретања, отворите http://localhost:8080 у прегледачу. Ово је порт који користи Python инсталација, а не Docker-ов порт 3000.

Модел за уграђивање (embedding) се преузима током првог покретања, што може потрајати неколико минута. Модел за уграђивање претвара текст у податке које је лакше претраживати и подударати. Сачекајте да се појави страница за пријаву пре него што наставите. Први регистровани налог постаје администратор. Језик интерфејса прати језик система; поједностављени кинески је био приказан током овог теста.

DATA_DIR мора да показује на директоријум који ће се дугорочно задржати и користити за чување података Open WebUI-а. Ако није подешен, подаци се могу сачувати у привременом директоријуму и изгубити након гашења. Ако WEBUI_SECRET_KEY није подешен, програм пише .webui_secret_key у тренутном директоријуму. Покрените га из директоријума који намеравате да задржите, или сами подесите ову променљиву.

Добијање детаља о повезивању из OmniProxy-а

Копирајте следеће три ставке из сопствене OmniProxy инстанце:

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

URL је адреса коју Open WebUI користи за повезивање са endpoint-ом и мора се завршавати са /v1. Немојте додавати /chat/completions након њега; Open WebUI тај део додаје аутоматски.

Копирајте пун ID модела са тренутне листе OmniProxy-а. Ако ID укључује префикс извора и косу црту, сачувајте и њих. Следећа два кратка имена су само референце из документације провајдера од 09.10.2026. Немојте их користити ако нису на тренутној листи:

Claude API ID за Claude Sonnet 5.5: claude-sonnet-5-5
API име за Gemini 3.8 Flash: gemini-3.8-flash

Не уносите кључ провајдера у Open WebUI. Ако gateway не потврђује кључеве, оставите API кључ празним уместо да измишљате други кључ.

Прегледач

Локални порт 3000

Отворите страницу за ћаскање
Прво завршите регистрацију
Затим отворите подешавања

Унутар контејнера

Open WebUI

Не користите localhost
Уместо тога користите име хост машине
URL се завршава са /v1

Исти рачунар

OmniProxy

Задржите кључ у gateway-у
Користите листу модела gateway-а
Затим прегледајте логове захтева

Када Open WebUI ради у Docker-у, а OmniProxy ради на хосту, немојте користити localhost контејнера у адреси.

Ако сервис модела ради на хосту док Open WebUI ради у Docker контејнеру, замените localhost у URL-у са host.docker.internal. Хост је рачунар који директно покреће Docker. Ако OmniProxy слуша само на овом рачунару, URL се може написати као http://host.docker.internal:port/v1, замењујући port портом који OmniProxy заиста користи.

Ако Open WebUI ради локално кроз Python команду у претходном одељку, а OmniProxy такође ради локално, користите 127.0.0.1 или localhost у адреси. Не користите host.docker.internal у овом случају.

Унос конфигурације

У интерфејсу на поједностављеном кинеском језику верзије v0.11.4 тестираној 09.10.2026, имена су се разликовала од Settings > Admin > Connections у упутствима на енглеском. Пратите опције приказане у тестираном интерфејсу, преведене испод:

Проширите леву бочну траку.
Кликните на кориснички мени на дну.
Кликните на Settings.
У администраторском одељку испод, кликните на External Connections.
Отворите OpenAI API.
Кликните на + десно од Manage OpenAI API Connections.
У дијалогу Edit Connection, унесите URL који се завршава са /v1. Задржите тип API-ја подешен на Chat Completions.
Задржите Authentication Method подешен на Key (Bearer). Bearer аутентификација ставља API кључ у захтев ради верификације идентитета. Ако вам је OmniProxy дао кључ, унесите га под API Key. Ако gateway не потврђује кључеве, оставите ово поље празним. Дана 09.10.2026, и потврда и један разговор су успели са пољем остављеним празним.
Кликните на Verify Connection поред URL-а. Ако OmniProxy пружа /models, листа модела ће бити преузета овде.
Отворите Advanced. Ако је Model ID остављен празан, користиће се сви модели које враћа /models на тој адреси. Само ако потврда не успе, унесите пун ID са листе под Add Model ID, затим кликните на Add. Додајте сваки ID само једном; водећи и пратећи размаци се уклањају.
Кликните на Save у овом прозору, затим кликните на Save у доњем десном углу странице External Connections.

Само чување конфигурације не замењује потврду. Verify Connection захтева endpoint /models другог сервиса, који наводи доступне моделе. Неки сервиси не пружају овај endpoint, па потврда може пријавити грешку иако ћаскање и даље може радити. У том случају, додајте ID модела ручно.

Верификација стварног задатка

Вратите се на страницу за ћаскање, отворите мени модела поред поља за унос и изаберите пун ID са OmniProxy листе. Пошаљите врло кратку поруку, као што је захтев да одговори само једном речју. Одговор се мора заиста појавити у пољу за ћаскање.

Дана 09.10.2026, овај разговор је завршен коришћењем Python инсталације v0.11.4. Docker остаје препоручени метод, али тест није поновљен у Docker-у.

Затим отворите логове захтева OmniProxy-а и потврдите извор и ID модела за овај захтев. Видети само успешно чување, или видети модел само у менију, не рачуна се као завршетак.

Интерфејс

Модел се може изабрати

Connections је сачувано
Модел се појављује на листи
Пошаљите кратко питање

Одговор

Поље за ћаскање приказује одговор

Није празна порука
Није грешка повезивања
Покушајте поново са другим моделом

Логови

Видљиво у gateway-у

Извор је ова веза
ID модела се поклапа
Ниједан кључ није унет на страници

Веза је употребљива само када се све три провере поклапају.

Уобичајене грешке

localhost или 127.0.0.1 је коришћено унутар контејнера: Ове адресе показују на сам контејнер, а не на хост. Промените адресу у host.docker.internal и потврдите да команда за покретање укључује --add-host=host.docker.internal:host-gateway. Обрнуто важи када Open WebUI не ради у контејнеру: користите локалну адресу уместо тога.
Прегледач не може да отвори страницу: За Docker, проверите порт 3000; за Python, проверите порт 8080. Током првог покретања, сачекајте да се преузимање модела за уграђивање заврши. Можете користити docker ps да потврдите да ли контејнер ради. Ако је порт 3000 већ у употреби, промените порт на левој страни -p.
ID у менију модела је дужи од кратког имена провајдера: Користите пун ID из менија, укључујући све косе црте.
Сви су одјављени након ажурирања: WEBUI_SECRET_KEY је промењено. Поново покрените користећи тајну генерисану први пут.
Verify Connection не успева: Прво ручно додајте ID модела под Advanced, затим га потврдите стварним ћаскањем од једне реченице. Неки сервиси не пружају /models, па ћаскање може и даље радити када потврда пријави грешку.
Модел не постоји: Копирајте ID поново са тренутне листе OmniProxy-а уместо да наставите са коришћењем застарелог имена.

Званичне референце

За команде инсталације, погледајте Open WebUI Quick Start. За кораке повезивања, погледајте OpenAI-compatible connection instructions. За ID-ове модела коришћене у примерима, погледајте Claude model overview и Gemini model list.

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

Сачувани резултат или HTTP 200 сами по себи не доказују пуну компатибилност Агента. Проверите извор и модел у запису позива OmniProxy.

Званични извори · Open WebUI ↗