Schnelle Bereitstellung
Seitenübersicht
Bereitstellungseinstieg und minimaler Ablauf
- Prüfen Sie zuerst Serversystem, Docker, Docker Compose, offene Ports, Lizenzdatei und Installationspaket.
- Für eine schnelle Evaluierung empfiehlt sich das One-Click-Skript; für Auslieferungs- oder Weiterentwicklungsumgebungen empfiehlt sich die docker-compose-Variante, bei der sich Backend-JAR und statische Frontend-Dateien leicht austauschen lassen.
- Prüfen Sie nach dem Start der Dienste in dieser Reihenfolge: Container, Backend-Logs, Datenbank, Cache, MQTT, Web-Seiten und Lizenzseite.
- Durchlaufen Sie abschließend mit MQTTX die Strecke Produkt, Gerät, Meldung und Befehlsausgabe, um sicherzustellen, dass die Umgebung den realen Geschäftsbetrieb tragen kann.
- Auf dem Server sind die Geschäfts-Ports 80, 1883, 8083, 5061, 30000-30100/tcp/udp usw. geöffnet.
- Für die Business-Version sind vor der Bereitstellung Lizenzdatei und Installationspasswort vorbereitet, und die Lizenzinformationen müssen nach Abschluss der Bereitstellung konfiguriert werden.
- Prüfen Sie bei einer erneuten Bereitstellung nach Weiterentwicklung zuerst, ob das Backend-JAR-Paket und das Frontend-Verzeichnis
vueunter/var/dataauf dem neuesten Stand sind.
提示
- Nach der Bereitstellung der Business-Version melden Sie sich am System an; auf der Startseite müssen Sie zuerst die Lizenzinformationen konfigurieren (Chinesisch), bevor Sie das System normal nutzen können
- Für eine erneute Bereitstellung nach Weiterentwicklung ersetzen Sie lediglich das entsprechende fastbee-admin.jar-Paket und den Inhalt des vue-Verzeichnisses unter
/var/data
1. Skript für die schnelle Bereitstellung
Das One-Click-Bereitstellungsskript basiert auf Docker; Docker und docker-compose müssen installiert sein. Der tatsächliche Ablauf entspricht der unten beschriebenen docker-compose-Bereitstellung, gebündelt in einem einzigen Skript, sodass ein einziger Befehl die Bereitstellung abschließt. Der Befehl lautet:
sudo wget -c https://hub.fastbee.cn/resource/install.sh && bash ./install.sh
Hinweise:
- Das Skript enthält die Open-Source- und die Business-Version; die Business-Version steht nur lizenzierten Anwendern zur Verfügung, die Installation erfordert Passwort und Zertifikat (vom Kundendienst erhältlich)
- Das Herunterladen der Dateien während der Bereitstellung dauert entsprechend lange; verwenden Sie für die Installation die offiziellen Docker-Images – das Skript konfiguriert automatisch Registry-Mirrors für höhere Geschwindigkeit
- Öffnen Sie die entsprechenden Ports auf dem Server (z. B. 80, 1883, 8083, 5061, 30000-30100/tcp/udp usw.)
2. Schnelle Bereitstellung mit docker-compose
Für die Bereitstellung mit docker-compose müssen Docker und docker-compose auf dem Server installiert sein
docker-compose installiert die vom Projekt benötigten Anwendungen und die Umgebung gemeinsam auf dem Server oder lokal. Führen Sie die folgenden Schritte aus, um die Installation und Bereitstellung abzuschließen:
2.1. Dateien hochladen
Laden Sie zuerst den Ordner docker/data/ aus dem FastBee-Repository in das Verzeichnis /var/ auf dem Server oder lokal hoch. Bei der Business-Version müssen Backend und Frontend neu gepackt werden: Das Backend laden Sie in das Verzeichnis /var/data/java/ hoch und ersetzen die JAR-Datei; das Frontend laden Sie in das Verzeichnis /var/data/nginx/vue/ hoch und ersetzen dessen Inhalt.
2.2. Bereitstellung starten
Wechseln Sie auf dem Server oder lokal in das Verzeichnis /var/data/ und führen Sie aus: docker-compose up -d – nach der Ausführung ist die Bereitstellung abgeschlossen
2.3. Auf das System zugreifen
- Nach Abschluss der Bereitstellung greifen Sie über die Serveradresse auf die FastBee IoT-Plattform zu; das Standardkonto lautet
admin admin123 - Bei der Bereitstellung wird EMQX verwendet; die EMQX-Konsole erreichen Sie über Port 18083, Standardkonto und -passwort
admin admin123
提示
- Für spätere erneute Bereitstellungen ersetzen Sie lediglich die Datei
fastbee-admin.jarund den Inhalt des Verzeichnissesvue - Die Initialisierung des mysql-Containers benötigt Zeit; falls das Backend einen Fehler meldet, können Sie es mit
docker restart javaneu starten - Standardkonten der schnellen Bereitstellung:
- Systemadministrator: admin admin123
- mysql: root fastbee
- redis: fastbee
- EMQX-Konsole: admin admin123
- TDengine: root taosdata
- SIP: 12345678
- Datenquellen-Monitoring: fastbee fastbee
2.4. Häufig verwendete Befehle während der Bereitstellung
# Sie können die Images der Dienste zuerst herunterladen; die Dauer hängt vom Netzwerk ab, Docker kann für Registry-Mirrors konfiguriert werden
docker-compose pull
# Container der Dienste bauen und starten
docker-compose up -d
# Container der Dienste stoppen und entfernen
docker-compose down
# data-Ordner erstellen
mkdir /var/data
# Lese-, Schreib- und Ausführungsrechte für den Ordner vergeben
sudo chmod 777 /var/data2.5. Konfiguration von Docker-Registry-Mirrors
Führen Sie die folgenden Befehle aus, um die Konfiguration der Registry-Mirrors abzuschließen. Die Adressen der Docker-Registry-Mirrors stammen aus dem Netz und können je nach Situation ergänzt oder entfernt werden
# 1. Docker-Dienst stoppen
sudo systemctl stop docker
# 2. Datei anlegen, falls nicht vorhanden
sudo mkdir -p /etc/docker
# 3. Docker-Konfigurationsdatei ändern
sudo tee /etc/docker/daemon.json <<-EOF
{
"registry-mirrors": [
"https://mirrors.ustc.edu.cn",
"https://docker.chenby.cn",
"http://mirror.azure.cn",
"https://dockerpull.org",
"https://dockerhub.icu",
"https://hub.rat.dev",
"https://dockerproxy.com",
"https://mirror.baidubce.com",
"https://docker.m.daocloud.io",
"https://docker.nju.edu.cn",
"https://docker.mirrors.sjtug.sjtu.edu.cn",
"https://docker.rainbond.cc",
"https://mirror.ccs.tencentyun.com",
"https://registry.docker-cn.com",
"https://hub-mirror.c.163.com",
"https://docker.1ms.run",
"https://doublezonline.cloud",
"https://dislabaiot.xyz",
"https://docker.fxxk.dedyn.io",
"https://docker.unsee.tech",
"https://docker.1panel.live",
"https://docker.nastool.de",
"https://docker.zhai.cm",
"https://docker.5z5f.com",
"https://a.ussh.net",
"https://docker.udayun.com",
"https://hub.geekery.cn",
"https://noohub.ru",
"https://huecker.io",
"https://dockerhub.timeweb.cloud",
"https://0c105db5188026850f80c001def654a0.mirror.swr.myhuaweicloud.com",
"https://5tqw56kt.mirror.aliyuncs.com",
"https://docker.ckyl.me/",
"https://docker.hpcloud.cloud"
]
}
EOF
# 5. Docker-Dienst neu starten
sudo systemctl daemon-reload
sudo systemctl start docker3. Prüfung des Bereitstellungsergebnisses
Nach der Bereitstellung sollten Sie nicht nur prüfen, ob die Seite geöffnet wird. Es empfiehlt sich eine vollständige Abnahme in der Reihenfolge „Container, Backend, Datenbank, Cache, MQTT, Geschäftsseiten".
3.1. Container-Status
cd /var/data
docker-compose ps
docker psAlle Kern-Container sollten laufen. Falls die Container java, mysql, redis, emqx oder nginx wiederholt neu starten, prüfen Sie zuerst die entsprechenden Logs.
docker logs -n 200 java
docker logs -n 200 mysql
docker logs -n 200 redis
docker logs -n 200 emqx
docker logs -n 200 nginx3.2. Backend-Dienst
docker logs -n 300 javaVergewissern Sie sich insbesondere, dass die folgenden Fehler nicht dauerhaft auftreten:
- Datenbankverbindung fehlgeschlagen.
- Redis-Authentifizierung fehlgeschlagen.
- Lesen der Lizenzdatei fehlgeschlagen.
- Port belegt.
- SQL-Initialisierung fehlgeschlagen.
- Verbindung zur Zeitreihendatenbank fehlgeschlagen.
Wenn die MySQL-Initialisierung langsam ist, können Sie nach einem ersten Fehlstart des Backends 1–2 Minuten warten und es dann neu starten:
docker restart java3.3. Web-Seiten
Aufruf im Browser:
http://<Server-IP>/Standardkonto:
| Benutzer | Passwort |
|---|---|
admin | admin123 |
Öffnen Sie nach der Anmeldung mindestens die folgenden Seiten, um die Verfügbarkeit der Schnittstellen zu bestätigen:
| Seite | Abnahmekriterium |
|---|---|
| Startseite | Statistikkarten und Menüs laden normal |
| Produktverwaltung | Liste lässt sich öffnen, Schaltfläche „Neu" funktioniert |
| Geräteverwaltung | Liste lässt sich öffnen, Einstieg zu den Gerätedetails funktioniert |
| Systemverwaltung | Seiten für Benutzer, Rollen und Menüs lassen sich öffnen |
| Lizenzseite | In der Business-Version können Lizenzinformationen hochgeladen oder angezeigt werden |
3.4. MQTT-Dienst
Adresse der EMQX-Konsole:
http://<Server-IP>:18083/Standardkonto:
| Benutzer | Passwort |
|---|---|
admin | admin123 |
Prüfen Sie nach dem Öffnen der Konsole, ob die Listener normal sind. Anschließend können Sie mit MQTTX eine Verbindung aufbauen, wie unter Vollständiger Kreislauf vom Produkt zum Gerät (Chinesisch) beschrieben.
3.5. Minimale Geschäftsprüfung
Der entscheidende Maßstab für die Abnahme ist nicht, dass die Container laufen, sondern dass die Plattform eine reale Geschäftsstrecke durchlaufen kann:
- Produkt anlegen.
- Thing-Modell definieren.
- Produkt veröffentlichen.
- Gerät anlegen.
- MQTTX mit der Plattform verbinden.
- Eigenschaftsdaten melden.
- Befehl von der Plattform ausgeben.
Die vollständigen Schritte finden Sie unter Vollständiger Kreislauf vom Produkt zum Gerät (Chinesisch).
4. Docker-Tutorial
Docker ist eine Open-Source-Container-Engine, mit der Entwickler ihre Anwendungen samt Abhängigkeiten in ein leichtgewichtiges, portierbares Image paketieren und anschließend auf jeder gängigen Linux- oder Windows-Maschine veröffentlichen können; auch Virtualisierung ist möglich. Container nutzen durchgängig einen Sandbox-Mechanismus und haben untereinander keine Schnittstellen (ähnlich wie Apps auf dem iPhone); vor allem ist der Performance-Overhead von Containern äußerst gering.
4.1. Docker installieren
提示
- Docker-Images werden standardmäßig aus dem offiziellen Repository bezogen; wenn der Download langsam ist, können Sie ein Registry-Mirror konfigurieren, Referenzanleitung
- Die Desktop-Installation enthält bereits die Docker-Engine und Docker Compose. Auf Servern werden in der Regel Docker Engine und Docker Compose separat installiert
Docker unter Linux installieren
Docker Desktop unter Windows installieren
- Referenzanleitung (empfohlen: zuerst das WSL-Subsystem und Windows Terminal installieren, dann Docker)
- Docker-Installationsanleitung
Docker Desktop unter macOS installieren
4.2. Häufig verwendete Docker-Befehle
docker -v # Docker-Version anzeigen, prüfen, ob die Installation erfolgreich war
docker ps # Laufende Container anzeigen
docker ps -a # Alle Container anzeigen
docker images # Lokale Images anzeigen
docker info # Systemweite Docker-Informationen anzeigen
docker pull [image] # Image herunterladen
docker run [image] # Container starten
docker restart [container] # Container neu starten
docker stop [container] # Container stoppen
docker stats [container] # Ressourcennutzung des Containers anzeigen
docker inspect [container] # Container-Metadaten anzeigen
docker logs -n 1000 [container] # Die ersten 1000 Log-Zeilen des Containers anzeigen
docker exec -it [container] /bin/bash # Einen laufenden Container betreten
docker save nginx:latest > nginx.tar # Ein einzelnes Image speichern
docker load -i nginx.tar # Image aus einer tar-Datei laden
docker network create -d bridge fastbee-bridge # Ein neues Netzwerk mit dem Namen fastbee-bridge erstellen
docker network ls # Alle Netzwerke anzeigen
docker network connect fastbee-bridge test # Den Container test dem benutzerdefinierten Netzwerk hinzufügen
docker inspect fastbee-bridge # Container im Netzwerk fastbee-bridge anzeigen4.3. Docker-Netzwerkmodi
Docker kennt 5 Netzwerkmodi, die über --net=*** für den Container angegeben werden.
bridge-Modus # Standard; für den Zugriff von außen auf Dienste im Container werden die IP des Hosts und der Host-Port verwendet
host-Modus # Die IP-Adresse des Containers ist die IP-Adresse des Hosts
container-Modus # Der Container teilt sich die Netzwerkumgebung eines anderen Containers
overlay-Modus # Kommunikation über Hosts hinweg
none-Modus # Dem Container wird keine Netzwerkumgebung zugewiesen, er kann nur das lokale Netz 127.0.0.1 verwenden4.4. Docker-Bridge-Netzwerk
Das Bridge-Netzwerk dient der Kommunikation zwischen Containern. Wenn die Container einzeln betrieben werden, erstellen Sie das Bridge-Netzwerk mit folgendem Befehl:
docker network create -d bridge fastbee-bridge4.5. Häufig verwendete docker-compose-Befehle
docker-compose -v # docker-compose-Version anzeigen, prüfen, ob die Installation erfolgreich war
docker-compose up -d # Container der Dienste bauen und starten
docker-compose down # Container der Dienste stoppen und entfernen
docker-compose ps # Alle Container des Dienstes auflisten
docker-compose start # Container des Dienstes starten
docker-compose stop # Laufende Container des Dienstes stoppen
docker-compose restart # Container des Dienstes neu starten
docker-compose logs # Ausgabe der Container des Dienstes anzeigen
docker-compose pull # Von den Diensten benötigte Images herunterladen
docker-compose config # Compose-Dateikonfiguration prüfen und anzeigen