Instalarea Open WebUI și configurarea OmniProxy

Open WebUI este o interfață de chat auto-găzduită care poate fi instalată pe propriul computer sau server și poate rula complet offline. Nu este legată de niciun furnizor de modele: se poate conecta la instrumente precum Ollama care rulează modele local, precum și la endpoint-uri compatibile OpenAI—adrese care furnizează servicii de model folosind același format de cerere. Acest lucru îți permite să comuți între modele locale și cloud în aceeași fereastră.

Este potrivită pentru utilizarea pe termen lung de către echipe și organizații. Capacitățile care primesc actualizări mai rapide apar mai întâi în Computer, produsul pe care Open WebUI îl folosește pentru a testa funcții noi.

Înainte de a începe

Open WebUI este disponibil pe macOS, Linux și Windows. Îl poți instala folosind Docker, Python sau Kubernetes. Docker împachetează aplicația și mediul său de execuție într-un container relativ izolat și este metoda recomandată. Dacă Docker nu este disponibil, poți folosi și comanda Python testată de mai jos. Kubernetes este un sistem pentru implementarea și gestionarea containerelor; vezi Quick Start-ul legat la sfârșitul acestui ghid pentru pașii corespunzători.

Recomandat oficial

Docker

• O comandă docker run
• Deschide 3000 în browser
• Datele sunt stocate în volum

Vrei doar să discuți

imagine slim

• Dimensiune de descărcare mai mică
• Schimbă tag-ul la :slim
• Funcționalitatea de chat rămâne disponibilă

Nu este acoperit aici

Două alte opțiuni

• Instalare manuală Python
• Implementare Kubernetes
• Vezi Quick Start-ul oficial

Înainte de a începe, pregătește următoarele:

• Docker instalat și care rulează.
• Un șir secret folosit doar de tine. Rulează openssl rand -hex 32 pentru a genera unul, apoi introdu-l ca WEBUI_SECRET_KEY. Salvează această valoare permanent. Dacă o schimbi când reconstruiești containerul, utilizatorii care sunt deja conectați vor fi deconectați.
• O instanță OmniProxy care rulează și un ID de model din lista sa curentă de modele. ID-ul modelului este numele complet folosit pentru a selecta un anumit model.

Instalare și prima lansare

Deschide un terminal și rulează comanda din Quick Start. Mai întâi înlocuiește your-secret-key cu secretul pe care tocmai l-ai generat:

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

Următoarele părți ale acestei comenzi servesc unor scopuri diferite:

• -p 3000:8080: Îți permite să deschizi interfața prin portul 3000 pe acest computer. Dacă portul 3000 este deja utilizat, schimbă numărul din stânga.
• -v open-webui:/app/backend/data: Stochează chat-urile, utilizatorii și setările într-un volum de date. Un volum de date este o locație din afara containerului unde datele sunt păstrate pe termen lung, astfel încât conținutul lor rămâne după ce containerul este actualizat. Nu elimina această opțiune.
• --add-host=host.docker.internal:host-gateway: Permite containerului să acceseze alte servicii care rulează pe acest computer.
• --restart always: Pornește containerul din nou după ce computerul repornește.

După ce comanda se termină, deschide http://localhost:3000 într-un browser și urmează instrucțiunile de pe ecran pentru a crea primul cont.

Dacă ai nevoie doar să discuți printr-un API, poți schimba tag-ul imaginii din :main la :slim. slim este o imagine mai mică ce nu include modele locale de vorbire și embedding în interiorul containerului, dar interfața de chat rămâne disponibilă. Continuă să folosești :main dacă ai nevoie de acele capacități locale.

Pentru actualizări manuale, rulează mai întâi docker rm -f open-webui, apoi rulează docker pull ghcr.io/open-webui/open-webui:main, și repornește-l cu aceeași comandă docker run . Păstrează atât volumul de date, cât și WEBUI_SECRET_KEY neschimbate.

Dacă Docker nu este disponibil

Quick Start-ul oferă și o metodă de instalare Python. La data de 09-10-2026, următoarea comandă a fost folosită pe macOS pentru a instala Open WebUI v0.11.4 și a finaliza o conversație. Docker Desktop nu era instalat pe acel computer la momentul respectiv.

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

După pornire, deschide http://localhost:8080 într-un browser. Acesta este portul folosit de instalarea Python, nu portul 3000 al Docker.

Un model de embedding este descărcat în timpul primei porniri, ceea ce poate dura câteva minute. Un model de embedding convertește textul în date care sunt mai ușor de căutat și potrivit. Așteaptă să apară pagina de conectare înainte de a continua. Primul cont înregistrat devine administrator. Limba interfeței urmează limba sistemului; chineza simplificată a fost afișată în timpul acestui test.

DATA_DIR trebuie să indice un director care va fi păstrat pe termen lung și folosit pentru a stoca datele Open WebUI. Dacă nu este setat, datele pot fi stocate într-un director temporar și pierdute după oprire. Dacă WEBUI_SECRET_KEY nu este setat, programul scrie .webui_secret_key în directorul curent. Pornește-l dintr-un director pe care intenționezi să îl păstrezi sau setează singur această variabilă.

Obținerea detaliilor de conexiune de la OmniProxy

Copiază următoarele trei elemente din propria ta instanță OmniProxy:

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

URL-ul este adresa pe care Open WebUI o folosește pentru a se conecta la endpoint și trebuie să se termine cu /v1. Nu adăuga /chat/completions după el; Open WebUI adaugă acea parte automat.

Copiază ID-ul complet al modelului din lista curentă a OmniProxy. Dacă ID-ul include un prefix de sursă și un slash, păstrează-le și pe acestea. Următoarele două nume scurte sunt doar referințe din documentația furnizorului la data de 09-10-2026. Nu le folosi dacă nu sunt în lista curentă:

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

Nu introduce o cheie de furnizor în Open WebUI. Dacă gateway-ul nu validează cheile, lasă cheia API goală în loc să inventezi o altă cheie.

Browser

Port local 3000

• Deschide pagina de chat
• Finalizează înregistrarea mai întâi
• Apoi deschide setările

În interiorul containerului

Open WebUI

• Nu folosi localhost
• Folosește numele mașinii gazdă în schimb
• URL-ul se termină cu /v1

Același computer

OmniProxy

• Păstrează cheia în gateway
• Folosește lista de modele a gateway-ului
• Apoi revizuiește jurnalele de cereri

Dacă serviciul de model rulează pe gazdă în timp ce Open WebUI rulează într-un container Docker, înlocuiește localhost în URL cu host.docker.internal. Gazda este computerul care rulează Docker direct. Dacă OmniProxy ascultă doar pe acest computer, URL-ul poate fi scris ca http://host.docker.internal:port/v1, înlocuind port cu portul pe care îl folosește efectiv OmniProxy.

Dacă Open WebUI rulează local prin comanda Python din secțiunea anterioară și OmniProxy rulează de asemenea local, folosește 127.0.0.1 sau localhost în adresă. Nu folosi host.docker.internal în acest caz.

Introducerea configurației

În interfața în chineză simplificată a v0.11.4 testată la data de 09-10-2026, numele diferă de Setări > Admin > Conexiuni din instrucțiunile în engleză. Urmează opțiunile afișate în interfața testată, traduse mai jos:

1. Extinde bara laterală stângă.
2. Dă click pe meniul utilizatorului din partea de jos.
3. Dă click pe Setări.
4. În secțiunea de administrator de mai jos, dă click pe Conexiuni externe.
5. Deschide OpenAI API.
6. Dă click pe + la dreapta de Gestionare conexiuni OpenAI API.
7. În dialogul Editare conexiune, introdu URL-ul care se termină în /v1. Păstrează tipul API setat la Chat Completions.
8. Păstrează Metoda de autentificare setată la Cheie (Bearer). Autentificarea Bearer plasează cheia API în cerere pentru verificarea identității. Dacă OmniProxy ți-a dat o cheie, introdu-o sub Cheie API. Dacă gateway-ul nu validează cheile, lasă acest câmp gol. La data de 09-10-2026, atât validarea, cât și o conversație au reușit cu câmpul lăsat gol.
9. Dă click pe Verificare conexiune lângă URL. Dacă OmniProxy furnizează /models, lista de modele va fi preluată aici.
10. Deschide Avansat. Dacă ID Model este lăsat gol, toate modelele returnate de /models la acea adresă vor fi folosite. Doar dacă validarea eșuează, introdu un ID complet din listă sub Adăugare ID Model, apoi dă click pe Adăugare. Adaugă fiecare ID o singură dată; spațiile de la început și de la sfârșit sunt eliminate.
11. Dă click pe Salvare în această fereastră, apoi dă click pe Salvare în colțul din dreapta jos al paginii Conexiuni externe.

Salvarea configurației singură nu înlocuiește validarea. Verificare conexiune solicită endpoint-ul /models al celuilalt serviciu, care listează modelele disponibile. Unele servicii nu furnizează acest endpoint, deci validarea poate raporta o eroare deși chat-ul poate funcționa în continuare. În acel caz, adaugă ID-ul modelului manual.

Verificarea unei sarcini reale

Întoarce-te la pagina de chat, deschide meniul de modele de lângă caseta de introducere și selectează ID-ul complet din lista OmniProxy. Trimite un mesaj foarte scurt, cum ar fi să îi ceri să răspundă cu un singur cuvânt. Un răspuns trebuie să apară efectiv în caseta de chat.

La data de 09-10-2026, această conversație a fost finalizată folosind instalarea Python a v0.11.4. Docker rămâne metoda recomandată, dar testul nu a fost repetat în Docker.

În continuare, deschide jurnalele de cereri ale OmniProxy și confirmă sursa și ID-ul modelului pentru această cerere. A vedea doar o salvare reușită sau a vedea doar modelul în meniu nu contează ca finalizare.

Interfață

Modelul poate fi selectat

• Conexiunile au fost salvate
• Modelul apare în listă
• Trimite o întrebare scurtă

Răspuns

Caseta de chat arată un răspuns

• Nu este un mesaj gol
• Nu este o eroare de conexiune
• Încearcă din nou cu un alt model

Jurnale

Vizibil în gateway

• Sursa este această conexiune
• ID-ul modelului se potrivește
• Nicio cheie nu a fost introdusă pe pagină

Erori comune

• localhost sau 127.0.0.1 a fost folosit în interiorul containerului: Aceste adrese indică containerul în sine, nu gazda. Schimbă adresa la host.docker.internal și confirmă că comanda de pornire include --add-host=host.docker.internal:host-gateway. Inversul se aplică atunci când Open WebUI nu rulează într-un container: folosește o adresă locală în schimb.
• Browserul nu poate deschide pagina: Pentru Docker, verifică portul 3000; pentru Python, verifică portul 8080. În timpul primei porniri, așteaptă ca descărcarea modelului de embedding să se termine. Poți folosi docker ps pentru a confirma dacă containerul rulează. Dacă portul 3000 este deja utilizat, schimbă portul din partea stângă a -p.
• ID-ul din meniul de modele este mai lung decât numele scurt al furnizorului: Folosește ID-ul complet din meniu, incluzând orice slash-uri.
• Toată lumea este deconectată după o actualizare: WEBUI_SECRET_KEY s-a schimbat. Repornește folosind secretul generat prima dată.
• Verificare conexiune eșuează: Adaugă mai întâi manual ID-ul modelului sub Avansat, apoi confirmă-l cu un chat real de o propoziție. Unele servicii nu furnizează /models, deci chat-ul poate funcționa în continuare când validarea raportează o eroare.
• Modelul nu există: Copiază ID-ul din nou din lista curentă a OmniProxy în loc să continui să folosești un nume învechit.

Referințe oficiale

Pentru comenzi de instalare, vezi Open WebUI Quick Start. Pentru pașii de conexiune, vezi instrucțiunile de conexiune compatibile OpenAI. Pentru ID-urile de model folosite în exemple, vezi Claude model overview și Gemini model list.

Înlocuiește fiecare spațiu rezervat cu valori din propria ta configurare OmniProxy. Nu publica niciodată o cheie reală.

Un rezultat salvat sau HTTP 200 singur nu dovedește compatibilitatea completă a Agentului. Verifică sursa și modelul în înregistrarea de apeluri OmniProxy.

Surse oficiale · Open WebUI ↗