Query Streams Agent 支持哪些 Linux 发行版？

.deb 软件包支持 Ubuntu 20.04+ 和 Debian 11+。包含 install.sh 的 .tar.gz 文件适用于任何 Linux x86-64 发行版，包括 RHEL 8+、CentOS Stream、Fedora 和 Amazon Linux 2。

Query Streams Agent 是否需要在 Linux 系统上打开防火墙端口？

不。该代理仅通过 443 端口建立出站 HTTPS 连接。无需任何入站防火墙规则。

如何在 Linux 上安装 Query Streams Agent

阅读时间：9分钟

Linux 网络代理

在 Linux 上安装 Query Streams

在 Ubuntu、Debian、RHEL 或任何 x86-64 Linux 服务器上运行仅支持出站流量的 Query Streams 网络代理。一个安装脚本即可将其注册为…… systemd 服务请使用本地代理仪表板。 http://localhost:1823 注册代理并管理数据连接器，然后在查询流门户中为 Excel、Google Sheets、自动化、REST API、MCP 和 Nova AI 构建已保存的查询。

本地连接器设置没有入站防火墙端口作为 systemd 服务运行

bash — user@ubuntu

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

$sudo bash install.sh|

>[5/5] 服务正在运行。

>Web 用户界面：http://localhost:1823

querystreams-agent.service 活跃（运行中）

在其他操作系统上安装？

Windows

macOS

查看 Linux 代理上线后 Query Streams 可以执行的所有操作免费开始

连接器

+ API

实时数据

直接从电子表格运行已保存的 SQL 语句。

在 Excel 板材

商业智能和人工智能分析

通过联网数据向 Nova 提问

认识诺瓦

数据库 REST API

将已保存的查询转换为安全端点

构建 API

+更多

自动化

安排同步并推送实时结果

探索

+更多

将应用程序接口转换为 SQL

使用 SQL 查询 SaaS API

探索

AI数据库MCP

让AI工具直接查询连接器。

Connect AI

Query Streams 是一个安全的实时数据访问平台，它允许 Linux 服务器团队与 Excel、Google Sheets、自动化程序、MCP 兼容的 AI 工具以及合作伙伴就绪的 REST API 共享实时数据库结果。 了解更多信息，请访问 QueryStreams.com 和 免费注册 安装您的第一个 Linux 代理。

本指南涵盖在 Ubuntu、Debian 和基于 RHEL 的 Linux 发行版上安装代理程序。该软件包包含： 单命令安装脚本 从而创建一个专门的 查询流 服务用户将文件复制到 /opt/querystreams/agent/并注册一个 systemd 服务 它会在系统启动时自动运行，并静默更新。在本地代理控制面板中添加数据连接器，然后使用查询流门户构建您的第一个已保存查询。

开始之前

支持的发行版

Ubuntu 20.04+ 和 Debian 11+ 通过 .deb 包裹，或 RHEL 8+, CentOS Stream 8+, Fedora 36+, 和 Amazon Linux 2 通过通用 .tar.gz 仅限 x86-64 (AMD64) 架构。

sudo / root 权限

需要运行安装脚本、创建专用服务用户并注册 systemd 单元。代理程序本身以非 root 用户身份运行。 查询流 事后记账。

出站 HTTPS

代理需要通过 443 端口向 Query Streams 云服务授予出站 HTTPS 访问权限。无需设置入站防火墙规则。

数据库网络访问

将代理安装在与数据库或 API 源位于同一网络、VPC 或可路由环境中的 Linux 服务器上。

步骤 1：下载 Linux 代理

登录 my.querystreams.com/下载.
选择 Linux 从代理下载选项中。
下载 .deb 软件包（Ubuntu/Debian）或 .tar.gz 归档（RHEL、CentOS、Fedora、Amazon Linux 或任何其他发行版）。
从同一下载页面复制您的组织身份验证密钥。您将在打开本地代理仪表板时使用此密钥。如果从其他计算机安装，请先传输该文件： scp querystreams-agent_x.x.x_linux-x64.tar.gz user@your-server:/tmp/

步骤 2：运行安装脚本

选项 A — .deb 软件包（Ubuntu / Debian）： 软件包脚本会自动处理服务注册。

bash — Ubuntu / Debian

# 安装 — 软件包脚本会自动处理所有操作 sudo dpkg -i querystreams-agent_x.x.x_amd64.deb # 如果提示，请修复任何缺失的依赖项 sudo apt-get install -f

选项 B — .tar.gz 归档文件（RHEL / CentOS / Fedora / 任何发行版）：

bash — RHEL / CentOS / 任何发行版

# 解压存档 tar -xzf querystreams-agent_x.x.x_linux-x64.tar.gz # 运行安装脚本（复制到 /opt/querystreams/agent/，注册 systemd 服务） sudo bash 安装脚本

两种选择都会产生 查询流 服务用户将文件复制到 /opt/querystreams/agent/安装并启用 querystreams-agent.service systemd 单元，并立即启动它。

服务运行后，即可访问本地仪表板。 http://localhost:1823 在服务器上（直接打开，或通过工作站上的 SSH 隧道打开）。它用于输入您的身份验证密钥并管理本地数据连接器。您的数据库凭据保留在代理计算机上，不会发送到 Query Streams 云端。

步骤 3：将代理连接到您的帐户

在本地代理仪表板中 http://localhost:1823粘贴您的 Query Streams 身份验证密钥。
保存密钥，等待代理程序在您的组织中注册。
确认服务运行正常： sudo systemctl status querystreams-agent ——它应该显示 活跃（运行中）.
选择 添加数据源 打开本地连接向导。

步骤 4：在本地代理中添加您的第一个数据源

请勿通过 Query Streams 门户添加或编辑连接器。连接器设置在本地网络代理仪表板中完成。 http://localhost:1823您可以在这里添加、编辑、测试和删除数据库或 API 连接器，例如 PostgreSQL、MySQL、MariaDB、SQLite、Microsoft SQL Server、Oracle、Snowflake、BigQuery、DuckDB、Stripe、HubSpot、Shopify、Google Analytics 4、Google Ads、Google Search Console、ShipStation 或 iTick。

在 Linux 代理机器上（或通过 SSH 隧道）打开浏览器并访问 http://localhost:1823.
点击 添加数据源 或者打开代理连接区域。
选择您的数据库或 API 连接器类型。
请输入从 Linux 代理机器上有效的连接详细信息。
如果出现提示，请选择数据域。
测试连接，然后保存。
对于受支持的数据库连接器，请启用架构智能，以便查询生成器、Nova AI 和 MCP 客户端获得更丰富的表和列上下文。

PostgreSQL主机、端口、数据库、SSL

MySQL / MariaDB主机、端口、数据库、SSL

SQL 服务器服务器、数据库、用户名、密码

本地文件SQLite、DuckDB

API 连接器凭证、同步计划、数据领域

MCP就绪AI客户端可以直接查询连接器。

网络模型

# 连接器管理本地代理控制面板：http://localhost:1823 # Linux 代理作为 systemd 服务运行，凭据存储在本地，并建立出站连接 # 您的数据库/API 来自代理的专用网络连接 # 查询流云接收连接器元数据并路由查询请求

步骤 5：构建并保存您的第一个查询

在代理中配置好连接器和数据库后，打开查询流门户，并使用查询构建器创建您的第一个已保存查询。Excel、Google Sheets、自动化流程、安全 REST API 端点和共享用户可以运行此已保存查询，而无需查看您的原始 SQL 或数据库凭据。

打开查询生成器在 Query Streams 门户中。
选择您在本地代理中配置的数据连接器和数据库。
编写或生成 SQL 查询并运行预览。
使用清晰的名称保存查询，并添加您希望用户调整的任何筛选条件。
从 Microsoft Excel、Google Sheets、自动化流程、REST API 或共享仪表板运行已保存的查询。

当地代理

在以下位置添加、编辑、测试和删除连接器 localhost:1823.

查询生成器

选择连接器，选择数据库，编写 SQL，预览，然后保存。

用户工具

保存的查询可在 Excel、Google Sheets、自动化流程和 API 中使用。

MCP访问

MCP 客户端还可以通过代理直接查看可用的连接器并查询数据库。

服务管理参考

bash — 常用管理命令

# 启动/停止/重启 sudo systemctl start 查询流代理 sudo systemctl stop 查询流代理 sudo systemctl restart 查询流代理 # 检查当前状态 sudo systemctl status 查询流代理 # 关注实时日志 sudo journalctl -u 查询流代理 -f # 查看最近 100 条日志 sudo journalctl -u 查询流代理 -n 100 –no-pager

卸载代理

该包裹包含一个 卸载脚本 该脚本可以停止服务、删除文件，并可选择保留您的配置和日志。

bash — Ubuntu / Debian (.deb 卸载程序)

# 移除软件包（保留配置文件） sudo dpkg -r 查询流代理 # 完全清除 — 同时删除配置、日志和服务用户 sudo dpkg –purge 查询流代理

bash — tar.gz 卸载

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

卸载脚本将提示： “是否保留配置和日志？（y/N）” - 进入 y 为了保存你的 appsettings.json 和 日志/ 文件夹，或 N 全部移除。

故障排除

该代理人未在线出现。 +

检查服务日志： sudo journalctl -u querystreams-agent -n 50 --no-pager常见原因：在本地 Web UI 中输入了错误的身份验证密钥 http://localhost:1823出站端口 443 被防火墙阻止（测试方法） curl -v https://my.querystreams.comDNS解析失败（nslookup my.querystreams.com).

数据库连接测试失败 +

请在安装了代理程序的 Linux 机器上进行测试。代理程序必须能够直接访问数据库主机和端口。同时，请确认数据库用户名拥有对您计划查询的表或视图的读取权限。

我需要开放入站防火墙端口吗？ +

不。代理程序会创建一个到查询流的出站加密连接。查询请求通过该连接传输，因此您不会将 PostgreSQL、MySQL、SQL Server 或任何其他数据库暴露在公共互联网上。

数据库凭据存储在哪里？ +

数据库凭据存储在 /opt/querystreams/agent/appsettings.json 在代理服务器上。Query Streams 云服务不需要您的原始数据库密码即可通过代理服务器路由查询请求。

在哪里可以添加、编辑或删除连接器？ +

使用网络代理的本地仪表板 http://localhost:1823在代理配置好连接器后，您可以通过查询流门户构建已保存的查询并共享访问权限。

我可以安装多个代理吗？ +

是的。每台服务器都运行一个独立的代理，使用相同的组织身份验证密钥——可以安装在本地、AWS EC2、Azure 虚拟机、Google Cloud 或分支机构的计算机上。所有代理都会在您的门户中显示为单独的条目，每个条目都有自己配置的数据库。

自动更新是如何工作的？ +

代理程序会检测它是否是通过以下方式安装的： .deb 或 tar.gz 并相应地应用更新，进行备份和恢复。 appsettings.json 升级过程围绕此展开。该过程作为独立的后台脚本运行——无需停机，也无需人工操作。

安装完成后我应该做什么？ +

在 Query Streams 门户中创建已保存的查询，然后从 Microsoft Excel、Google Sheets、Nova AI、MCP 客户端（如 Claude 或 Cursor）、计划的自动化或安全的 REST API 端点运行它。

开始

安装 Linux 代理并连接您的第一个数据源

运行单命令安装脚本，在 localhost:1823 本地配置连接器，然后保存可重用的查询，用于 Excel、Google Sheets、自动化、MCP、REST API 和 Nova AI。

下载 Linux Agent

类别：设置

标签：Linux、查询流代理、网络代理、设置、数据库连接器、systemd

元描述：在 Linux 上安装 Query Streams Agent，并以 systemd 服务的形式安全地连接实时数据库。

更新 2026 年 7 月 2 日

您的感觉是什么

Happy
常规
Sad