Welche Linux-Distributionen werden vom Query Streams Agent unterstützt?

Das .deb-Paket unterstützt Ubuntu 20.04+ und Debian 11+. Das .tar.gz-Paket mit install.sh funktioniert auf allen Linux x86-64-Distributionen, einschließlich RHEL 8+, CentOS Stream, Fedora und Amazon Linux 2.

Muss für den Query Streams Agent unter Linux ein Firewall-Port geöffnet werden?

Nein. Der Agent stellt ausschließlich ausgehende HTTPS-Verbindungen über Port 443 her. Es sind keine eingehenden Firewall-Regeln erforderlich.

So installieren Sie den Query Streams Agent unter Linux

9 Minuten Lesezeit

Linux-Netzwerkagent

Query Streams unter Linux installieren

Führen Sie den nur ausgehenden Query Streams Network Agent auf Ubuntu, Debian, RHEL oder einem beliebigen x86-64 Linux-Server aus. Ein Installationsskript registriert ihn als systemd-DienstNutzen Sie das lokale Agenten-Dashboard unter http://localhost:1823 Um den Agenten zu registrieren und Datenkonnektoren zu verwalten, können Sie gespeicherte Abfragen im Query Streams-Portal für Excel, Google Sheets, Automatisierung, REST-APIs, MCP und Nova AI erstellen.

Lokale Verbindungskonfiguration Keine eingehenden Firewall-Ports Läuft als systemd-Dienst

bash — user@ubuntu

$tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz

$sudo bash install.sh|

>[5/5] Der Dienst läuft.

>Web-UI: http://localhost:1823

querystreams-agent.service aktiv (läuft)

Installation auf einem anderen Betriebssystem?

Fenster

macOS

Sehen Sie, was Query Streams alles kann, nachdem der Linux-Agent online ist. Startet kostenlos

Connectoren

+ APIs

Live-Daten

Gespeicherte SQL-Anweisungen direkt aus Tabellenkalkulationen ausführen

Excel Blätter

BI & KI-Analytik

Stellen Sie Nova Fragen über verbundene Daten.

Treffen mit Nova

REST-API für Datenbanken

Gespeicherte Abfragen in sichere Endpunkte umwandeln

Erstellen Sie eine API

+mehr

Automatisierung

Synchronisierungen planen und Live-Ergebnisse übertragen

Erkunden Sie

+mehr

API zu SQL

Abfrage von SaaS-APIs mit SQL

Erkunden Sie

KI-Datenbank MCP

Lassen Sie KI-Tools Konnektoren direkt abfragen.

Connect AI

Query Streams ist eine sichere Echtzeit-Datenzugriffsplattform, die es Linux-Serverteams ermöglicht, Live-Datenbankergebnisse mit Excel, Google Sheets, Automatisierungen, MCP-kompatiblen KI-Tools und partnerfähigen REST-APIs zu teilen. Weitere Informationen finden Sie unter QueryStreams.com. und kostenlos anmelden um Ihren ersten Linux-Agenten zu installieren.

Diese Anleitung beschreibt die Installation des Agenten auf Ubuntu-, Debian- und RHEL-basierten Linux-Distributionen. Das Paket enthält eine Installationsskript mit einem Befehl dadurch wird ein dedizierter Bereich geschaffen Abfrageströme Dienstbenutzer kopiert Dateien nach /opt/querystreams/agent/und registriert ein systemd-Dienst Das startet automatisch beim Systemstart und aktualisiert sich im Hintergrund. Fügen Sie Ihre Datenkonnektoren im lokalen Agent-Dashboard hinzu und erstellen Sie anschließend Ihre erste gespeicherte Abfrage über das Query Streams-Portal.

Bevor Sie beginnen

Unterstützte Distributionen

Ubuntu 20.04+ und Debian 11+ über die .deb Paket oder RHEL 8+, CentOS Stream 8+, Fedora 36+, und Amazon Linux 2 über das Universelle .tar.gz Archiv. Nur für x86-64 (AMD64).

sudo / Root-Zugriff

Erforderlich sind das Ausführen des Installationsskripts, das Erstellen des dedizierten Dienstbenutzers und das Registrieren der systemd-Unit. Der Agent selbst läuft ohne Root-Rechte. Abfrageströme Anschließend Bericht erstatten.

Ausgehendes HTTPS

Der Agent benötigt ausgehenden HTTPS-Zugriff über Port 443, um die Cloud-Dienste von Query Streams abzufragen. Es ist keine eingehende Firewall-Regel erforderlich.

Datenbanknetzwerkzugriff

Installieren Sie den Agenten auf einem Linux-Server im selben Netzwerk, derselben VPC oder derselben routingfähigen Umgebung wie Ihre Datenbank oder API-Quelle.

Schritt 1: Laden Sie den Linux-Agenten herunter

Anmelden my.querystreams.com/download.
Wählen Linux aus den Agent-Downloadoptionen.
Laden Sie die .deb Paket (Ubuntu/Debian) oder das .tar.gz Archiv (RHEL, CentOS, Fedora, Amazon Linux oder eine andere Distribution).
Kopieren Sie Ihren Organisationsauthentifizierungsschlüssel von derselben Downloadseite. Sie benötigen ihn, wenn das lokale Agent-Dashboard geöffnet wird. Wenn Sie die Installation von einem anderen Rechner aus durchführen, übertragen Sie die Datei zuerst: scp querystreams-agent_x.x.x_linux-x64.tar.gz user@your-server:/tmp/

Schritt 2: Installationsskript ausführen

Option A — .deb-Paket (Ubuntu / Debian): Die Paketskripte übernehmen die Dienstregistrierung automatisch.

bash — Ubuntu / Debian

# Installation – die Paketskripte erledigen alles automatisch sudo dpkg -i querystreams-agent_x.x.x_amd64.deb # Beheben Sie fehlende Abhängigkeiten, falls Sie dazu aufgefordert werden sudo apt-get install -f

Option B — .tar.gz-Archiv (RHEL / CentOS / Fedora / jede Distribution):

bash — RHEL / CentOS / jede Distribution

# Archiv extrahieren tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz # Installationsskript ausführen (kopiert nach /opt/querystreams/agent/, registriert den systemd-Dienst) sudo bash install.sh

Beide Optionen erzeugen das Abfrageströme Dienstbenutzer kopiert Dateien nach /opt/querystreams/agent/, installiert und aktiviert die querystreams-agent.service systemd-Unit, und startet sie sofort.

Sobald der Dienst läuft, ist das lokale Dashboard verfügbar unter http://localhost:1823 auf dem Server (direkt oder über einen SSH-Tunnel von Ihrer Workstation aus). Hier geben Sie Ihren Authentifizierungsschlüssel ein und verwalten lokale Datenkonnektoren. Ihre Datenbankzugangsdaten verbleiben auf dem Agent-Rechner und werden nicht an die Query Streams Cloud gesendet.

Schritt 3: Verbinden Sie den Agenten mit Ihrem Konto

Im lokalen Agenten-Dashboard unter http://localhost:1823Fügen Sie Ihren Query Streams-Authentifizierungsschlüssel ein.
Speichern Sie den Schlüssel und warten Sie, bis sich der Agent bei Ihrer Organisation registriert hat.
Prüfen Sie, ob der Dienst einwandfrei funktioniert: sudo systemctl status querystreams-agent — es sollte sich zeigen aktiv (läuft).
Auswählen Datenquellen hinzufügen Um den Assistenten für lokale Verbindungen zu öffnen.

Schritt 4: Fügen Sie Ihre erste Datenquelle im lokalen Agenten hinzu

Fügen Sie keine Konnektoren über das Query Streams-Portal hinzu oder bearbeiten Sie diese. Die Einrichtung der Konnektoren erfolgt im lokalen Netzwerkagenten-Dashboard unter http://localhost:1823Hier können Sie Datenbank- oder API-Konnektoren wie PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation oder iTick hinzufügen, bearbeiten, testen und löschen.

Öffnen Sie einen Browser auf dem Linux-Agent-Rechner (oder über einen SSH-Tunnel) und gehen Sie zu http://localhost:1823.
Klicken Sie auf Datenquellen hinzufügen oder öffnen Sie den Agentenverbindungsbereich.
Wählen Sie Ihren Datenbank- oder API-Konnektortyp.
Geben Sie gültige Verbindungsdaten vom Linux-Agent-Rechner ein.
Wählen Sie bei Aufforderung einen Datenbereich aus.
Testen Sie die Verbindung und speichern Sie sie anschließend.
Bei unterstützten Datenbankkonnektoren sollte Schema Intelligence aktiviert bleiben, damit Query Builder, Nova AI und MCP-Clients einen umfassenderen Tabellen- und Spaltenkontext erhalten.

PostgreSQLHost, Port, Datenbank, SSL

MySQL / MariaDBHost, Port, Datenbank, SSL

SQL-ServerServer, Datenbank, Benutzername, Passwort

Lokale DateienSQLite, DuckDB

API-ConnectorenAnmeldeinformationen, Synchronisierungszeitplan, Datenbereich

MCP-fähigKI-Clients können Konnektoren direkt abfragen.

Netzwerkmodell

# Konnektorverwaltung Dashboard des lokalen Agenten: http://localhost:1823 # Linux-Agent Läuft als systemd-Dienst, speichert Anmeldeinformationen lokal und stellt ausgehende Verbindungen her. # Ihre Datenbank/API Private Netzwerkverbindung vom Agenten # Abfragestreams Cloud Empfängt Metadaten des Konnektors und leitet Abfrageanfragen weiter

Schritt 5: Erstellen und Speichern Sie Ihre erste Abfrage

Nachdem Konnektor und Datenbank im Agenten konfiguriert wurden, öffnen Sie das Query Streams-Portal und erstellen Sie mit dem Abfrage-Generator Ihre erste gespeicherte Abfrage. Diese gespeicherte Abfrage kann von Excel, Google Sheets, Automatisierungen, sicheren REST-API-Endpunkten und freigegebenen Benutzern ausgeführt werden, ohne dass Ihre SQL-Rohdaten oder Datenbankanmeldeinformationen sichtbar sind.

Öffnen Abfrage-Generator im Query Streams-Portal.
Wählen Sie den Datenkonnektor und die Datenbank aus, die Sie im lokalen Agenten konfiguriert haben.
Schreiben oder generieren Sie eine SQL-Abfrage und führen Sie eine Vorschau durch.
Speichern Sie die Abfrage unter einem aussagekräftigen Namen und fügen Sie alle Filter hinzu, die die Benutzer anpassen sollen.
Die gespeicherte Abfrage kann aus Microsoft Excel, Google Sheets, Automatisierungen, REST-APIs oder freigegebenen Dashboards ausgeführt werden.

Lokaler Vertreter

Konnektoren hinzufügen, bearbeiten, testen und löschen bei localhost:1823.

Abfrage-Generator

Konnektor auswählen, Datenbank auswählen, SQL-Anweisung schreiben, Vorschau anzeigen und speichern.

Benutzerwerkzeuge

Gespeicherte Abfragen sind in Excel, Google Sheets, Automatisierungen und APIs verfügbar.

MCP-Zugang

MCP-Clients können außerdem verfügbare Konnektoren einsehen und die Datenbank direkt über den Agenten abfragen.

Service Management Referenz

bash – allgemeine Verwaltungsbefehle

# Starten / Stoppen / Neustarten sudo systemctl start querystreams-agent sudo systemctl stop querystreams-agent sudo systemctl restart querystreams-agent # Aktuellen Status prüfen sudo systemctl status querystreams-agent # Live-Protokolle verfolgen sudo journalctl -u querystreams-agent -F # Die letzten 100 Protokollzeilen anzeigen sudo journalctl -u querystreams-agent -n 100 –no-pager

Deinstallieren des Agenten

Das Paket beinhaltet ein uninstall.sh Ein Skript, das den Dienst stoppt, Dateien entfernt und optional Ihre Konfiguration und Protokolle beibehält.

bash — Ubuntu / Debian (.deb-Deinstallation)

# Paket entfernen (Konfigurationsdateien bleiben erhalten) sudo dpkg -r querystreams-agent # Vollständige Bereinigung – entfernt auch Konfiguration, Protokolle und Dienstbenutzer sudo dpkg –purge querystreams-agent

bash --tar.gz Deinstallation

sudo bash /opt/querystreams/agent/uninstall.sh

Das Deinstallationsskript wird Sie auffordern: „Konfiguration und Protokolle beibehalten? (j/N)“ - eingeben y um Ihre appsettings.json und Protokolle/ Ordner oder N Alles entfernen.

Fehlerbehebung

Der Agent ist online nicht zu finden. +

Serviceprotokolle prüfen: sudo journalctl -u querystreams-agent -n 50 --no-pagerHäufige Ursachen: Falscher Authentifizierungsschlüssel, der in der lokalen Web-Benutzeroberfläche eingegeben wurde. http://localhost:1823; ausgehender Port 443 wird von einer Firewall blockiert (Test mit curl -v https://my.querystreams.com); DNS-Auflösungsfehler (nslookup my.querystreams.com).

Ein Datenbankverbindungstest schlägt fehl. +

Führen Sie den Test von dem Linux-Rechner aus durch, auf dem der Agent installiert ist. Der Agent muss den Datenbankhost und -port direkt erreichen können. Stellen Sie außerdem sicher, dass der Datenbankbenutzername Lesezugriff auf die Tabellen oder Sichten hat, die Sie abfragen möchten.

Muss ich eingehende Firewall-Ports öffnen? +

Nein. Der Agent erstellt eine verschlüsselte ausgehende Verbindung zu Query Streams. Abfrageanfragen werden über diese Verbindung übertragen, sodass PostgreSQL, MySQL, SQL Server oder andere Datenbanken nicht dem öffentlichen Internet ausgesetzt sind.

Wo werden die Zugangsdaten für die Datenbank gespeichert? +

Die Zugangsdaten für die Datenbank werden gespeichert in /opt/querystreams/agent/appsettings.json auf dem Agentenrechner. Query Streams Cloud benötigt Ihr Datenbankpasswort nicht, um Abfrageanfragen über den Agenten weiterzuleiten.

Wo kann ich Konnektoren hinzufügen, bearbeiten oder löschen? +

Nutzen Sie das lokale Dashboard des Netzwerkagenten unter http://localhost:1823Im Query Streams-Portal erstellen Sie gespeicherte Abfragen und teilen den Zugriff, nachdem der Agent den Connector konfiguriert hat.

Kann ich mehr als einen Agenten installieren? +

Ja. Auf jedem Server läuft ein unabhängiger Agent mit demselben Organisationsauthentifizierungsschlüssel – egal ob lokal, auf AWS EC2, Azure-VMs, in der Google Cloud oder auf Rechnern in Zweigstellen. Alle Agents werden als separate Einträge in Ihrem Portal angezeigt, jeder mit seiner eigenen konfigurierten Datenbank.

Wie funktionieren automatische Updates? +

Der Agent erkennt, ob er installiert wurde über .deb oder tar.gz und wendet entsprechende Aktualisierungen an, sichert Daten und stellt sie wieder her. appsettings.json Während des Upgrades läuft der Prozess als unabhängiges Hintergrundskript – es entstehen keine Ausfallzeiten und es ist kein manuelles Eingreifen erforderlich.

Was muss ich nach der Installation tun? +

Erstellen Sie eine gespeicherte Abfrage im Query Streams-Portal und führen Sie diese anschließend aus Microsoft Excel, Google Sheets, Nova AI, einem MCP-Client wie Claude oder Cursor, einer geplanten Automatisierung oder einem sicheren REST-API-Endpunkt aus.

Los geht's

Installieren Sie den Linux-Agenten und verbinden Sie Ihre erste Datenquelle.

Führen Sie das Ein-Befehl-Installationsskript aus, konfigurieren Sie die Konnektoren lokal unter localhost:1823 und speichern Sie anschließend wiederverwendbare Abfragen für Excel, Google Sheets, Automatisierungen, MCP, REST-APIs und Nova AI.

Linux-Agent herunterladen

Kategorie: Einrichtung

Schlagwörter: Linux, Query Streams Agent, Netzwerkagent, Einrichtung, Datenbank-Connector, systemd

Meta-Beschreibung: Installieren Sie den Query Streams Agent unter Linux und verbinden Sie Live-Datenbanken sicher als systemd-Dienst.

Aktualisiert am 2. Juli 2026

Was sind Ihre Gefühle

Glücklich
Normal
Traurig

Angetrieben durch BetterDocs