Εγκατάσταση του Open WebUI και ρύθμιση του OmniProxy

Το Open WebUI είναι μια διεπαφή συνομιλίας που φιλοξενείται από εσάς, μπορεί να εγκατασταθεί στον δικό σας υπολογιστή ή διακομιστή και μπορεί επίσης να εκτελεστεί εντελώς εκτός σύνδεσης. Δεν είναι δεσμευμένο σε κανέναν πάροχο μοντέλου: μπορεί να συνδεθεί σε εργαλεία όπως το Ollama που εκτελούν μοντέλα τοπικά, καθώς και σε τελικά σημεία συμβατά με OpenAI—διευθύνσεις που παρέχουν υπηρεσίες μοντέλων χρησιμοποιώντας την ίδια μορφή αιτήματος. Αυτό σας επιτρέπει να κάνετε εναλλαγή μεταξύ τοπικών και cloud μοντέλων στο ίδιο παράθυρο.

Είναι κατάλληλο για μακροχρόνια χρήση από ομάδες και οργανισμούς. Οι δυνατότητες που λαμβάνουν ταχύτερες ενημερώσεις εμφανίζονται πρώτα στο Computer, το προϊόν που χρησιμοποιεί το Open WebUI για να δοκιμάσει νέες δυνατότητες.

Πριν ξεκινήσετε

Το Open WebUI είναι διαθέσιμο σε macOS, Linux και Windows. Μπορείτε να το εγκαταστήσετε χρησιμοποιώντας Docker, Python ή Kubernetes. Το Docker συσκευάζει την εφαρμογή και το περιβάλλον εκτέλεσής της σε ένα σχετικά απομονωμένο κοντέινερ και είναι η προτεινόμενη μέθοδος. Εάν το Docker δεν είναι διαθέσιμο, μπορείτε επίσης να χρησιμοποιήσετε την εντολή Python που δοκιμάστηκε παρακάτω. Το Kubernetes είναι ένα σύστημα για την ανάπτυξη και διαχείριση κοντέινερ· δείτε το Quick Start που συνδέεται στο τέλος αυτού του οδηγού για τα αντίστοιχα βήματα.

Επίσημα προτεινόμενο

Docker

• Μία εντολή docker run
• Ανοίξτε το 3000 στο πρόγραμμα περιήγησης
• Τα δεδομένα αποθηκεύονται στον τόμο (volume)

Απλά θέλω να συνομιλήσω

slim image

• Μικρότερο μέγεθος λήψης
• Αλλάξτε την ετικέτα σε :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 είναι μια μικρότερη εικόνα που δεν περιλαμβάνει τοπικά μοντέλα ομιλίας και ενσωμάτωσης (embedding) μέσα στο κοντέινερ, αλλά η διεπαφή συνομιλίας παραμένει διαθέσιμη. Συνεχίστε να χρησιμοποιείτε το :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.

Ένα μοντέλο ενσωμάτωσης (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. Εάν το αναγνωριστικό περιλαμβάνει πρόθεμα πηγής και κάθετο, διατηρήστε τα επίσης. Τα ακόλουθα δύο σύντομα ονόματα είναι μόνο αναφορές από την τεκμηρίωση του παρόχου από τις 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. Εάν το gateway δεν επικυρώνει κλειδιά, αφήστε το API key κενό αντί να επινοήσετε ένα άλλο κλειδί.

Πρόγραμμα περιήγησης

Τοπική θύρα 3000

• Ανοίξτε τη σελίδα συνομιλίας
• Ολοκληρώστε πρώτα την εγγραφή
• Στη συνέχεια ανοίξτε τις ρυθμίσεις

Μέσα στο κοντέινερ

Open WebUI

• Μην χρησιμοποιείτε localhost
• Χρησιμοποιήστε το όνομα του κεντρικού υπολογιστή (host machine name) αντ' αυτού
• Το 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. Κάντε κλικ στις Ρυθμίσεις.
4. Στην ενότητα διαχειριστή παρακάτω, κάντε κλικ στις Εξωτερικές Συνδέσεις.
5. Ανοίξτε το OpenAI API.
6. Κάντε κλικ στο + στα δεξιά της Διαχείρισης Συνδέσεων OpenAI API.
7. Στο παράθυρο διαλόγου Επεξεργασία Σύνδεσης, εισαγάγετε το URL που τελειώνει σε /v1. Διατηρήστε τον τύπο API ορισμένο σε Chat Completions.
8. Διατηρήστε τη Μέθοδο Ελέγχου Ταυτότητας ορισμένη σε Key (Bearer). Ο έλεγχος ταυτότητας Bearer τοποθετεί το API key στο αίτημα για επαλήθευση ταυτότητας. Εάν το OmniProxy σας έδωσε ένα κλειδί, εισαγάγετέ το κάτω από το API Key. Εάν το gateway δεν επικυρώνει κλειδιά, αφήστε αυτό το πεδίο κενό. Στις 09-10-2026, τόσο η επικύρωση όσο και μια συνομιλία πέτυχαν με το πεδίο αφήνοντας κενό.
9. Κάντε κλικ στο Επαλήθευση Σύνδεσης δίπλα στο URL. Εάν το OmniProxy παρέχει /models, η λίστα μοντέλων θα ανακτηθεί εδώ.
10. Ανοίξτε το Advanced. Εάν το Model ID αφεθεί κενό, θα χρησιμοποιηθούν όλα τα μοντέλα που επιστρέφονται από το /models σε αυτήν τη διεύθυνση. Μόνο εάν η επικύρωση αποτύχει, εισαγάγετε ένα πλήρες αναγνωριστικό από τη λίστα κάτω από το Add Model ID και, στη συνέχεια, κάντε κλικ στο Add. Προσθέστε κάθε αναγνωριστικό μόνο μία φορά· τα κενά στην αρχή και στο τέλος αφαιρούνται.
11. Κάντε κλικ στο Save σε αυτό το παράθυρο, στη συνέχεια κάντε κλικ στο Save στην κάτω δεξιά γωνία της σελίδας Εξωτερικών Συνδέσεων.

Η αποθήκευση της διαμόρφωσης από μόνη της δεν αντικαθιστά την επικύρωση. Το Επαλήθευση Σύνδεσης ζητά το τελικό σημείο /models της άλλης υπηρεσίας, το οποίο παραθέτει τα διαθέσιμα μοντέλα. Ορισμένες υπηρεσίες δεν παρέχουν αυτό το τελικό σημείο, επομένως η επικύρωση ενδέχεται να αναφέρει σφάλμα παρόλο που η συνομιλία μπορεί να εξακολουθεί να λειτουργεί. Σε αυτήν την περίπτωση, προσθέστε το αναγνωριστικό μοντέλου χειροκίνητα.

Επαλήθευση μιας πραγματικής εργασίας

Επιστρέψτε στη σελίδα συνομιλίας, ανοίξτε το μενού μοντέλων δίπλα στο πλαίσιο εισαγωγής και επιλέξτε το πλήρες αναγνωριστικό από τη λίστα του OmniProxy. Στείλτε ένα πολύ σύντομο μήνυμα, όπως το να του ζητήσετε να απαντήσει με μία μόνο λέξη. Μια απόκριση πρέπει να εμφανιστεί πραγματικά στο πλαίσιο συνομιλίας.

Στις 09-10-2026, αυτή η συνομιλία ολοκληρώθηκε χρησιμοποιώντας την εγκατάσταση Python της v0.11.4. Το Docker παραμένει η προτεινόμενη μέθοδος, αλλά η δοκιμή δεν επαναλήφθηκε στο Docker.

Στη συνέχεια, ανοίξτε τα αρχεία καταγραφής αιτημάτων του OmniProxy και επιβεβαιώστε την πηγή και το αναγνωριστικό μοντέλου για αυτό το αίτημα. Το να βλέπετε μόνο μια επιτυχημένη αποθήκευση ή μόνο το μοντέλο στο μενού δεν μετράει ως ολοκλήρωση.

Διεπαφή

Το μοντέλο μπορεί να επιλεγεί

• Οι συνδέσεις έχουν αποθηκευτεί
• Το μοντέλο εμφανίζεται στη λίστα
• Στείλτε μια σύντομη ερώτηση

Απόκριση

Το πλαίσιο συνομιλίας εμφανίζει μια απάντηση

• Δεν είναι κενό μήνυμα
• Δεν είναι σφάλμα σύνδεσης
• Δοκιμάστε ξανά με άλλο μοντέλο

Αρχεία καταγραφής (Logs)

Ορατό στο gateway

• Η πηγή είναι αυτή η σύνδεση
• Το Model ID ταιριάζει
• Δεν εισήχθη κλειδί στη σελίδα

Κοινά σφάλματα

• 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 άλλαξε. Επανεκκινήστε χρησιμοποιώντας το μυστικό που δημιουργήθηκε την πρώτη φορά.
• Το Επαλήθευση Σύνδεσης αποτυγχάνει: Πρώτα προσθέστε χειροκίνητα το αναγνωριστικό μοντέλου κάτω από το Advanced, στη συνέχεια επιβεβαιώστε το με μια πραγματική συνομιλία μιας πρότασης. Ορισμένες υπηρεσίες δεν παρέχουν /models, επομένως η συνομιλία μπορεί να εξακολουθεί να λειτουργεί όταν η επικύρωση αναφέρει σφάλμα.
• Το μοντέλο δεν υπάρχει: Αντιγράψτε το αναγνωριστικό ξανά από την τρέχουσα λίστα του OmniProxy αντί να συνεχίσετε να χρησιμοποιείτε ένα παρωχημένο όνομα.

Επίσημες αναφορές

Για εντολές εγκατάστασης, δείτε το Open WebUI Quick Start. Για βήματα σύνδεσης, δείτε τις OpenAI-compatible connection instructions. Για τα αναγνωριστικά μοντέλων που χρησιμοποιούνται στα παραδείγματα, δείτε το Claude model overview και Gemini model list.

Αντικαταστήστε κάθε θέση με τιμές από τη δική σας ρύθμιση OmniProxy. Ποτέ μην δημοσιεύετε πραγματικό κλειδί.

Ένα αποθηκευμένο αποτέλεσμα ή HTTP 200 μόνο του δεν αποδεικνύει πλήρη συμβατότητα Πράκτορα. Ελέγξτε την πηγή και το μοντέλο στην καταγραφή κλήσεων του OmniProxy.

Επίσημες πηγές · Open WebUI ↗