Open WebUI instalēšana un OmniProxy konfigurēšana

Open WebUI ir pašmitināta tērzēšanas saskarne, ko var instalēt savā datorā vai serverī un kas var darboties arī pilnīgi bezsaistē. Tā nav piesaistīta nevienam konkrētam modeļu pakalpojumu sniedzējam: tā var izveidot savienojumu ar rīkiem, piemēram, Ollama, kas darbina modeļus lokāli, kā arī ar OpenAI saderīgiem galapunktiem — adresēm, kas nodrošina modeļu pakalpojumus, izmantojot to pašu pieprasījuma formātu. Tas ļauj vienā logā pārslēgties starp lokālajiem un mākoņa modeļiem.

Tā ir piemērota ilgtermiņa lietošanai komandām un organizācijām. Iespējas, kas saņem ātrākus atjauninājumus, vispirms parādās Computer — produktā, ko Open WebUI izmanto, lai izmēģinātu jaunas funkcijas.

Pirms sākat

Open WebUI ir pieejams operētājsistēmās macOS, Linux un Windows. Varat to instalēt, izmantojot Docker, Python vai Kubernetes. Docker iepako lietojumprogrammu un tās izpildlaika vidi relatīvi izolētā konteinerā, un tā ir ieteicamā metode. Ja Docker nav pieejams, varat izmantot arī tālāk norādīto pārbaudīto Python komandu. Kubernetes ir sistēma konteineru izvietošanai un pārvaldībai; skatiet ātro startu, kas saistīts šīs rokasgrāmatas beigās, lai uzzinātu atbilstošās darbības.

Oficiāli ieteicams

Docker

• Viena docker run komanda
• Atveriet 3000 pārlūkprogrammā
• Dati tiek saglabāti sējumā

Vienkārši vēlaties tērzēt

slim attēls

• Mazāks lejupielādes izmērs
• Mainiet tagu uz :slim
• Tērzēšanas funkcionalitāte paliek pieejama

Šeit nav iekļauts

Divas citas iespējas

• Manuāla Python instalēšana
• Kubernetes izvietošana
• Skatiet oficiālo ātro startu

Pirms sākat, sagatavojiet sekojošo:

• Instalēts un darbojas Docker.
• Slepena virkne, ko izmantojat tikai jūs. Palaidiet openssl rand -hex 32 lai ģenerētu vienu, pēc tam ievadiet to kā WEBUI_SECRET_KEY. Saglabājiet šo vērtību pastāvīgi. Ja maināt to, pārbūvējot konteineru, lietotāji, kuri jau ir pieteikušies, tiks izrakstīti.
• Darbojoša OmniProxy instance un modeļa ID no tās pašreizējā modeļu saraksta. Modeļa ID ir pilnais nosaukums, ko izmanto konkrēta modeļa atlasei.

Instalēšana un pirmā palaišana

Atveriet termināli un palaidiet komandu no ātrā starta. Vispirms aizstājiet your-secret-key ar tikko ģenerēto noslēpumu:

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

Šīs komandas daļas kalpo dažādiem mērķiem:

• -p 3000:8080: Ļauj atvērt saskarni caur 3000. portu šajā datorā. Ja 3000. ports jau tiek izmantots, mainiet skaitli kreisajā pusē.
• -v open-webui:/app/backend/data: Saglabā tērzēšanas sarunas, lietotājus un iestatījumus datu sējumā. Datu sējums ir vieta ārpus konteinera, kur dati tiek saglabāti ilgtermiņā, tāpēc to saturs paliek pēc konteinera atjaunināšanas. Nenoņemiet šo opciju.
• --add-host=host.docker.internal:host-gateway: Ļauj konteineram piekļūt citiem pakalpojumiem, kas darbojas šajā datorā.
• --restart always: Restartē konteineru pēc datora pārstartēšanas.

Pēc komandas pabeigšanas atveriet http://localhost:3000 pārlūkprogrammā un izpildiet ekrānā redzamos norādījumus, lai izveidotu pirmo kontu.

Ja tērzējat tikai caur API, varat mainīt attēla tagu no :main uz :slim. slim ir mazāks attēls, kas neietver lokālos runas un iegulšanas modeļus konteinera iekšpusē, taču tērzēšanas saskarne paliek pieejama. Turpiniet izmantot :main ja jums ir nepieciešamas šīs lokālās iespējas.

Manuālai atjaunināšanai vispirms palaidiet docker rm -f open-webui, pēc tam palaidiet docker pull ghcr.io/open-webui/open-webui:main, un restartējiet to ar to pašu docker run komandu. Saglabājiet gan datu sējumu, gan WEBUI_SECRET_KEY nemainīgus.

Ja Docker nav pieejams

Ātrais starts piedāvā arī Python instalēšanas metodi. 2026-10-09 operētājsistēmā macOS tika izmantota šāda komanda, lai instalētu Open WebUI v0.11.4 un pabeigtu vienu sarunu. Docker Desktop tajā laikā šajā datorā nebija instalēts.

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

Pēc palaišanas atveriet http://localhost:8080 pārlūkprogrammā. Šis ir ports, ko izmanto Python instalēšana, nevis Docker 3000. ports.

Iegulšanas modelis tiek lejupielādēts pirmās palaišanas laikā, kas var aizņemt vairākas minūtes. Iegulšanas modelis pārvērš tekstu datos, kurus ir vieglāk meklēt un saskaņot. Pirms turpināt, uzgaidiet, līdz parādās pieteikšanās lapa. Pirmais reģistrētais konts kļūst par administratoru. Saskarnes valoda seko sistēmas valodai; šīs pārbaudes laikā tika parādīta vienkāršotā ķīniešu valoda.

DATA_DIR jānorāda direktorija, kas tiks saglabāta ilgtermiņā un izmantots Open WebUI datu glabāšanai. Ja tas nav iestatīts, dati var tikt saglabāti pagaidu direktorijā un pēc izslēgšanas pazust. Ja WEBUI_SECRET_KEY nav iestatīts, programma raksta .webui_secret_key pašreizējā direktorijā. Palaidiet to no direktorija, kuru plānojat saglabāt, vai iestatiet šo mainīgo pats.

Savienojuma informācijas iegūšana no OmniProxy

Kopējiet šos trīs vienumus no savas OmniProxy instances:

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

URL ir adrese, ko Open WebUI izmanto, lai izveidotu savienojumu ar galapunktu, un tai jābeidzas ar /v1. Nepievienojiet /chat/completions pēc tās; Open WebUI šo daļu pievieno automātiski.

Kopējiet pilno modeļa ID no OmniProxy pašreizējā saraksta. Ja ID ietver avota prefiksu un slīpsvītru, saglabājiet arī tos. Šie divi īsie nosaukumi ir tikai atsauces no pakalpojumu sniedzēja dokumentācijas uz 2026-10-09. Neizmantojiet tos, ja tie nav pašreizējā sarakstā:

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

Neievadiet pakalpojumu sniedzēja atslēgu Open WebUI. Ja vārteja nevalidē atslēgas, atstājiet API atslēgu tukšu, nevis izdomājiet citu atslēgu.

Pārlūks

Lokālais ports 3000

• Atveriet tērzēšanas lapu
• Vispirms pabeidziet reģistrāciju
• Pēc tam atveriet iestatījumus

Konteinera iekšpusē

Open WebUI

• Neizmantojiet localhost
• Tā vietā izmantojiet resursdatora nosaukumu
• URL beidzas ar /v1

Tas pats dators

OmniProxy

• Saglabājiet atslēgu vārtejā
• Izmantojiet vārtejas modeļu sarakstu
• Pēc tam pārskatiet pieprasījumu žurnālus

Ja modeļa pakalpojums darbojas resursdatorā, kamēr Open WebUI darbojas Docker konteinerā, aizstājiet localhost URL ar host.docker.internal. Resursdators ir dators, kurā darbojas Docker. Ja OmniProxy klausās tikai šajā datorā, URL var rakstīt kā http://host.docker.internal:port/v1, aizstājot port ar portu, ko OmniProxy faktiski izmanto.

Ja Open WebUI darbojas lokāli, izmantojot Python komandu iepriekšējā sadaļā, un OmniProxy arī darbojas lokāli, izmantojiet 127.0.0.1 vai localhost adresē. Neizmantojiet host.docker.internal šajā gadījumā.

Konfigurācijas ievadīšana

v0.11.4 vienkāršotās ķīniešu valodas saskarnē, kas pārbaudīta 2026-10-09, nosaukumi atšķīrās no Settings > Admin > Connections angļu valodas instrukcijās. Sekojiet pārbaudītajā saskarnē redzamajām opcijām, kas tulkotas zemāk:

1. Izvērsiet kreiso sānjoslu.
2. Noklikšķiniet uz lietotāja izvēlnes apakšā.
3. Noklikšķiniet uz Settings.
4. Administratora sadaļā zemāk noklikšķiniet uz External Connections.
5. Atveriet OpenAI API.
6. Noklikšķiniet uz + pa labi no Manage OpenAI API Connections.
7. Dialoglodziņā Edit Connection ievadiet URL, kas beidzas ar /v1. Saglabājiet API tipu iestatītu uz Chat Completions.
8. Saglabājiet Authentication Method iestatītu uz Key (Bearer). Bearer autentifikācija ievieto API atslēgu pieprasījumā identitātes pārbaudei. Ja OmniProxy jums deva atslēgu, ievadiet to zem API Key. Ja vārteja nevalidē atslēgas, atstājiet šo lauku tukšu. 2026-10-09 gan validācija, gan viena saruna izdevās ar tukšu lauku.
9. Noklikšķiniet uz Verify Connection blakus URL. Ja OmniProxy nodrošina /models, modeļu saraksts tiks izgūts šeit.
10. Atveriet Advanced. Ja Model ID tiek atstāts tukšs, tiks izmantoti visi modeļi, ko atgriež /models šajā adresē. Tikai tad, ja validācija neizdodas, ievadiet pilnu ID no saraksta zem Add Model ID, pēc tam noklikšķiniet uz Add. Pievienojiet katru ID tikai vienu reizi; atstarpes sākumā un beigās tiek noņemtas.
11. Noklikšķiniet uz Save šajā logā, pēc tam noklikšķiniet uz Save lapas External Connections apakšējā labajā stūrī.

Konfigurācijas saglabāšana vien neaizstāj validāciju. Verify Connection pieprasa otra pakalpojuma /models galapunktu, kurā uzskaitīti pieejamie modeļi. Daži pakalpojumi nenodrošina šo galapunktu, tāpēc validācija var ziņot par kļūdu, lai gan tērzēšana joprojām var darboties. Tādā gadījumā pievienojiet modeļa ID manuāli.

Reāla uzdevuma pārbaude

Atgriezieties tērzēšanas lapā, atveriet modeļu izvēlni blakus ievades laukam un atlasiet pilno ID no OmniProxy saraksta. Nosūtiet ļoti īsu ziņojumu, piemēram, lūdzot atbildēt tikai ar vienu vārdu. Tērzēšanas lodziņā ir jāparādās atbildei.

2026-10-09 šī saruna tika pabeigta, izmantojot v0.11.4 Python instalēšanu. Docker joprojām ir ieteicamā metode, taču pārbaude Docker netika atkārtota.

Pēc tam atveriet OmniProxy pieprasījumu žurnālus un apstipriniet šī pieprasījuma avotu un modeļa ID. Tikai veiksmīgas saglabāšanas redzēšana vai tikai modeļa redzēšana izvēlnē neskaitās kā pabeigšana.

Saskarne

Modeli var atlasīt

• Connections ir saglabāts
• Modelis parādās sarakstā
• Nosūtiet īsu jautājumu

Atbilde

Tērzēšanas lodziņā redzama atbilde

• Tas nav tukšs ziņojums
• Tā nav savienojuma kļūda
• Mēģiniet vēlreiz ar citu modeli

Žurnāli

Redzams vārtejā

• Avots ir šis savienojums
• Modeļa ID sakrīt
• Lapā netika ievadīta atslēga

Biežākās kļūdas

• localhost vai 127.0.0.1 tika izmantots konteinera iekšpusē: Šīs adreses norāda uz pašu konteineru, nevis resursdatoru. Mainiet adresi uz host.docker.internal un pārliecinieties, ka palaišanas komanda ietver --add-host=host.docker.internal:host-gateway. Pretējais attiecas uz gadījumu, kad Open WebUI nedarbojas konteinerā: tā vietā izmantojiet lokālo adresi.
• Pārlūkprogramma nevar atvērt lapu: Docker gadījumā pārbaudiet 3000. portu; Python gadījumā pārbaudiet 8080. portu. Pirmās palaišanas laikā uzgaidiet, līdz pabeigta iegulšanas modeļa lejupielāde. Varat izmantot docker ps lai apstiprinātu, vai konteiners darbojas. Ja 3000. ports jau tiek izmantots, mainiet portu -pkreisajā pusē.
• ID modeļu izvēlnē ir garāks par pakalpojumu sniedzēja īso nosaukumu: Izmantojiet pilno ID no izvēlnes, ieskaitot slīpsvītras.
• Visi tiek izrakstīti pēc atjaunināšanas: WEBUI_SECRET_KEY mainījās. Restartējiet, izmantojot pirmajā reizē ģenerēto noslēpumu.
• Verify Connection neizdodas: Vispirms manuāli pievienojiet modeļa ID zem Advanced, pēc tam apstipriniet to ar reālu viena teikuma tērzēšanu. Daži pakalpojumi nenodrošina /models, tāpēc tērzēšana var joprojām darboties, kad validācija ziņo par kļūdu.
• Modelis neeksistē: Kopējiet ID vēlreiz no OmniProxy pašreizējā saraksta, nevis turpiniet izmantot novecojušu nosaukumu.

Oficiālās atsauces

Instalēšanas komandas skatiet Open WebUI Quick Start. Savienojuma soļus skatiet OpenAI-compatible connection instructions. Lai uzzinātu piemēros izmantotos modeļu ID, skatiet Claude model overview un Gemini model list.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · Open WebUI ↗