Visualizza le categorie

Come installare l'agente Query Streams su Linux

9 minuti di lettura

Logo Linux Agente di rete Linux

Installare Query Streams su Linux

Esegui l'agente di rete Query Streams solo in uscita su Ubuntu, Debian, RHEL o qualsiasi server Linux x86-64. Uno script di installazione lo registra come un servizio systemd. Utilizzare la dashboard dell'agente locale all'indirizzo http://localhost:1823 per registrare l'agente e gestire i connettori dati, quindi creare query salvate nel portale Query Streams per Excel, Fogli Google, automazione, API REST, MCP e Nova AI.

Configurazione del connettore locale Nessuna porta firewall in entrata Esegue il servizio systemd
bash — user@ubuntu
$tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz
$sudo bash install.sh|
>[5/5] Il servizio è attivo.
>Interfaccia web: http://localhost:1823
servizio di gestione dei flussi di query attivo (in corsa)
Installazione su un sistema operativo diverso?
Finestre Finestre macOS macOS
Scopri tutte le funzionalità di Query Streams una volta che l'agente Linux è online. Iniziare gratis
Connettori
SQL Server PostgreSQL MySQL MariaDB SQLite Microsoft Access Oracolo BigQuery DuckDB
+ API
Microsoft Excel Fogli di Google
Dati in tempo reale

Esegui direttamente le query SQL salvate dai fogli di calcolo

Excel Lenzuola
Nova AI
Analisi BI e AI

Poni domande a Nova tramite i dati connessi

Incontrare Nova
API REST
API REST del database

Trasforma le query salvate in endpoint sicuri

Creare un'API
Tavola d'aria Smartsheet Baserow +più
Automazione

Pianifica le sincronizzazioni e invia i risultati in tempo reale

Esplorare
Striscia HubSpot Shopify Google Analytics +più
Da API a SQL

Interrogare le API SaaS con SQL

Esplorare
MCP Claude Cursore ChatGPT
Database AI MCP

Consenti agli strumenti di intelligenza artificiale di interrogare direttamente i connettori

Connetti l'IA

Query Streams è una piattaforma sicura per l'accesso ai dati in tempo reale che consente ai team che utilizzano server Linux di condividere i risultati dei database in tempo reale con Excel, Fogli Google, automazioni, strumenti di intelligenza artificiale compatibili con MCP e API REST pronte per i partner. Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente per installare il tuo primo agente Linux.

Questa guida illustra l'installazione dell'agente su distribuzioni Linux basate su Ubuntu, Debian e RHEL. Il pacchetto include un script di installazione con un solo comando che crea un dedicato querystreams utente del servizio, copia i file su /opt/querystreams/agent/e registra un servizio systemd che si avvia automaticamente all'avvio del sistema e si aggiorna silenziosamente. Aggiungi i connettori dati all'interno della dashboard locale dell'agente, quindi utilizza il portale Query Streams per creare la tua prima query salvata.

Prima di iniziare

Distribuzioni supportate

Ubuntu 20.04+ e Debian 11+ tramite il .deb pacchetto o RHEL 8+, CentOS Stream 8+, Fedora 36+, e Amazon Linux 2 tramite l'universale .tar.gz archivio. Solo x86-64 (AMD64).

accesso sudo/root

Necessario per eseguire lo script di installazione, creare l'utente di servizio dedicato e registrare l'unità systemd. L'agente stesso viene eseguito come utente non root. querystreams resoconto in seguito.

HTTPS in uscita

L'agente necessita di accesso HTTPS in uscita sulla porta 443 ai servizi cloud di Query Streams. Non è richiesta alcuna regola firewall in entrata.

Accesso alla rete del database

Installa l'agente su un server Linux nella stessa rete, VPC o ambiente instradabile del tuo database o della sorgente API.

Passaggio 1: Scarica l'agente Linux

1
2
3
4
5
  1. Accedi my.querystreams.com/download.
  2. Scegliere Linux dalle opzioni di download dell'agente.
  3. Scarica il .deb pacchetto (Ubuntu/Debian) o il .tar.gz archivio (RHEL, CentOS, Fedora, Amazon Linux o qualsiasi altra distribuzione).
  4. Copia la chiave di autenticazione della tua organizzazione dalla stessa pagina di download. La utilizzerai all'apertura della dashboard dell'agente locale. Se esegui l'installazione da un computer diverso, trasferisci prima il file: scp querystreams-agent_x.x.x_linux-x64.tar.gz user@your-server:/tmp/

Passaggio 2: Eseguire lo script di installazione

2
3
4
5

Opzione A — Pacchetto .deb (Ubuntu / Debian): Gli script del pacchetto gestiscono automaticamente la registrazione del servizio.

bash — Ubuntu / Debian
# Installazione: gli script del pacchetto gestiscono tutto automaticamente sudo dpkg -i querystreams-agent_x.x.x_amd64.deb # Correggi eventuali dipendenze mancanti se richiesto sudo apt-get install -f

Opzione B — Archivio .tar.gz (RHEL / CentOS / Fedora / qualsiasi distribuzione):

bash — RHEL / CentOS / qualsiasi distribuzione
# Estrai l'archivio tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz # Esegui lo script di installazione (copia in /opt/querystreams/agent/, registra il servizio systemd) sudo bash install.sh

Entrambe le opzioni creano il querystreams utente del servizio, copia i file su /opt/querystreams/agent/, installa e abilita il servizio di gestione dei flussi di query l'unità systemd e la avvia immediatamente.

Una volta avviato il servizio, il pannello di controllo locale è disponibile all'indirizzo http://localhost:1823 sul server (apribile direttamente o tramite un tunnel SSH dalla tua workstation). Viene utilizzato per inserire la chiave di autenticazione e gestire i connettori dati locali. Le credenziali del database rimangono sulla macchina dell'agente e non vengono inviate al cloud di Query Streams.

Passaggio 3: collega l'agente al tuo account

3
4
5
  1. Nella dashboard dell'agente locale a http://localhost:1823, incolla la tua chiave di autenticazione Query Streams.
  2. Salva la chiave e attendi che l'agente si registri presso la tua organizzazione.
  3. Conferma che il servizio funzioni correttamente: sudo systemctl status querystreams-agent — dovrebbe mostrare attivo (in corsa).
  4. Seleziona Aggiungi origini dati per aprire la procedura guidata di connessione locale.

Passaggio 4: Aggiungi la tua prima origine dati nell'agente locale

4
5

Non aggiungere o modificare i connettori dal portale Query Streams. La configurazione del connettore viene eseguita nella dashboard locale dell'agente di rete all'indirizzo http://localhost:1823Qui puoi aggiungere, modificare, testare ed eliminare connettori per database o API come PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation o iTick.

  1. Apri un browser sulla macchina agente Linux (o tramite tunnel SSH) e vai a http://localhost:1823.
  2. Cliccare Aggiungi origini dati oppure apri l'area di connessione dell'agente.
  3. Scegli il tipo di database o connettore API.
  4. Inserisci i dettagli di connessione validi dalla macchina agente Linux.
  5. Seleziona un dominio dati se richiesto.
  6. Verifica la connessione, quindi salvala.
  7. Per i connettori di database supportati, lascia Schema Intelligence abilitato in modo che Query Builder, Nova AI e i client MCP ottengano un contesto più ricco per tabelle e colonne.
PostgreSQL
PostgreSQLHost, porta, database, SSL
MySQL
MySQL / MariaDBHost, porta, database, SSL
SQL Server
SQL ServerServer, database, nome utente, password
DuckDB
File localiSQLite, DuckDB
Striscia
connettori APICredenziali, pianificazione della sincronizzazione, dominio dati
MCP
Compatibile con MCPI client AI possono interrogare direttamente i connettori
Modello di rete
# Gestione dei connettori Dashboard dell'agente locale: http://localhost:1823 # Agente Linux Esegue come servizio systemd, memorizza le credenziali localmente, si connette in uscita # Il tuo database/API Connessione di rete privata dall'agente # Query Streams cloud Riceve i metadati del connettore e instrada le richieste di query

Passaggio 5: Crea e salva la tua prima query

5

Dopo aver configurato il connettore e il database nell'Agent, apri il portale Query Streams e usa Query Builder per creare la tua prima query salvata. La query salvata è quella che Excel, Fogli Google, automazioni, endpoint API REST sicuri e utenti condivisi possono eseguire senza visualizzare il tuo codice SQL grezzo o le credenziali del database.

  1. Apri Generatore di query nel portale Query Streams.
  2. Seleziona il connettore dati e il database che hai configurato nell'agente locale.
  3. Scrivi o genera una query SQL ed eseguine un'anteprima.
  4. Salva la query con un nome chiaro e includi tutti i filtri che desideri consentire agli utenti di modificare.
  5. Esegui la query salvata da Microsoft Excel, Fogli Google, automazioni, API REST o dashboard condivise.
1

Agente locale

Aggiungi, modifica, testa ed elimina i connettori su localhost:1823.

2

Generatore di query

Seleziona il connettore, scegli il database, scrivi il codice SQL, visualizza l'anteprima e salva.

3

Strumenti utente

Le query salvate diventano disponibili in Excel, Fogli Google, automazioni e API.

4

Accesso MCP

I clienti MCP possono anche visualizzare i connettori disponibili ed eseguire query sul database direttamente tramite l'agente.

Riferimento alla gestione dei servizi

bash — comandi di gestione comuni
# Avvia / arresta / riavvia sudo systemctl start agente di flusso di query sudo systemctl stop agente di flusso di query sudo systemctl restart agente di flusso di query # Verifica lo stato attuale sudo systemctl status agente di flusso di query # Segui i log in tempo reale sudo journalctl -u agente di flusso di query -F # Visualizza le ultime 100 righe del registro sudo journalctl -u agente di flusso di query -n 100 –no-pager

Disinstallazione dell'agente

La confezione include un uninstall.sh Script che arresta il servizio, rimuove i file e, facoltativamente, conserva la configurazione e i log.

bash — Ubuntu / Debian (disinstallazione .deb)
# Rimuovi il pacchetto (mantiene i file di configurazione) sudo dpkg -r agente di flusso di query # Pulizia completa: rimuove anche la configurazione, i log e l'utente del servizio sudo dpkg –purge agente di flusso di query
bash — tar.gz uninstall
sudo bash /opt/querystreams/agent/uninstall.sh

Lo script di disinstallazione richiederà quanto segue: "Mantenere la configurazione e i registri? (s/N)" — entra y per preservare il tuo appsettings.json e registri/ cartella o N per rimuovere tutto.

Risoluzione dei problemi

L'agente non risulta online +
Controlla i registri di servizio: sudo journalctl -u querystreams-agent -n 50 --no-pager. Cause comuni: chiave di autenticazione errata inserita nell'interfaccia utente web locale a http://localhost:1823; la porta in uscita 443 è bloccata da un firewall (test con curl -v https://my.querystreams.com); errore di risoluzione DNS (nslookup my.querystreams.com).
Il test di connessione al database fallisce. +
Esegui il test dalla macchina Linux su cui è installato l'agente. L'agente deve essere in grado di raggiungere direttamente l'host e la porta del database. Verifica inoltre che il nome utente del database disponga dei permessi di lettura per le tabelle o le viste che intendi interrogare.
Devo aprire le porte in entrata del firewall? +
No. L'agente crea una connessione crittografata in uscita verso Query Streams. Le richieste di query transitano attraverso tale connessione, quindi non si espone PostgreSQL, MySQL, SQL Server o qualsiasi altro database a Internet.
Dove vengono memorizzate le credenziali del database? +
Le credenziali del database sono memorizzate in /opt/querystreams/agent/appsettings.json sulla macchina dell'agente. Query Streams Cloud non necessita della password del database non elaborata per instradare le richieste di query attraverso l'agente.
Dove posso aggiungere, modificare o eliminare i connettori? +
Utilizzare la dashboard locale dell'agente di rete all'indirizzo http://localhost:1823Il portale Query Streams è il luogo in cui è possibile creare query salvate e condividere l'accesso dopo che l'agente ha configurato il connettore.
Posso installare più di un agente? +
Sì. Ogni server esegue un agente indipendente utilizzando la stessa chiave di autenticazione dell'organizzazione, sia in locale, su AWS EC2, macchine virtuali di Azure, Google Cloud o su macchine di filiali. Tutti gli agenti vengono visualizzati come voci separate nel portale, ognuno con il proprio database configurato.
Come funzionano gli aggiornamenti automatici? +
L'agente rileva se è stato installato tramite .deb o tar.gz e applica gli aggiornamenti di conseguenza, eseguendo il backup e il ripristino appsettings.json durante l'aggiornamento. Il processo viene eseguito come script in background separato, senza tempi di inattività e senza necessità di intervento manuale.
Cosa devo fare dopo l'installazione? +
Crea una query salvata nel portale Query Streams, quindi eseguila da Microsoft Excel, Google Sheets, Nova AI, un client MCP come Claude o Cursor, un'automazione pianificata o un endpoint API REST sicuro.

Iniziare

Installa l'agente Linux e connetti la tua prima origine dati.

Esegui lo script di installazione con un solo comando, configura i connettori localmente all'indirizzo localhost:1823, quindi salva le query riutilizzabili per Excel, Fogli Google, automazioni, MCP, API REST e Nova AI.

Scarica l'agente Linux

Guide correlate: Installa l'agente Query Streams su Windows | Installa l'agente Query Streams su macOS | Installa il componente aggiuntivo Query Streams per Fogli Google | Utilizzare Query Streams con Microsoft Excel

Categoria: Impostazioni

Tag: Linux, Query Streams Agent, Network Agent, Setup, Database Connector, systemd

Meta Description: Installa l'agente Query Streams su Linux e connettiti in modo sicuro ai database attivi come servizio systemd.

Updated on 2 luglio 2026

What are your Feelings

  • Happy
  • Normal
  • Sad

Powered by BetterDocs