Skip to main content
Open WebUI (ehemals Ollama WebUI) ist ein Open-Source-AI-Client, der mehrere Benutzer, Wissensdatenbanken, RAG und private Bereitstellung unterstützt. Es unterstützt benutzerdefinierte OpenAI-kompatible Endpunkte und kann daher mit Ace Data Cloud verbunden werden. Dieser Artikel stellt den Konfigurationsprozess vor.

Antragsprozess

Um Ace Data Cloud in Open WebUI einzubinden, rufen Sie zunächst die Ace Data Cloud-Konsole auf, um Ihren API-Token abzurufen und für die spätere Verwendung aufzubewahren. Ace Data Cloud API Key abrufen Falls Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach der Anmeldung oder Registrierung kehren Sie automatisch zu dieser Seite zurück. Bei der ersten Beantragung erhalten Sie ein kostenloses Guthaben und können die Modelldienste von Ace Data Cloud kostenlos testen.

Ace Data Cloud bereitstellen und konfigurieren

Open WebUI bindet OpenAI-kompatible Endpunkte über Umgebungsvariablen ein und kann mit einem einzigen Docker-Befehl bereitgestellt werden (ersetzen Sie {token} durch Ihren Token):
Öffnen Sie http://IP-Ihres-Servers:3000; das erste registrierte Konto wird automatisch zum Administrator. Beachten Sie die Pfadregeln der Base URL: Gehen Sie nach der Anmeldung zu Admin Panel → Settings → Connections und klicken Sie auf „Verify Connection“, um die Verbindung zu überprüfen; unter Settings → Models können Sie häufig verwendete Modelle filtern und anheften.
Neben der Verwendung von Umgebungsvariablen unterstützt Open WebUI auch das direkte Hinzufügen von Verbindungen über die Benutzeroberfläche: Gehen Sie zu Admin Settings → Connections, klicken Sie auf ➕ und geben Sie URL (https://api.acedata.cloud/v1) sowie API Key ein. Open WebUI ruft automatisch /models auf, um die Modellliste abzurufen. Weitere Details finden Sie in der offiziellen Dokumentation Starting With OpenAI-Compatible Servers.
Open WebUI Ace Data Cloud Connection-Konfigurationsoberfläche
MODEL_ID wird nur zur Demonstration einer optionalen Allow List verwendet; wenn es leer bleibt, werden alle von /models zurückgegebenen Modelle angezeigt.

Modell auswählen

Der Modellkatalog wird kontinuierlich aktualisiert. Verwenden Sie vorrangig die automatisch vom Client geladene Modellliste; falls eine manuelle Eingabe erforderlich ist, fragen Sie zuerst GET https://api.acedata.cloud/v1/models ab, um die aktuelle Modell-ID zu erhalten, und wählen Sie dann entsprechend der vom Client unterstützten Kontext-, Bild- und Tool-Call-Fähigkeiten.

Anbindung überprüfen

Wenn Sie nicht sicher sind, ob das Problem bei Open WebUI oder im Netzwerk liegt, können Sie zunächst den Endpunkt direkt mit curl überprüfen (ersetzen Sie {token} durch Ihren Token):
Die Rückgabe eines OpenAI-kompatiblen chat.completion-Objekts bedeutet, dass Token und Endpunkt bereit sind; falls HTTP 403 used_up zurückgegeben wird, ist der Token gültig, aber das Guthaben reicht nicht aus. Laden Sie es einfach in der Konsole auf.

Fortgeschritten: Wissensdatenbank und mehrere Benutzer

Die Wissensdatenbank (RAG) von Open WebUI verwendet standardmäßig ChromaDB zum Speichern von Vektoren. Als Einbettungsmodell kann text-embedding-3-large (über Ace Data Cloud) angegeben werden. Die Originaldokumente werden nur auf Ihrem Server gespeichert, und nur die passenden Abschnitte werden an das Modell gesendet. Unter Admin Panel → Users können Sie Benutzerrollen (Pending / User / Admin) verwalten; es wird empfohlen, „Default User Role“ auf pending zu setzen, sodass neue Benutzer erst nach einer Prüfung verwendet werden können, um zu vermeiden, dass Außenstehende sich beliebig registrieren und Guthaben verbrauchen. Wenn Sie einen nginx-Reverse-Proxy verwenden, fügen Sie proxy_buffering off; und client_max_body_size 100M; hinzu.

Häufige Fragen

Meldung Connection error / 404

In der Regel wurde OPENAI_API_BASE_URL als .../openai/v1 angegeben oder /v1 vergessen. Ändern Sie es zu https://api.acedata.cloud/v1.

Nach dem Hochladen eines Dokuments ist keine Unterhaltung möglich

Wählen Sie in den RAG-Einstellungen des Admin Panels als Einbettungsmodell text-embedding-3-large (OpenAI provider) aus.

Daten gehen nach einem Container-Neustart verloren

Beim Start muss das Datenvolume -v open-webui:/app/backend/data eingebunden werden.

Mehr erfahren