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

Open WebUI е самостоятелно хостван интерфейс за чат, който може да бъде инсталиран на вашия собствен компютър или сървър и може също да работи напълно офлайн. Той не е обвързан с нито един доставчик на модели: може да се свързва с инструменти като Ollama, които изпълняват модели локално, както и с краища, съвместими с OpenAI — адреси, които предоставят услуги за модели, използвайки същия формат на заявката. Това ви позволява да превключвате между локални и облачни модели в един и същ прозорец.

Подходящ е за дългосрочна употреба от екипи и организации. Възможностите, които получават по-бързи актуализации, се появяват първо в Computer, продукта, който Open WebUI използва, за да изпробва нови функции.

Преди да започнете

Open WebUI е наличен на macOS, Linux и Windows. Можете да го инсталирате с помощта на Docker, Python или Kubernetes. Docker пакетира приложението и неговата среда за изпълнение в сравнително изолиран контейнер и е препоръчителният метод. Ако Docker не е наличен, можете също да използвате тестваната команда на Python по-долу. Kubernetes е система за внедряване и управление на контейнери; вижте Бързия старт, свързан в края на това ръководство, за съответните стъпки.

Официално препоръчано

Docker

Една команда docker run
Отворете 3000 в браузъра
Данните се съхраняват в тома

Просто искате да чатите

slim изображение

По-малък размер на изтегляне
Променете етикета на :slim
Функционалността за чат остава налична

Не е покрито тук

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

Ръчна инсталация на Python
Внедряване в Kubernetes
Вижте официалния Бърз старт

Първо инсталирайте Docker, след това стартирайте приложението с препоръчаната команда. Ако чатите само чрез API, можете да промените етикета на изображението на slim.

Преди да започнете, подгответе следното:

Инсталиран и работещ Docker.
Таен низ, използван само от вас. Стартирайте openssl rand -hex 32 за генериране на такъв, след което го въведете като WEBUI_SECRET_KEY. Запазете тази стойност за постоянно. Ако я промените при повторно изграждане на контейнера, потребителите, които вече са влезли, ще бъдат отписани.
Работеща инстанция на OmniProxy и идентификатор на модел от текущия му списък с модели. Идентификаторът на модела е пълното име, използвано за избор на конкретен модел.

Инсталиране и първо стартиране

Отворете терминал и изпълнете командата от Бързия старт. Първо заменете 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 е по-малък образ, който не включва локални модели за реч и вграждане вътре в контейнера, но интерфейсът за чат остава наличен. Продължете да използвате :main ако имате нужда от тези локални възможности.

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

Ако Docker не е наличен

Бързият старт също предоставя метод за инсталиране на 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, а не порт 3000 на Docker.

Модел за вграждане се изтегля по време на първото стартиране, което може да отнеме няколко минути. Моделът за вграждане преобразува текст в данни, които са по-лесни за търсене и съпоставяне. Изчакайте страницата за вход да се появи, преди да продължите. Първият регистриран акаунт става администратор. Езикът на интерфейса следва системния език; по време на този тест беше показан опростен китайски.

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 използва за свързване към крайната точка и трябва да завършва с /v1. Не добавяйте /chat/completions след него; Open WebUI добавя тази част автоматично.

Копирайте пълния идентификатор на модела от текущия списък на OmniProxy. Ако идентификаторът включва префикс на източника и наклонена черта, запазете и тях. Следните две кратки имена са само препратки от документацията на доставчика към 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. Ако шлюзът не валидира ключове, оставете API ключа празен, вместо да измисляте друг ключ.

Браузър

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

Отворете страницата за чат
Първо завършете регистрацията
След това отворете настройките

Вътре в контейнера

Open WebUI

Не използвайте localhost
Използвайте името на хост машината вместо това
URL адресът завършва с /v1

Същият компютър

OmniProxy

Запазете ключа в шлюза
Използвайте списъка с модели на шлюза
След това прегледайте записите на заявките

Когато 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. Ако шлюзът не валидира ключове, оставете това поле празно. На 09.10.2026 г. както валидирането, така и един разговор бяха успешни с оставено празно поле.
Кликнете върху Verify Connection до URL адреса. Ако OmniProxy предостави /models, списъкът с модели ще бъде извлечен тук.
Отворете Advanced. Ако Model ID е оставен празен, ще се използват всички модели, върнати от /models на този адрес. Само ако валидирането се провали, въведете пълен идентификатор от списъка под Add Model ID, след което кликнете върху Add. Добавете всеки идентификатор само веднъж; водещите и крайните интервали се премахват.
Кликнете върху Save в този прозорец, след това кликнете върху Save в долния десен ъгъл на страницата External Connections.

Запазването на конфигурацията само по себе си не замества валидирането. Verify Connection изисква крайната точка /models на другата услуга, която изброява наличните модели. Някои услуги не предоставят тази крайна точка, така че валидирането може да съобщи за грешка, въпреки че чатът все още може да работи. В такъв случай добавете идентификатора на модела ръчно.

Проверка на реална задача

Върнете се на страницата за чат, отворете менюто за модели до полето за въвеждане и изберете пълния идентификатор от списъка на OmniProxy. Изпратете много кратко съобщение, като например да го помолите да отговори само с една дума. Отговорът действително трябва да се появи в полето за чат.

На 09.10.2026 г. този разговор беше завършен с помощта на инсталацията на Python на v0.11.4. Docker остава препоръчителният метод, но тестът не беше повторен в Docker.

След това отворете записите на заявките на OmniProxy и потвърдете източника и идентификатора на модела за тази заявка. Виждането само на успешно записване или само виждането на модела в менюто не се брои за завършване.

Интерфейс

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

Връзките са запазени
Моделът се появява в списъка
Изпратете кратък въпрос

Отговор

Полето за чат показва отговор

Това не е празно съобщение
Това не е грешка при свързване
Опитайте отново с друг модел

Логове

Видими в шлюза

Източникът е тази връзка
Идентификаторът на модела съвпада
На страницата не е въведен ключ

Връзката е използваема само когато и трите проверки съвпадат.

Чести грешки

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.
Идентификаторът в менюто за модели е по-дълъг от краткото име на доставчика: Използвайте пълния идентификатор от менюто, включително всички наклонени черти.
Всички са отписани след актуализация: WEBUI_SECRET_KEY променено. Рестартирайте, като използвате тайната, генерирана първия път.
Verify Connection се проваля: Първо ръчно добавете идентификатора на модела под Advanced, след това го потвърдете с реален чат от едно изречение. Някои услуги не предоставят /models, така че чатът може все още да работи, когато валидирането съобщава за грешка.
Моделът не съществува: Копирайте идентификатора отново от текущия списък на OmniProxy, вместо да продължавате да използвате остаряло име.

Официални препратки

За команди за инсталиране вижте Open WebUI Quick Start. За стъпки за свързване вижте OpenAI-compatible connection instructions. За идентификаторите на модели, използвани в примерите, вижте Claude model overview и Gemini model list.

Заменете всяка плейсхолдер стойност със стойности от вашата собствена конфигурация на OmniProxy. Никога не публикувайте истински ключ.

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

Официални източници · Open WebUI ↗