查看类别

如何在 Linux 上安装 Query Streams Agent

阅读时间16分钟

0:00 17:24
Linux 安装 · Linux

在服务器上安装 Query Streams Agent Linux

代理程序是一个小型程序，它会驻留在您的数据旁边，负责连接。只需安装一次，然后通过浏览器设置其他所有选项即可。

大约10分钟 无需编程 您的数据将保留原状。
遇到任何问题？尽管问我们。 打开 支持 请在“查询流”（右上角菜单 → 支持）中给我们发送消息。我们会安排专人阅读您的消息，“我不知道这个屏幕需要什么”就是一个很好的问题。

Query Streams 允许您直接从数据库和业务应用程序中提取实时数据，并将其导入 Excel、Google Sheets、报表或 AI 助手，而无需事先将其复制到任何地方。为此，它需要一个小型辅助程序在某个可以访问您数据的地方运行。这个辅助程序就是…… 代理人.

开始之前你需要准备什么

Linux 机器或服务器

当用户运行查询时，服务器需要保持通电状态。如果服务器在夜间关机，则在第二天重新启动之前将无法使用。

您的登录密钥

这是一个一次性代码，用于将此代理与您的组织关联。您可以在下载页面的“查询流”中找到它，就在安装程序旁边。

您的数据库详情

服务器名称、数据库名称以及可以读取该数据库的用户名和密码。如果您的数据库由其他人管理，则需要向他们索取这些信息。

它应该放在哪里？ 将代理程序安装在目前已能打开数据库的计算机上——通常是数据库服务器本身，或者同一办公网络上的任何一台电脑。如果您能从该计算机访问数据，代理程序也能访问。

分四步安装

  1. 下载并运行安装程序

    登录 my.querystreams.com/下载 然后选择 Linux 下载。有两个软件包——一个是适用于 Ubuntu 和较新版 Debian 的 .deb 包，另一个是适用于其他所有系统的 .tar.gz 包。下载合适的软件包，然后在该机器上打开终端并运行以下命令。您需要 sudo 权限。

    如果是在另一台电脑上下载的，请先复制过来——例如 scp querystreams-agent_*.deb you@your-server:~ ——然后开始 光盘 而不是 cd ~/下载.

    两者都适用于 64 位 Intel/AMD 机器 (x86_64)。不支持 Alpine Linux。

    Ubuntu 18.04 或更高版本，或 Debian 12 或更高版本 — 使用 .deb. 易于 还会为你获取其他所需的一切：

    Ubuntu / Debian 12+ (.deb)
    cd ~/Downloads sudo apt install ./querystreams-agent_*_amd64.deb

    其他一切 — RHEL、Rocky、Alma、Fedora、Amazon Linux 以及 Debian 11 或更早版本 — 使用 .tar.gz首先安装代理所需的 ICU 库（大多数桌面系统已安装；最小化服务器镜像通常没有）。只需运行一行命令即可：

    首先安装ICU
    # RHEL、Rocky、Alma、Fedora、Amazon Linux 2023 sudo dnf install -y libicu # Amazon Linux 2、CentOS 7 sudo yum install -y libicu # Debian 11 或更低版本 sudo apt install -y libicu-dev

    然后安装代理：

    其他发行版（.tar.gz）
    cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_linux-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh

    这 * 此处会显示版本号，所以您无需手动输入。如果您在该文件夹中下载了多个版本，请改为输入完整的文件名。

    然后检查它是否正在运行。你应该能看到 活跃（运行中） 绿色；按 q 获取您的提示。

    检查服务
    systemctl status querystreams-agent

    在 RHEL、Rocky、Alma 或 Fedora 系统上，如果状态显示 203/执行SELinux 仍然将这些文件视为位于您的主文件夹中的文件。请重新命名这些文件并重启：

    RHEL 系列：修复 203/EXEC 错误
    sudo restorecon -R /opt/querystreams/agent sudo systemctl restart querystreams-agent

    如果还是无法运行， journalctl -u querystreams-agent -n 40 --no-pager 显示最后几行日志——将它们粘贴到 支持请求 接下来我们再继续。如果您使用的是 .tar.gz 文件，则可以删除它。 查询流代理 安装完成后，会在“下载”文件夹中显示该文件夹。

    该代理程序会将自身注册为 systemd 服务，简单来说就是它会在机器启动时自动运行。您无需手动启动它，而且也只需在此时下载一次即可。 它从这里开始自动更新。.

  2. 使用您的密钥登录

    代理程序安装完成后，在该计算机上打开其页面：

    在你刚刚安装它的那台机器上
    http://localhost:1823

    粘贴您的登录密钥。查看徽章。 左上角一旦它读到 “已连接到查询流” 看到绿点就表示操作完成。这是代理程序向您的帐户进行自我介绍——也是您在这台机器上需要做的最后一件事。

    如果该服务器没有可供打开浏览器的桌面，您仍然可以通过 SSH 隧道从您自己的计算机访问该页面。运行此命令 你的 电脑，替换成你自己的登录名和服务器名称，然后打开 http://localhost:1823 在浏览器中打开即可。只需操作一次——完成后关闭终端。

    在您自己的电脑上
    ssh -L 1823:localhost:1823 you@your-server

    页面本身也会告诉你同样的事情： “此代理在本地运行您的连接——日常管理在查询流门户中进行。” 这时你应该关闭它，继续在浏览器中操作。

  3. 通过浏览器添加您的第一个连接

    现在返回浏览器中的“查询流”并打开 数据代理 （它在下面） 数据 在顶部菜单中）。您的新经纪人将列在那里。点击 添加连接器 然后按照问题进行操作：选择数据库或应用程序的类型，然后填写你之前收集的详细信息。

    开放数据代理

    您可以在保存之前测试连接，这样就能立即知道详细信息是否正确，而无需稍后再发现。Query Streams 还会为常用数据库提供合理的设置建议，并添加少量现成的示例查询，方便您立即运行。

    保存后，查询流会扫描您的数据库并记录其中的内容——包括表、列以及它们之间的关系。这些信息会填充到查询构建器中的查询列表中，也正是基于此，Nova 才能回答“我们上个月发货了多少订单？”这样的问题，而无需您指定任何表名。您无需手动启用或进行任何配置；它会按计划自动刷新，以便随着数据库的更改而保持更新。

    它读取的是形状，而不是内容。 此步骤涉及表名和列名，而不是行。在大型数据库上，此步骤可能需要几分钟才能完成——您无需等待，完成后会在连接器中显示。 数据代理.

    你的密码永远不会离开那台机器。 保存连接时，详细信息会通过加密链接传输到您的代理，凭据会存储在您自己的计算机上，而不是存储在我们这里。

  4. 运行你的第一个查询

    最快捷的方法：在连接器设置的最后一个屏幕上按“开始查询”。 那打开 查询生成器 您已选择新的连接，无需再进行任何查找。您也可以随时从顶部菜单访问该连接。

    然后，您可以运行一个现成的示例查询，编写自己的查询，或者直接用简单的英语向我们的助手 Nova 提问，让它为您编写查询。

    保存查询后，它就可以在任何地方重复使用：在 Excel 或 Google Sheets 中刷新它、将其添加到计划中、与同事共享、将其交给 AI 助手，或将其转换为其他系统可以调用的网络链接。

    打开查询生成器 获取 Excel 和 Sheets 加载项

各个部分如何契合

你的网络 查询流 在浏览器中 特工 在您的 Windows 电脑上 您的数据库 从未移动 仅限设置 您的结果 读它
您只需在浏览器中进行设置。代理程序会在您的网络内部进行读取操作。只有您查询所需的行才会被发送回来——而且代理程序始终通过拨号连接，因此无需将任何内容暴露在互联网上即可正常工作。

您可以通过浏览器管理所有操作。

代理安装并登录后， 你不需要再回到那台机器那里了。 所有的一切——连接、要包含的数据库、数据刷新频率、代理的所有自身设置——都由系统管理。 数据代理 无论您身在何处，都可以在您的浏览器中使用。

在浏览器中查询流

无论身在何处，你都能完成以下所有操作：

  • 添加、编辑和删除连接
  • 测试连接
  • 选择要包含哪些数据库
  • 设置数据刷新频率
  • 所有代理设置

经纪人的个人页面

一份工作，你可能永远都不需要它：

  • 检查代理为何无法访问查询流

如果您的代理在浏览器中显示为离线状态，但您找不到原因，请打开 localhost:1823 在那台机器上。左上角的徽章会立刻告诉你（看看这四个州是什么意思），而且它能够从它所处的位置看到网络——这是你的浏览器无法做到的。

代理人将完全放手不管。 它的设计理念是安装一次即可高枕无忧。所有操作都在向其迁移。 数据代理 在浏览器中，代理程序自身的页面只会保留一些信息，帮助您找出它无法访问查询流的原因。因此，如果指南或同事告诉您需要在代理程序机器上进行某些配置，请先检查浏览器。

如果您阅读过本指南的旧版本： 它说必须在代理商自己的页面上设置连接， 不 在浏览器中操作。现在情况已有所不同——浏览器是执行此操作的唯一途径。您之前以旧方式设置的任何内容仍然有效，您可以在数据代理中找到它们。

代理是否正在与查询流通信？

代理页面左上角的那个徽章几乎可以解答所有“为什么不起作用？”的问题。它总是显示以下四种情况之一，而文字说明则准确地告诉你目前的情况。这就是你要找的：

已连接到查询流
连接到查询流 重新连接到查询流
已断开与查询流的连接

连接和重新连接的状态显示相同——一条移动的彩色条带，表示“正在处理”。稳定的绿色光表示已连接。暗淡的图标表示未连接。

那个小灯不是按钮。 它只显示状态——点击它没有任何反应。 连接, 重新连接 和 断开 页面下方“连接”面板上的控件被命名为按钮，这是有意为之：一个未标记的指示灯，点击后会悄悄地使您的代理离线，这是一个值得移除的陷阱。

一切顺利已连接到查询流

一切正常。您的查询将会运行，您在浏览器中所做的任何更改都会在几秒钟内传达至此代理。无需任何操作。

启动连接到查询流

机器启动或代理重启后，几秒钟内出现此现象属正常。请稍等片刻。

正在处理中重新连接到查询流

连接断开了，代理程序正在自行恢复连接——通常只是短暂的网络故障，不需要您提供任何帮助。

如果数据包在这里停留超过几分钟，说明网络上的某些东西阻塞了传输路径。这种情况值得我们关注。

需要关注已断开与查询流的连接

在这种状态下，此代理上的所有功能都无法使用。 实际进行读取的是代理人，所以如果无法联系到代理人，就无法完成这项工作。

检查机器是否在线，然后按 重新连接 在“连接”面板中。如果连接仍然无法恢复，通常是防火墙或代理阻止了出站流量——请给我们留言，我们会帮您找出问题所在。

代理断开连接时，哪些功能会停止运行？ 所有需要接触其数据的事物：

  • 针对其连接的查询将无法运行——无论是在查询构建器、Excel 或 Google Sheets 中、通过 REST API 还是通过 AI 助手。
  • 该数据的计划刷新和自动化操作不会发生。
  • 无法通过浏览器测试、浏览或刷新其连接。
  • 在数据代理中，它显示为离线状态，您看到的数字是…… 最后已知 而不是活着的

不过，一切都不会丢失。浏览器离线期间您保存的更改会被保留，并在浏览器重新连接后立即生效——因此您可以继续进行设置，无需等待。

遇到网络连接问题需要联系我们吗？ 该页面上的“连接”面板列出了对我们帮助最大的四件事。请将它们复制到您的…… 支持 信息发送完毕后，我们通常可以跳过来回沟通：

机器
代理人正在使用哪台电脑？
组织
它关联到哪个账户
代理版本
它运行的是哪个版本？
自
它上次成功连接的时候

它会不断更新自身信息。

您只需安装一次代理程序。之后无需再次下载，也不会有“有更新可用”的提示需要您留意——当我们发布新版本时，您的代理程序会自动处理，通常只需片刻即可完成。

它提供了三种查询方式，因此不会错过任何更新：

通常 片刻之后

我们发布更新后，会立即通过代理程序已建立的连接推送更新。更新完成后，代理程序会立即重启自身。

如果它被关掉了 重新连接后几秒钟

它会在重新上线几秒钟后询问是否错过了什么，然后进行补全。

双保险 每天一次，单独使用

它还会每天使用自己的对外连接进行检查——因此即使在严格封闭的网络中，它也能保持最新状态。

如何判断它是否跟得上进度。 代理页面上的“连接”面板显示 代理版本正常情况下，它会自动跟踪我们当前的版本。如果您发现它连续几天都远远落后于版本，则说明网络上的某些东西阻塞了更新路径——这值得注意。 给我们留言因为这不是特工能够靠三言两语就能摆脱的困境。

新连接何时开始生效？

几乎总是在几秒钟内。具体答案取决于您的代理：

通常 几秒钟

代理程序正在运行且已更新至最新版本，因此能够立即检测到更改，无需重启。

如果它被关掉了 当它重新连接时

您的更改已安全保存，并在机器恢复在线后立即生效。

资深经纪人 下次重启时

这种情况很少见，因为代理程序会自动更新。查询流会在屏幕上显示这是否适用于您的代理程序。

Reading files on a network share

If a connector needs a file or folder on a network share, mount the share on this machine before you add the connector. That’s an administrator step, and the mount has to go under /mnt 或 /媒体, because the Agent’s service can’t see /home 或 /run/user. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\server\share path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, 测试连接 says it is not mounted and shows the exact command to run.

How to mount a share for the Agent on Linux

常见问题

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

在您的浏览器中， 数据代理 页面 — 使用 添加连接器更改通常会在几秒钟内到达您的代理。如果代理处于离线状态，更改会在它重新连接后立即生效。您无需操作代理计算机即可添加或更改连接。

我的数据会被复制到查询流吗？

不，您的数据库位置不变。当您运行查询时，代理程序会读取您的数据库，并仅返回查询请求的行。您的数据库密码保留在代理程序的服务器上。

我需要开放端口还是修改防火墙设置？

通常情况下不需要。代理程序会像网络浏览器一样向我们建立出站连接。它不需要接收来自互联网的传入流量。

我可以使用多个代理吗？

是的——很多组织会为每个站点或每个网络运行一个代理。它们都会显示在您的帐户中，因此对于编写查询的人来说，哪个代理持有哪个连接并不重要。

我需要不断更新吗？

不，也不需要点击任何东西。当我们发布新版本时，它会通过您代理已建立的连接推送，因此通常会在片刻内更新并自动重启。此外，它每天还会自动检查一次，以确保万无一失。您可以在下方查看当前版本。 代理版本 在其连接面板上。

如果我做到一半就卡住了怎么办？

给我们留言 支持 请在查询流中告诉我们您跳转到了哪里。如果这样更容易，请说明您正在查看哪个屏幕以及您期望看到什么——通常这些信息足以让我们找到问题所在。

计划没按预期进行？这值得告诉我们。 打开 支持 您可以在“查询流”中给团队发送消息，或浏览“知识库”选项卡查找更多指南。如果此页面上的某个步骤与您在屏幕上看到的内容不符，也请告知我们——这意味着指南需要改进，而不是您的问题。
安装在其他地方？ Windows macOS

Setup trouble?

  • Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
更新 10 月 12, 2026

您的感觉是什么

  • Happy
  • 常规
  • Sad

Powered by BetterDocs