התקנת Open WebUI והגדרת OmniProxy

Open WebUI הוא ממשק צ’אט המארח את עצמו שניתן להתקין על המחשב או השרת שלך ויכול גם לפעול במצב לא מקוון לחלוטין. הוא אינו קשור לספק מודל אחד: הוא יכול להתחבר לכלים כגון Ollama המריצים מודלים באופן מקומי, כמו גם לנקודות קצה תואמות 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 מותקן ופועל.
• מחרוזת סודית המשמשת רק אותך. הרץ openssl rand -hex 32 כדי ליצור אחת, ולאחר מכן הזן אותה כ- WEBUI_SECRET_KEY. שמור ערך זה לצמיתות. אם תשנה אותו בעת בנייה מחדש של המיכל, משתמשים שכבר מחוברים ינותקו.
• מופע OmniProxy פועל ומזהה מודל מרשימת המודלים הנוכחית שלו. מזהה המודל הוא השם המלא המשמש לבחירת מודל ספציפי.

התקנה והפעלה בפעם הראשונה

פתח טרמינל והרץ את הפקודה מה-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 היא תמונה קטנה יותר שאינה כוללת מודלי דיבור והטמעה מקומיים בתוך המיכל, אך ממשק הצ’אט נשאר זמין. המשך להשתמש ב- :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, לא פורט 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 עבור 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, החלף את 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, השמות היו שונים מהגדרות > מנהל > חיבורים בהוראות באנגלית. עקוב אחר האפשרויות המוצגות בממשק שנבדק, מתורגמות להלן:

1. הרחב את סרגל הצד השמאלי.
2. לחץ על תפריט המשתמש בתחתית.
3. לחץ על Settings.
4. בסעיף המנהל למטה, לחץ על External Connections.
5. פתח את OpenAI API.
6. לחץ על + מימין ל-Manage OpenAI API Connections.
7. בתיבת הדו-שיח Edit Connection, הזן את ה-URL שמסתיים ב- /v1. שמור על סוג ה-API מוגדר ל-Chat Completions.
8. שמור על Authentication Method מוגדר ל-Key (Bearer). אימות Bearer מציב את מפתח ה-API בבקשה לאימות זהות. אם OmniProxy נתן לך מפתח, הזן אותו תחת API Key. אם ה-gateway אינו מאמת מפתחות, השאר שדה זה ריק. ב-09-10-2026, גם אימות וגם שיחה אחת הצליחו כשהשדה נשאר ריק.
9. לחץ על Verify Connection ליד ה-URL. אם OmniProxy מספק /models, רשימת המודלים תתקבל כאן.
10. פתח את Advanced. אם Model ID נשאר ריק, כל המודלים המוחזרים על ידי /models בכתובת זו ישמשו. רק אם האימות נכשל, הזן מזהה מלא מהרשימה תחת Add Model ID, ולאחר מכן לחץ על Add. הוסף כל מזהה רק פעם אחת; רווחים מובילים וסופיים מוסרים.
11. לחץ על Save בחלון זה, ולאחר מכן לחץ על Save בפינה הימנית התחתונה של דף ה-External Connections.

שמירת ההגדרה לבדה אינה מחליפה אימות. Verify Connection מבקש את נקודת הקצה של /models של השירות האחר, המפרטת מודלים זמינים. חלק מהשירותים אינם מספקים נקודת קצה זו, לכן האימות עשוי לדווח על שגיאה למרות שהצ’אט עדיין יכול לעבוד. במקרה כזה, הוסף את מזהה המודל באופן ידני.

אימות משימה אמיתית

חזור לדף הצ’אט, פתח את תפריט המודלים ליד תיבת הקלט, ובחר את המזהה המלא מרשימת OmniProxy. שלח הודעה קצרה מאוד, כגון לבקש ממנו להשיב במילה אחת בלבד. תגובה חייבת להופיע בפועל בתיבת הצ’אט.

ב-09-10-2026, שיחה זו הושלמה באמצעות התקנת ה-Python של v0.11.4. Docker נשאר השיטה המומלצת, אך הבדיקה לא חזרה על עצמה ב-Docker.

לאחר מכן, פתח את יומני הבקשות של OmniProxy ואשר את המקור ומזהה המודל עבור בקשה זו. ראיית שמירה מוצלחת בלבד, או ראיית המודל בתפריט בלבד, אינה נחשבת כהשלמה.

ממשק

ניתן לבחור את המודל

• החיבורים נשמרו
• המודל מופיע ברשימה
• שלח שאלה קצרה

תגובה

תיבת הצ'אט מציגה תשובה

• זו אינה הודעה ריקה
• זו אינה שגיאת חיבור
• נסה שוב עם מודל אחר

יומנים

גלוי ב-gateway

• המקור הוא חיבור זה
• מזהה המודל תואם
• לא הוזן מפתח בדף

שגיאות נפוצות

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