Basierend auf Docker und Pagoda Panels: Ein detaillierter Leitfaden für den privaten Einsatz von Coze Studio Open Source Edition

Vor kurzem hat die Plattform zur Entwicklung von KI-Anwendungen Coze kündigte das offizielle Open-Sourcing seiner Studio Version und stellt einen wichtigen Meilenstein für die Entwicklergemeinschaft dar. Diese Initiative bedeutet, dass Entwickler das Visual Intelligentsia (Agent) Development Kit von Coze privat einsetzen können, um KI-Anwendungen mit Datensicherheit und Versionsstabilität zu erstellen und zu verwalten.

Für Unternehmen und Entwickler sind lokalisierte Bereitstellungen ein zentrales Problem, das lange Zeit von Cloud-Diensten abhing. Unerwartete Ausfälle, die durch Iterationen von Cloud-Plattformen oder Plugin-Änderungen ausgelöst werden können, stellen ein erhebliches Risiko für laufende Projekte dar. Open-Source-Versionen hingegen geben den Entwicklungsteams die vollständige Kontrolle und gewährleisten langfristig stabile Arbeitsabläufe.

In diesem Tutorial erfahren Sie, wie Sie dies auf einem Cloud-Server tun können Atelier Coze der lokalisierten Bereitstellung. Der gesamte Prozess folgt einer schrittweisen Darstellung, die von Entwicklern aller Erfahrungsstufen erfolgreich praktiziert werden kann.

Geschätzte Bearbeitungszeit: ca. 25 Minuten
Technische Voraussetzungen: Vertrautheit mit grundlegenden Linux-Befehlszeilenoperationen und Verständnis von Docker-Konzepten.

Überblick über den Bereitstellungsprozess:

1. Vorbereiten von Cloud-Servern
2. Konfigurieren der Serverumgebung
3. Einsätze Atelier Coze
4. Abrufen und Konfigurieren des Modell-API-Schlüssels
5. Coze Studio starten und aufrufen

I. Vorbereiten von Cloud-Servern

Für den Einsatz von Coze Studio ist mindestens ein 2-Kern 4G Konfigurierte Cloud-Server.

1. Wählen Sie einen Cloud-Service-Anbieter und melden Sie sich bei ihm an. Bei den leichtgewichtigen Anwendungsservern von Tencent Cloud zum Beispiel haben neue Nutzer in der Regel Anspruch auf ein kostenloses Testguthaben.
2. Rufen Sie die Service Provider-Konsole auf und wählen Sie Server kaufen. In den Konfigurationsoptionen wird das Bild (Image) empfohlen, um einen Server mit vorinstallierten Pagoda Linux Panel 8.1.0 Dies vereinfacht die spätere Konfiguration der Umgebung. Die Region kann je nach Zugriffsgeschwindigkeit ausgewählt werden.

3. Nachdem Sie eine Instanz erstellt haben, suchen Sie auf der Server-Administrationsseite die Funktion "Login" oder "Terminal" und rufen die Befehlszeilenschnittstelle des Servers auf.

4. Führen Sie nach dem Einloggen den folgenden Befehl aus, um den Standard-Port des Pagoda-Panels zu ändern (von 8888 auf 8887), um Konflikte mit dem Standard-Port von Coze zu vermeiden.

   echo "8887" > /www/server/panel/data/port.pl
   sudo /etc/init.d/bt default
   

   Nach der Ausführung gibt das Terminal die neue Panel-Zugangsadresse, den Benutzernamen und das Passwort aus. Achten Sie darauf, diese Informationen zu kopieren und zu speichern.

   

5. Als nächstes müssen Sie die Firewall-Regeln des Servers so konfigurieren, dass die von Coze Studio benötigten Ports geöffnet werden. Gehen Sie zur Seite mit den Firewall- oder Sicherheitsgruppeneinstellungen des Servers, fügen Sie die Regel hinzu und geben Sie sie frei 8887 im Gesang antworten 9999 Zwei Anschlüsse.

II. die Konfiguration der Serverumgebung

1. Öffnen Sie das Pagoda-Panel in Ihrem Browser unter Verwendung der zuvor gespeicherten "Extranet-Panel-Adresse". Wenn die Adresse mit login Endung nicht geöffnet werden kann, versuchen Sie, die URL-Endung in tencentcloud.

2. Geben Sie Ihren gespeicherten Benutzernamen und Ihr Passwort ein, um sich anzumelden. Wenn Sie sich das erste Mal anmelden, müssen Sie ein offizielles Pagoda-Konto einrichten.

3. Nach der Anmeldung erscheint ein Pop-up-Fenster mit empfohlenen Paketen, die Sie installieren sollten. Markieren Sie einfach das erste Paket und installieren Sie es! Nginxund der Rest ist nicht angekreuzt.

4. Klicken Sie im linken Menü des Pagoda-Bedienfelds auf "Software Store" und wählen Sie "App-Kategorien". Docker-Manager und installieren Sie es. Der Installationsvorgang kann einige Zeit dauern.

5. Sobald die Installation abgeschlossen ist, aktualisieren Sie die Seite. Öffnen Sie das "Terminal"-Tool auf der linken Seite und führen Sie den folgenden Befehl aus, um ihn zu überprüfen Docker im Gesang antworten Docker Compose Ob die Installation erfolgreich war oder nicht. Wenn Sie die Ausgabe der Versionsnummer sehen, ist die Umgebung bereit.

   docker -v
   docker-compose -v
   

   

Einsatz von Coze Studio

1. Gehen Sie im Pagoda-Panel zur Dateiverwaltung und suchen Sie die Datei /home erstellen Sie ein neues Verzeichnis mit dem Namen Coze des Ordners.

2. Gehen Sie zu dem neu erstellten Coze klicken Sie oben auf die Schaltfläche "Terminal", um ein neues Terminalfenster zu öffnen. Führen Sie Folgendes aus git Befehl Klonen Coze Studio Quellcode-Repository.

   git clone https://github.com/coze-dev/coze-studio.git
   

   

   Alternatives ProgrammWenn ein Netzwerkproblem Folgendes verursacht git clone Langsam oder nicht, können Sie direkt besuchen GitHub-Repository-Adresse Laden Sie das ZIP-Archiv herunter und laden Sie es auf das Serververzeichnis /home/Coze Verzeichnis und entpacken Sie es.

   

   

Abrufen und Konfigurieren des Modell-API-Schlüssels

Coze Studio Ein großes Sprachmodell muss verbunden werden, damit es läuft. Das Tutorial verwendet den Ark-Modelldienst der Volcano Engine als Beispiel, um zu zeigen, wie man die API Key und Modellzugangspunkte Endpoint ID.

4.1 Beschaffung von Volcano Engine Model Credentials

1. Zugang und Anmeldung Vulkanmotor Konsole, gehen Sie zur Arche-Modellierungsplattform.

2. Wählen Sie "Online Reasoning" im linken Menü und klicken Sie auf "Create Reasoning Access Point".

3. Benennen Sie den Zugangspunkt (z. B. DeepSeek-R1) und wählen Sie ein Basismodell wie das deepseek-v2Wenn Sie aufgefordert werden, dass das Modell nicht geöffnet ist, folgen Sie bitte den Anweisungen, um den Vorgang abzuschließen. Wenn Sie aufgefordert werden, dass das Modell nicht geöffnet ist, folgen Sie bitte den Anweisungen, um die Öffnung abzuschließen (kostenlos).

4. Nach erfolgreicher Erstellung finden Sie den soeben erstellten Zugangspunkt in der Liste."Zugangspunkt-ID" (Endpunkt-ID), die für nachfolgende Konfigurationen erforderlich ist. model. Bitte kopieren und speichern Sie es.

5. Klicken Sie auf die Schaltfläche "API-Aufruf" rechts neben dem Zugangspunkt, und wählen Sie dann eine Option aus oder erstellen Sie eine API Key.

6. eine Kopie machen von Access Key ID im Gesang antworten Secret Access Key.Secret Access Key Er wird nur einmal angezeigt, also speichern Sie ihn sofort. Hier ist Secret Access Key die für nachfolgende Konfigurationen des Systems erforderlich ist api_key.

4.2 Konfigurieren der Coze Studio-Modelldateien

1. Gehen Sie zurück zum Pagodenpanel und geben Sie /home/Coze/coze-studio klicken Sie oben auf Terminal und führen Sie den folgenden Befehl aus, um eine Kopie der Modellprofilvorlage zu erstellen.

   cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml
   

   

2. Öffnen Sie mit dem Dateieditor von Pagoda die soeben erstellte ark_doubao-seed-1.6.yaml Dokumentation.

   Pfad:/home/Coze/coze-studio/backend/conf/model/ark_doubao-seed-1.6.yaml

   

3. Ändern Sie drei Felder in der Datei:
   • idIdentifier: Ein eindeutiger Bezeichner für das Modell, der eine ganze Zahl ungleich Null sein muss. Zum Beispiel ein Wert, der auf 888. Bitte ändern Sie sie nicht mehr, nachdem sie online gegangen ist.
   • meta.conn_config.api_keyEinfügen der zuvor gespeicherten Volcano Engine Geheimer Zugangsschlüssel.
   • meta.conn_config.modelEinfügen der zuvor gespeicherten Volcano Engine Zugangspunkt-ID (Endpunkt-ID).

   
   

4. Nachdem Sie die Richtigkeit der Änderungen bestätigt haben, speichern Sie die Datei.

V. Starten von und Zugriff auf Coze Studio

1. zurück zu /home/Coze/coze-studio und öffnen Sie das Terminal erneut. Führen Sie die folgenden Befehle aus, um in den docker Verzeichnis, erstellen Sie Dateien mit Umgebungsvariablen und starten Sie alle Dienste.

   cd docker
   cp .env.example .env
   docker compose --profile '*' up -d
   

   

2. Beim ersten Start dauert es eine Weile, bis mehrere Docker-Images geladen und erstellt sind, also haben Sie bitte etwas Geduld. Wenn das Terminal Folgendes ausgibt Container coze-server Started oder eine ähnliche Erfolgsmeldung, und es werden keine neuen Protokolle mehr übertragen, ist der Dienst erfolgreich gestartet.
3. Die eingesetzte Coze Studio. Die Zugangsadresse lautet:
   http://<你的服务器公网IP>:9999

   Oberbefehlshaber (Militär) <你的服务器公网IP> Ersetzen Sie diese durch die IP-Adresse, die in der oberen linken Ecke des Pagodenfensters angezeigt wird.

   

   Sobald sich die Seite öffnet, folgen Sie den Aufforderungen zur Registrierung Ihres ersten Administratorkontos, um mit der Erforschung und dem Aufbau Ihrer KI-Intelligenzen in Ihrer lokalen Umgebung zu beginnen.