Open WebUI መጫን እና OmniProxy ማዋቀር

Open WebUI በራስዎ ኮምፒውተር ወይም ሰርቨር ላይ ሊጫን የሚችል እና ሙሉ በሙሉ ከመስመር ውጭ (offline) ሊሰራ የሚችል በራስ-የተስተናገደ (self-hosted) የውይይት በይነገጽ ነው። ከማንኛውም አንድ የሞዴል አቅራቢ ጋር የተሳሰረ አይደለም፡ ሞዴሎችን በአካባቢው የሚያሄዱ እንደ Ollama ያሉ መሳሪያዎችን፣ እንዲሁም OpenAI-ተኳሃኝ የመጨረሻ ነጥቦችን (endpoints)—ተመሳሳይ የጥያቄ ቅርጸት በመጠቀም የሞዴል አገልግሎቶችን የሚሰጡ አድራሻዎችን ማገናኘት ይችላል። ይህ በተመሳሳይ መስኮት ውስጥ በአካባቢ እና በደመና ሞዴሎች መካከል እንዲቀያየሩ ያስችልዎታል።

ለቡድኖች እና ድርጅቶች ለረጅም ጊዜ ጥቅም ላይ እንዲውል ተስማሚ ነው። ፈጣን ዝመናዎችን የሚቀበሉ ችሎታዎች በመጀመሪያ በኮምፒውተር (Computer) ውስጥ ይታያሉ፣ Open WebUI አዳዲስ ባህሪያትን ለመሞከር የሚጠቀምበት ምርት።

ከመጀመርዎ በፊት

Open WebUI በ macOS፣ Linux እና Windows ላይ ይገኛል። Docker፣ Python ወይም Kubernetes በመጠቀም መጫን ይችላሉ። Docker አፕሊኬሽኑን እና የሩጫ አካባቢውን በአንጻራዊነት በተገለለ ኮንቴይነር ውስጥ ያጠቃልላል እና የሚመከር ዘዴ ነው። Docker የማይገኝ ከሆነ፣ ከዚህ በታች ያለውን የተፈተነ የ Python ትዕዛዝ መጠቀም ይችላሉ። Kubernetes ኮንቴይነሮችን ለማሰማራት እና ለማስተዳደር የሚያገለግል ስርዓት ነው፤ ለተጓዳኝ ደረጃዎች የዚህ መመሪያ መጨረሻ ላይ የተገናኘውን ፈጣን ጅምር (Quick Start) ይመልከቱ።

በይፋ የሚመከር

Docker

• አንድ docker run ትዕዛዝ
• በአሳሹ ውስጥ 3000 ይክፈቱ
• ውሂብ በዳታ ቮልዩም (volume) ውስጥ ተከማችቷል

መወያየት ብቻ ይፈልጋሉ

ቀጭን (slim) ምስል

• አነስተኛ የማውረጃ መጠን
• መለያውን ወደ :slim ይለውጡ
• የውይይት ተግባር አሁንም ይገኛል

እዚህ አልተሸፈነም

ሁለት ሌሎች አማራጮች

• በእጅ የ Python ጭነት
• Kubernetes ማሰማራት
• ኦፊሴላዊውን ፈጣን ጅምር ይመልከቱ

ከመጀመርዎ በፊት የሚከተሉትን ያዘጋጁ፡

• 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: ውይይቶችን፣ ተጠቃሚዎችን እና ቅንብሮችን በዳታ ቮልዩም (data volume) ውስጥ ያከማቻል። ዳታ ቮልዩም ከኮንቴይነሩ ውጭ ያለ ቦታ ነው ውሂብ ለረጅም ጊዜ የሚቆይበት፣ ስለዚህ ኮንቴይነሩ ከተዘመነ በኋላ ይዘቱ ይቀራል። ይህንን አማራጭ አያስወግዱ።
• --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 የማይገኝ ከሆነ

ፈጣን ጅምር የ Python ጭነት ዘዴንም ያቀርባል። በ2026-10-09፣ የሚከተለው ትዕዛዝ በ 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 ከመጨረሻ ነጥብ ጋር ለመገናኘት የሚጠቀምበት አድራሻ ነው እና በ መደምደሚያ ላይ መሆን አለበት /v1። አያክሉ /chat/completions ከእሱ በኋላ; Open WebUI ያንን ክፍል በራስ-ሰር ይጨምራል።

ሙሉውን የሞዴል መታወቂያ ከ OmniProxy የአሁኑ ዝርዝር ይቅዱ። መታወቂያው የምንጭ ቅድመ-ቅጥያ እና ሰያፍ መስመር የሚያካትት ከሆነ፣ እነሱንም ይጠብቁ። የሚከተሉት ሁለት አጭር ስሞች ከ2026-10-09 ጀምሮ ከአቅራቢ ሰነዶች ማጣቀሻዎች ብቻ ናቸው። በአሁኑ ዝርዝር ውስጥ ከሌሉ አይጠቀሙባቸው:

• Claude API መታወቂያ ለ Claude Sonnet 5.5: claude-sonnet-5-5
• API ስም ለ Gemini 3.8 Flash: gemini-3.8-flash

በ Open WebUI ውስጥ የአቅራቢ ቁልፍ አያስገቡ። ጌትዌይ ቁልፎችን የማያረጋግጥ ከሆነ፣ ሌላ ቁልፍ ከመፍጠር ይልቅ የ API ቁልፉን ባዶ ይተዉት።

አሳሽ

የአካባቢ ፖርት 3000

• የውይይት ገጹን ይክፈቱ
• መጀመሪያ ምዝገባን ያጠናቅቁ
• ከዚያ ቅንብሮችን ይክፈቱ

በኮንቴይነሩ ውስጥ

Open WebUI

• localhost አይጠቀሙ
• ይልቁንስ የአስተናጋጅ ማሽን ስም ይጠቀሙ
• ዩአርኤል በ /v1 ያበቃል

ተመሳሳይ ኮምፒውተር

OmniProxy

• ቁልፉን በጌትዌይ ውስጥ ያቆዩ
• የጌትዌይ ሞዴል ዝርዝርን ይጠቀሙ
• ከዚያ የጥያቄ መዝገቦችን ይገምግሙ

የሞዴል አገልግሎቱ በአስተናጋጁ ላይ ሲሰራ Open WebUI በ Docker ኮንቴይነር ውስጥ ሲሰራ፣ ይተኩ localhost በዩአርኤል ውስጥ ከ host.docker.internal። አስተናጋጁ Dockerን በቀጥታ የሚያሄድ ኮምፒውተር ነው። OmniProxy በዚህ ኮምፒውተር ላይ ብቻ የሚያዳምጥ ከሆነ፣ ዩአርኤሉ ሊጻፍ ይችላል http://host.docker.internal:port/v1፣ በመተካት port OmniProxy በእርግጥ የሚጠቀምበት ፖርት።

Open WebUI በቀደመው ክፍል በ Python ትዕዛዝ በአካባቢው እየሰራ ከሆነ እና OmniProxy እንዲሁ በአካባቢው እየሰራ ከሆነ፣ ይጠቀሙ 127.0.0.1 ወይም localhost በአድራሻው ውስጥ። አይጠቀሙ host.docker.internal በዚህ ሁኔታ።

ውቅሩን ያስገቡ

በ2026-10-09 በተፈተነው የ v0.11.4 ቀለል ያለ የቻይንኛ በይነገጽ ውስጥ፣ ስሞቹ በእንግሊዝኛ መመሪያዎች ውስጥ ከ Settings > Admin > Connections ተለይተዋል። በተፈተነው በይነገጽ ውስጥ የሚታዩትን አማራጮች ይከተሉ፣ ከዚህ በታች ተተርጉሟል፡

1. የግራውን የጎን አሞሌ ያስፋፉ።
2. ከታች ያለውን የተጠቃሚ ምናሌ ጠቅ ያድርጉ።
3. ቅንብሮች (Settings) ጠቅ ያድርጉ።
4. ከታች ባለው የአስተዳዳሪ ክፍል ውስጥ ውጫዊ ግንኙነቶች (External Connections) ጠቅ ያድርጉ።
5. OpenAI API ይክፈቱ።
6. OpenAI API ግንኙነቶችን አስተዳድር (Manage OpenAI API Connections) በስተቀኝ ያለውን + ጠቅ ያድርጉ።
7. በ ግንኙነት አርትዕ (Edit Connection) መገናኛ ውስጥ፣ ዩአርኤሉን በ የሚያበቃ ያስገቡ /v1። የ API አይነትን ወደ የውይይት ማጠናቀቂያዎች (Chat Completions) ያቆዩ።
8. የማረጋገጫ ዘዴ (Authentication Method) ወደ ቁልፍ (Bearer) (Key (Bearer)) ያቆዩ። Bearer ማረጋገጫ ለማንነት ማረጋገጫ የ API ቁልፉን በጥያቄው ውስጥ ያስቀምጣል። OmniProxy ቁልፍ ከሰጠዎት፣ በ API ቁልፍ (API Key) ስር ያስገቡት። ጌትዌይ ቁልፎችን የማያረጋግጥ ከሆነ፣ ይህንን መስክ ባዶ ይተዉት። በ2026-10-09፣ ሁለቱም ማረጋገጫ እና አንድ ውይይት መስኩ ባዶ ሆኖ ተሳክተዋል።
9. ከዩአርኤሉ ቀጥሎ ግንኙነት ያረጋግጡ (Verify Connection) ጠቅ ያድርጉ። OmniProxy የሚያቀርብ ከሆነ /models፣ የሞዴል ዝርዝሩ እዚህ ይወሰዳል።
10. የላቀ (Advanced) ይክፈቱ። የሞዴል መታወቂያ (Model ID) ባዶ ከተተወ፣ በዚያ አድራሻ በ የሚመለሱ ሁሉም ሞዴሎች /models ጥቅም ላይ ይውላሉ። ማረጋገጫው ካልተሳካ ብቻ፣ ከዝርዝሩ ውስጥ ሙሉ መታወቂያ በ የሞዴል መታወቂያ ያክሉ (Add Model ID) ስር ያስገቡ፣ ከዚያ አክል (Add) ጠቅ ያድርጉ። እያንዳንዱን መታወቂያ አንድ ጊዜ ብቻ ያክሉ፤ መሪ እና ተከታይ ክፍተቶች ይወገዳሉ።
11. በዚህ መስኮት ውስጥ አስቀምጥ (Save) ጠቅ ያድርጉ፣ ከዚያ በውጫዊ ግንኙነቶች ገጽ ታችኛው ቀኝ ጥግ ላይ አስቀምጥ (Save) ጠቅ ያድርጉ።

ውቅሩን ብቻ ማስቀመጥ ማረጋገጫን አይተካም። ግንኙነት ያረጋግጡ (Verify Connection) የሌላውን አገልግሎት ይጠይቃል /models የመጨረሻ ነጥብ፣ የሚገኙ ሞዴሎችን የሚዘረዝር። አንዳንድ አገልግሎቶች ይህንን የመጨረሻ ነጥብ አያቀርቡም፣ ስለዚህ ውይይት አሁንም ሊሰራ ቢችልም ማረጋገጫው ስህተት ሊዘግብ ይችላል። በዚያ ሁኔታ፣ የሞዴል መታወቂያውን በእጅ ያክሉ።

በእውነተኛ ስራ ያረጋግጡ

ወደ ውይይት ገጹ ይመለሱ፣ ከግቤት ሳጥኑ ቀጥሎ ያለውን የሞዴል ምናሌ ይክፈቱ እና ከ OmniProxy ዝርዝር ውስጥ ሙሉውን መታወቂያ ይምረጡ። በጣም አጭር መልእክት ይላኩ፣ ለምሳሌ በአንድ ቃል ብቻ እንዲመልስ መጠየቅ። ምላሽ በእርግጥ በውይይት ሳጥኑ ውስጥ መታየት አለበት።

በ2026-10-09፣ ይህ ውይይት የ v0.11.4 የ Python ጭነት በመጠቀም ተጠናቋል። Docker የሚመከር ዘዴ ሆኖ ይቀጥላል፣ ነገር ግን ሙከራው በ Docker ውስጥ አልተደገመም።

በመቀጠል፣ የ OmniProxy ጥያቄ መዝገቦችን ይክፈቱ እና ለዚህ ጥያቄ ምንጩን እና የሞዴል መታወቂያውን ያረጋግጡ። ስኬታማ ቁጠባን ብቻ ማየት፣ ወይም ሞዴሉን በምናሌው ውስጥ ብቻ ማየት እንደ መጠናቀቅ አይቆጠርም።

በይነገጽ

ሞዴሉ ሊመረጥ ይችላል

• ግንኙነቶች ተቀምጠዋል
• ሞዴሉ በዝርዝሩ ውስጥ ይታያል
• አጭር ጥያቄ ይላኩ

ምላሽ

የውይይት ሳጥኑ መልስ ያሳያል

• ባዶ መልእክት አይደለም
• የግንኙነት ስህተት አይደለም
• በሌላ ሞዴል እንደገና ይሞክሩ

ምዝግብ ማስታወሻዎች (Logs)

በጌትዌይ ውስጥ ይታያል

• ምንጩ ይህ ግንኙነት ነው
• የሞዴል መታወቂያ ይዛመዳል
• በገጹ ላይ ምንም ቁልፍ አልገባም

የተለመዱ ስህተቶች

• 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.

እያንዳንዱን የቦታ ያዥ (placeholder) በራስዎ የ OmniProxy ውቅር እሴቶች ይተኩ። እውነተኛ ቁልፍን በጭራሽ አያትሙ።

የተቀመጠ ውጤት ወይም HTTP 200 ብቻውን ሙሉ የAgent ተኳኋኝነትን አያረጋግጥም። በ OmniProxy የጥያቄ መዝገብ ውስጥ ምንጩን እና ሞዴሉን ያረጋግጡ።

ኦፊሴላዊ ምንጮች · Open WebUI ↗