View Categories

Cara Menginstal Query Streams Agent di Linux

Waktu baca 9 menit

Logo Linux Agen Jaringan Linux

Instal Query Streams di Linux

Jalankan Query Streams Network Agent khusus keluar pada Ubuntu, Debian, RHEL, atau server Linux x86-64 lainnya. Satu skrip instalasi mendaftarkannya sebagai layanan systemdGunakan dasbor Agen lokal di http://localhost:1823 untuk mendaftarkan Agen dan mengelola konektor data, kemudian membuat kueri tersimpan di portal Query Streams untuk Excel, Google Sheets, otomatisasi, REST API, MCP, dan Nova AI.

Pengaturan konektor lokal Tidak ada port firewall masuk. Berjalan sebagai layanan systemd
bash — user@ubuntu
$tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz
$sudo bash install.sh|
>[5/5] Layanan sedang berjalan.
>Antarmuka Web: http://localhost:1823
agen aliran kueri.layanan aktif (berjalan)
Menginstal di sistem operasi yang berbeda?
Windows Windows macOS macOS
Lihat semua yang dapat dilakukan Query Streams setelah Linux Agent online. Mulai Gratis
Konektor
SQL Server PostgreSQL MySQL MariaDB SQLite Microsoft Access Oracle BigQuery DuckDB
+ API
Microsoft Excel Lembar Kerja Google
Data Langsung

Jalankan SQL yang tersimpan langsung dari spreadsheet.

Excel Lembar
Nova AI
Analisis BI & AI

Ajukan pertanyaan kepada Nova melalui data yang terhubung.

Temui Nova
API REST
API REST Basis Data

Ubah kueri yang tersimpan menjadi titik akhir yang aman.

Membangun API
Airtable Lembar pintar Baserow + lagi
Otomatisasi

Jadwalkan sinkronisasi dan tampilkan hasil secara langsung.

Jelajahi
Stripe HubSpot Shopify Google Analytics + lagi
API ke SQL

Mengakses API SaaS dengan SQL

Jelajahi
MCP Claude Kursor ChatGPT
Basis Data AI MCP

Izinkan alat AI untuk melakukan kueri langsung ke konektor.

Hubungkan AI

Query Streams adalah platform akses data real-time yang aman yang memungkinkan tim server Linux untuk berbagi hasil basis data secara langsung dengan Excel, Google Sheets, otomatisasi, alat AI yang kompatibel dengan MCP, dan API REST yang siap digunakan oleh mitra. Pelajari selengkapnya di QueryStreams.com dan Daftar gratis untuk menginstal Agen Linux pertama Anda.

Panduan ini membahas cara menginstal Agen pada distribusi Linux berbasis Ubuntu, Debian, dan RHEL. Paket ini mencakup... skrip instalasi satu perintah yang menciptakan yang khusus aliran kueri pengguna layanan, menyalin file ke /opt/querystreams/agent/, dan mendaftarkan sebuah layanan systemd yang berjalan otomatis saat booting dan memperbarui diri secara diam-diam. Tambahkan konektor data Anda di dalam dasbor Agen lokal, lalu gunakan portal Query Streams untuk membuat kueri tersimpan pertama Anda.

Sebelum Anda Mulai

Distribusi yang didukung

Ubuntu 20.04+ dan Debian 11+ melalui .deb paket, atau RHEL 8+, CentOS Stream 8+, Fedora 36+, dan Amazon Linux 2 melalui universal .tar.gz arsip. Hanya x86-64 (AMD64).

sudo / akses root

Diperlukan untuk menjalankan skrip instalasi, membuat pengguna layanan khusus, dan mendaftarkan unit systemd. Agen itu sendiri berjalan sebagai pengguna non-root. aliran kueri kemudian membuat laporan.

HTTPS keluar

Agen memerlukan akses HTTPS keluar pada port 443 ke layanan cloud Query Streams. Tidak diperlukan aturan firewall masuk.

Akses jaringan basis data

Instal Agen pada server Linux di jaringan, VPC, atau lingkungan yang dapat diakses yang sama dengan basis data atau sumber API Anda.

Langkah 1: Unduh Agen Linux

1
2
3
4
5
  1. Masuk ke my.querystreams.com/download.
  2. Memilih Linux dari opsi unduhan Agen.
  3. Unduh .deb paket (Ubuntu/Debian) atau .tar.gz arsip (RHEL, CentOS, Fedora, Amazon Linux, atau distro lainnya).
  4. Salin kunci otentikasi organisasi Anda dari halaman unduhan yang sama. Anda akan menggunakannya saat dasbor Agen lokal terbuka. Jika menginstal dari mesin yang berbeda, transfer file terlebih dahulu: scp querystreams-agent_x.x.x_linux-x64.tar.gz user@your-server:/tmp/

Langkah 2: Jalankan Skrip Instalasi

2
3
4
5

Opsi A — paket .deb (Ubuntu / Debian): Skrip paket menangani pendaftaran layanan secara otomatis.

bash — Ubuntu / Debian
# Instalasi — skrip paket menangani semuanya secara otomatis sudo dpkg -i querystreams-agent_x.x.x_amd64.deb # Perbaiki dependensi yang hilang jika diminta sudo apt-get install -f

Opsi B — arsip .tar.gz (RHEL / CentOS / Fedora / distro apa pun):

bash — RHEL / CentOS / distro apa pun
# Ekstrak arsip tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz # Jalankan skrip instalasi (menyalin ke /opt/querystreams/agent/, mendaftarkan layanan systemd) sudo bash instal.sh

Kedua opsi tersebut menghasilkan aliran kueri pengguna layanan, menyalin file ke /opt/querystreams/agent/, menginstal dan mengaktifkan agen aliran kueri.layanan unit systemd, dan langsung menjalankannya.

Setelah layanan berjalan, dasbor lokal tersedia di http://localhost:1823 di server (buka langsung, atau melalui terowongan SSH dari workstation Anda). Ini digunakan untuk memasukkan kunci otentikasi Anda dan mengelola konektor data lokal. Kredensial basis data Anda tetap berada di mesin Agen dan tidak dikirim ke cloud Query Streams.

Langkah 3: Hubungkan Agen ke Akun Anda

3
4
5
  1. Di dasbor Agen lokal di http://localhost:1823, tempelkan kunci otentikasi Query Streams Anda.
  2. Simpan kunci tersebut dan tunggu hingga Agen mendaftar ke organisasi Anda.
  3. Konfirmasikan bahwa layanan tersebut berfungsi dengan baik: sudo systemctl status querystreams-agent — seharusnya menunjukkan aktif (berjalan).
  4. Memilih Tambahkan Sumber Data untuk membuka wizard koneksi lokal.

Langkah 4: Tambahkan Sumber Data Pertama Anda di Agen Lokal

4
5

Jangan menambahkan atau mengedit konektor dari portal Query Streams. Pengaturan konektor dilakukan di dasbor Network Agent lokal di http://localhost:1823Di sinilah Anda dapat menambahkan, mengedit, menguji, dan menghapus konektor basis data atau API seperti PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation, atau iTick.

  1. Buka browser di mesin Linux Agent (atau melalui terowongan SSH) dan masuk ke http://localhost:1823.
  2. Klik Tambahkan Sumber Data atau buka area koneksi Agen.
  3. Pilih jenis basis data atau konektor API Anda.
  4. Masukkan detail koneksi yang valid dari mesin Agen Linux.
  5. Pilih ranah data jika diminta.
  6. Uji koneksi, lalu simpan.
  7. Untuk konektor basis data yang didukung, biarkan Schema Intelligence tetap diaktifkan agar klien Query Builder, Nova AI, dan MCP mendapatkan konteks tabel dan kolom yang lebih kaya.
PostgreSQL
PostgreSQLHost, port, basis data, SSL
MySQL
MySQL / MariaDBHost, port, basis data, SSL
SQL Server
SQL ServerServer, basis data, nama pengguna, kata sandi
DuckDB
File lokalSQLite, DuckDB
Stripe
konektor APIKredensial, jadwal sinkronisasi, ranah data
MCP
Siap MCPKlien AI dapat melakukan kueri konektor secara langsung.
Model jaringan
# Manajemen konektor Dasbor Agen Lokal: http://localhost:1823 # Agen Linux Berjalan sebagai layanan systemd, menyimpan kredensial secara lokal, terhubung keluar. # Basis data/API Anda Koneksi jaringan pribadi dari Agen # Kueri Streams cloud Menerima metadata konektor dan mengarahkan permintaan kueri.

Langkah 5: Buat dan Simpan Kueri Pertama Anda

5

Setelah konektor dan basis data dikonfigurasi di Agen, buka portal Query Streams dan gunakan Query Builder untuk membuat kueri tersimpan pertama Anda. Kueri tersimpan inilah yang dapat dijalankan oleh Excel, Google Sheets, otomatisasi, titik akhir REST API yang aman, dan pengguna bersama tanpa harus melihat SQL mentah atau kredensial basis data Anda.

  1. Membuka Pembuat Kueri di portal Query Streams.
  2. Pilih konektor data dan basis data yang telah Anda konfigurasi di Agen lokal.
  3. Tulis atau buat kueri SQL dan jalankan pratinjau.
  4. Simpan kueri dengan nama yang jelas dan filter apa pun yang ingin Anda izinkan pengguna untuk menyesuaikan.
  5. Jalankan kueri yang tersimpan dari Microsoft Excel, Google Sheets, otomatisasi, REST API, atau dasbor bersama.
1

Agen Lokal

Tambahkan, edit, uji, dan hapus konektor di localhost:1823.

2

Pembuat Kueri

Pilih konektor, pilih basis data, tulis SQL, pratinjau, dan simpan.

3

Alat pengguna

Kueri yang tersimpan akan tersedia di Excel, Google Sheets, otomatisasi, dan API.

4

Akses MCP

Klien MCP juga dapat melihat konektor yang tersedia dan melakukan kueri basis data secara langsung melalui Agen.

Referensi Manajemen Layanan

bash — perintah manajemen umum
# Mulai / berhenti / mulai ulang sudo systemctl start agen aliran kueri sudo systemctl stop agen aliran kueri sudo systemctl restart agen aliran kueri # Periksa status terkini sudo systemctl status agen aliran kueri # Ikuti log langsung sudo journalctl -u agen aliran kueri -F # Lihat 100 baris log terakhir sudo journalctl -u agen aliran kueri -n 100 –tanpa pager

Menghapus instalasi Agen

Paket tersebut mencakup sebuah uninstall.sh Skrip yang menghentikan layanan, menghapus file, dan secara opsional mempertahankan konfigurasi dan log Anda.

bash — Ubuntu / Debian (.deb uninstall)
# Hapus paket (tetap menyimpan file konfigurasi) sudo dpkg -r agen aliran kueri # Pembersihan total — juga menghapus konfigurasi, log, dan pengguna layanan sudo dpkg –purge agen aliran kueri
bash — tar.gz uninstall
sudo bash /opt/querystreams/agent/uninstall.sh

Skrip penghapusan instalasi akan menampilkan pesan: “Simpan konfigurasi dan log? (y/N)” - memasuki y untuk menjaga milik Anda appsettings.json dan log/ folder, atau N untuk menghapus semuanya.

Penyelesaian Masalah

Agen tersebut tidak muncul secara online. +
Periksa log layanan: sudo journalctl -u querystreams-agent -n 50 --no-pagerPenyebab umum: kunci otentikasi yang salah dimasukkan di antarmuka web lokal. http://localhost:1823; port keluar 443 diblokir oleh firewall (uji dengan curl -v https://my.querystreams.com); kegagalan resolusi DNS (nslookup my.querystreams.com).
Pengujian koneksi basis data gagal. +
Lakukan pengujian dari mesin Linux tempat Agen diinstal. Agen harus dapat terhubung langsung ke host dan port basis data. Pastikan juga nama pengguna basis data memiliki akses baca ke tabel atau tampilan yang akan Anda kueri.
Apakah saya perlu membuka port firewall masuk? +
Tidak. Agen membuat koneksi terenkripsi keluar ke Query Streams. Permintaan kueri berjalan melalui koneksi tersebut, sehingga Anda tidak mengekspos PostgreSQL, MySQL, SQL Server, atau basis data lainnya ke internet publik.
Di mana kredensial basis data disimpan? +
Kredensial basis data disimpan di /opt/querystreams/agent/appsettings.json pada mesin Agen. Query Streams cloud tidak memerlukan kata sandi basis data mentah Anda untuk mengarahkan permintaan kueri melalui Agen.
Di mana saya dapat menambahkan, mengedit, atau menghapus konektor? +
Gunakan dasbor lokal Agen Jaringan di http://localhost:1823Portal Query Streams adalah tempat Anda membuat kueri tersimpan dan berbagi akses setelah Agen mengkonfigurasi konektor.
Bisakah saya menginstal lebih dari satu Agen? +
Ya. Setiap server menjalankan agen independen menggunakan kunci otentikasi organisasi yang sama — instalasi di lokasi, AWS EC2, Azure VM, Google Cloud, atau mesin kantor cabang. Semua agen muncul sebagai entri terpisah di portal Anda, masing-masing dengan basis data yang dikonfigurasi sendiri.
Bagaimana cara kerja pembaruan otomatis? +
Agen tersebut mendeteksi apakah instalasi dilakukan melalui .deb atau tar.gz dan menerapkan pembaruan yang sesuai, melakukan pencadangan dan pemulihan. appsettings.json seputar peningkatan sistem. Proses ini berjalan sebagai skrip latar belakang yang terpisah — tidak ada waktu henti, tidak ada tindakan manual yang diperlukan.
Apa yang harus saya lakukan setelah instalasi? +
Buat kueri tersimpan di portal Query Streams, lalu jalankan dari Microsoft Excel, Google Sheets, Nova AI, klien MCP seperti Claude atau Cursor, otomatisasi terjadwal, atau titik akhir API REST yang aman.

Memulai

Instal Linux Agent dan hubungkan sumber data pertama Anda.

Jalankan skrip instalasi satu perintah, konfigurasikan konektor secara lokal di localhost:1823, lalu simpan kueri yang dapat digunakan kembali untuk Excel, Google Sheets, otomatisasi, MCP, REST API, dan Nova AI.

Unduh Agen Linux

Panduan terkait: Instal Agen Query Streams di Windows | Instal Query Streams Agent di macOS | Instal Add-on Query Streams untuk Google Sheets | Menggunakan Query Streams dengan Microsoft Excel

Kategori: Pengaturan

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

Deskripsi Meta: Instal Query Streams Agent di Linux dan hubungkan basis data langsung secara aman sebagai layanan systemd.

Updated on 2 Juli 2026

What are your Feelings

  • Happy
  • Normal
  • Sad

Powered by BetterDocs