Query Streams Agent는 어떤 Linux 배포판을 지원합니까?

.deb 패키지는 Ubuntu 20.04 이상, Debian 11 이상을 지원합니다. install.sh가 포함된 .tar.gz 파일은 RHEL 8 이상, CentOS Stream, Fedora, Amazon Linux 2를 포함한 모든 Linux x86-64 배포판에서 작동합니다.

Query Streams Agent를 사용하려면 Linux에서 방화벽 포트를 열어야 합니까?

아니요. 에이전트는 443번 포트를 통해서만 외부 HTTPS 연결을 수행합니다. 인바운드 방화벽 규칙은 필요하지 않습니다.

Linux에 Query Streams 에이전트를 설치하는 방법

읽는 데 9분 소요

리눅스 네트워크 에이전트

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] 서비스가 실행 중입니다.

>웹 UI: http://localhost:1823

쿼리스트림 에이전트.서비스 활성(실행 중)

다른 운영체제에 설치하시나요?

윈도우

macOS

Linux 에이전트가 온라인 상태가 된 후 Query Streams가 수행할 수 있는 모든 작업을 확인하세요. 무료로 시작하기

커넥터

+ API

라이브 데이터

스프레드시트에서 저장된 SQL 쿼리를 직접 실행

Excel 시트

BI 및 AI 분석

연결된 데이터를 통해 Nova에게 질문하세요.

노바 만나기

데이터베이스 REST API

저장된 쿼리를 안전한 엔드포인트로 전환합니다.

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 서비스 부팅 시 자동으로 시작되고 조용히 자체 업데이트됩니다. 로컬 에이전트 대시보드에서 데이터 커넥터를 추가한 다음 쿼리 스트림 포털을 사용하여 첫 번째 저장된 쿼리를 구축하세요.

시작하기 전에

지원되는 배포판

우분투 20.04+ 그리고 데비안 11+ ~을 통해 .deb 패키지 또는 RHEL 8+, CentOS 스트림 8+, 페도라 36+, 및 아마존 리눅스 2 보편적인 것을 통해 .tar.gz 아카이브. x86-64(AMD64) 전용.

sudo / 루트 액세스

설치 스크립트를 실행하고, 전용 서비스 사용자를 생성하고, systemd 유닛을 등록하는 데 필요합니다. 에이전트 자체는 루트가 아닌 사용자 권한으로 실행됩니다. 쿼리스트림 나중에 정산하세요.

아웃바운드 HTTPS

에이전트가 Streams 클라우드 서비스를 쿼리하려면 443번 포트에 대한 외부 HTTPS 액세스가 필요합니다. 인바운드 방화벽 규칙은 필요하지 않습니다.

데이터베이스 네트워크 액세스

데이터베이스 또는 API 소스와 동일한 네트워크, VPC 또는 라우팅 가능한 환경에 있는 Linux 서버에 에이전트를 설치하십시오.

1단계: Linux 에이전트를 다운로드합니다.

로그인하세요 my.querystreams.com/download.
선택하다 리눅스 에이전트 다운로드 옵션에서.
다운로드하세요 .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 — 우분투/데비안

# 설치 — 패키지 스크립트가 모든 것을 자동으로 처리합니다. 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 install.sh

두 옵션 모두 다음을 생성합니다. 쿼리스트림 서비스 사용자가 파일을 복사합니다. /opt/querystreams/agent/설치 및 활성화 쿼리스트림 에이전트.서비스 systemd 유닛이며, 즉시 시작됩니다.

서비스가 실행되면 로컬 대시보드는 다음 주소에서 이용 가능합니다. http://localhost:1823 서버에서 직접 접속하거나 워크스테이션에서 SSH 터널을 통해 접속할 수 있습니다. 이 주소는 인증 키를 입력하고 로컬 데이터 커넥터를 관리하는 데 사용됩니다. 데이터베이스 자격 증명은 에이전트 시스템에 저장되며 Query Streams 클라우드로 전송되지 않습니다.

3단계: 에이전트를 계정에 연결합니다.

로컬 에이전트 대시보드에서 http://localhost:1823Query Streams 인증 키를 붙여넣으세요.
키를 저장하고 에이전트가 조직에 등록될 때까지 기다리세요.
서비스가 정상적으로 작동하는지 확인하십시오. sudo systemctl status querystreams-agent — 보여줘야 합니다 활성(실행 중).
선택하다 데이터 소스 추가 로컬 연결 마법사를 엽니다.

4단계: 로컬 에이전트에 첫 번째 데이터 소스를 추가합니다.

쿼리 스트림 포털에서 커넥터를 추가하거나 편집하지 마십시오. 커넥터 설정은 로컬 네트워크 에이전트 대시보드에서 수행합니다. http://localhost:1823여기에서 PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation 또는 iTick과 같은 데이터베이스 또는 API 커넥터를 추가, 편집, 테스트 및 삭제할 수 있습니다.

Linux 에이전트 머신에서 브라우저를 열거나(또는 SSH 터널을 통해) 다음 주소로 이동하십시오. http://localhost:1823.
클릭 데이터 소스 추가 또는 에이전트 연결 영역을 엽니다.
데이터베이스 또는 API 커넥터 유형을 선택하세요.
Linux 에이전트 시스템에서 유효한 연결 정보를 입력하십시오.
메시지가 표시되면 데이터 영역을 선택하십시오.
연결을 테스트한 다음 저장하세요.
지원되는 데이터베이스 커넥터의 경우, 쿼리 빌더, Nova AI 및 MCP 클라이언트가 더 풍부한 테이블 및 열 컨텍스트를 얻을 수 있도록 스키마 인텔리전스를 활성화된 상태로 유지하십시오.

PostgreSQL호스트, 포트, 데이터베이스, SSL

MySQL / MariaDB호스트, 포트, 데이터베이스, SSL

SQL Server서버, 데이터베이스, 사용자 이름, 비밀번호

로컬 파일SQLite, DuckDB

API 커넥터자격 증명, 동기화 일정, 데이터 영역

MCP 준비 완료AI 클라이언트는 커넥터에 직접 쿼리할 수 있습니다.

네트워크 모델

# 커넥터 관리 로컬 에이전트 대시보드: http://localhost:1823 # 리눅스 에이전트 systemd 서비스로 실행되며, 자격 증명을 로컬에 저장하고 외부 연결을 설정합니다. # 데이터베이스/API 에이전트의 개인 네트워크 연결 # 스트림 클라우드 쿼리 커넥터 메타데이터를 수신하고 쿼리 요청을 라우팅합니다.

5단계: 첫 번째 쿼리를 작성하고 저장하세요

에이전트에서 커넥터와 데이터베이스를 구성한 후, 쿼리 스트림 포털을 열고 쿼리 빌더를 사용하여 첫 번째 저장된 쿼리를 생성하세요. 저장된 쿼리는 Excel, Google Sheets, 자동화, 보안 REST API 엔드포인트 및 공유 사용자가 원시 SQL이나 데이터베이스 자격 증명을 보지 않고 실행할 수 있는 쿼리입니다.

열려 있는 쿼리 빌더 쿼리 스트림 포털에서.
로컬 에이전트에 구성한 데이터 커넥터와 데이터베이스를 선택하십시오.
SQL 쿼리를 작성하거나 생성하고 미리 보기를 실행합니다.
쿼리를 명확한 이름으로 저장하고 사용자가 조정할 수 있도록 필터를 추가하세요.
저장된 쿼리를 Microsoft Excel, Google Sheets, 자동화, REST API 또는 공유 대시보드에서 실행할 수 있습니다.

현지 에이전트

커넥터를 추가, 편집, 테스트 및 삭제하려면 다음 링크를 이용하세요. 로컬호스트:1823.

쿼리 빌더

커넥터를 선택하고, 데이터베이스를 선택하고, SQL을 작성하고, 미리 보기를 한 다음 저장합니다.

사용자 도구

저장된 쿼리는 Excel, Google Sheets, 자동화 기능 및 API에서 사용할 수 있습니다.

MCP 액세스

MCP 클라이언트는 에이전트를 통해 사용 가능한 커넥터를 확인하고 데이터베이스를 직접 쿼리할 수도 있습니다.

서비스 관리 참조

bash — 일반적인 관리 명령어

# 시작/정지/재시작 sudo systemctl 시작 쿼리스트림 에이전트 sudo systemctl stop 쿼리스트림 에이전트 sudo systemctl restart 쿼리스트림 에이전트 # 현재 상태 확인 sudo systemctl status 쿼리스트림 에이전트 # 실시간 로그 보기 sudo journalctl -u 쿼리스트림 에이전트 -에프 # 최근 100개 로그 라인 보기 sudo journalctl -u 쿼리스트림 에이전트 -n 100 –호출기 없음

에이전트 제거

패키지에는 다음이 포함됩니다. uninstall.sh 서비스를 중지하고 파일을 삭제하며, 선택적으로 구성 및 로그를 보존하는 스크립트입니다.

bash — 우분투/데비안(.deb 제거)

# 패키지 제거 (설정 파일은 유지) sudo dpkg -r 쿼리스트림 에이전트 # 전체 삭제 — 구성, 로그 및 서비스 사용자도 삭제합니다. sudo dpkg –purge 쿼리스트림 에이전트

bash — tar.gz 제거

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

제거 스크립트는 다음과 같은 메시지를 표시합니다. "설정 정보와 로그를 유지하시겠습니까? (예/아니오)" - 입력하다 y 당신의 것을 보존하기 위해 앱 설정 json 그리고 로그/ 폴더 또는 N 모든 것을 제거하기 위해.

문제 해결

해당 담당자는 온라인에 나타나지 않습니다. +

서비스 로그를 확인하세요: sudo journalctl -u querystreams-agent -n 50 --no-pager일반적인 원인: 로컬 웹 UI에 잘못된 인증 키를 입력한 경우 http://localhost:1823방화벽에 의해 아웃바운드 포트 443이 차단되었습니다(테스트 대상). curl -v https://my.querystreams.com); DNS 확인 실패 (nslookup my.querystreams.com).

데이터베이스 연결 테스트가 실패했습니다. +

에이전트가 설치된 Linux 시스템에서 테스트하십시오. 에이전트는 데이터베이스 호스트 및 포트에 직접 연결할 수 있어야 합니다. 또한 데이터베이스 사용자 이름이 쿼리하려는 테이블 또는 뷰에 대한 읽기 권한이 있는지 확인하십시오.

방화벽에서 들어오는 포트를 열어야 하나요? +

아니요. 에이전트는 쿼리 스트림으로 나가는 암호화된 연결을 생성합니다. 쿼리 요청은 해당 연결을 통해 전송되므로 PostgreSQL, MySQL, SQL Server 또는 기타 데이터베이스가 공용 인터넷에 노출되지 않습니다.

데이터베이스 자격 증명은 어디에 저장되나요? +

데이터베이스 자격 증명은 다음 위치에 저장됩니다. /opt/querystreams/agent/appsettings.json 에이전트 머신에서. Query Streams 클라우드는 에이전트를 통해 쿼리 요청을 라우팅하기 위해 원시 데이터베이스 암호가 필요하지 않습니다.

커넥터를 추가, 편집 또는 삭제하려면 어디에 있어야 하나요? +

네트워크 에이전트의 로컬 대시보드를 사용하세요. http://localhost:1823쿼리 스트림 포털은 에이전트에 커넥터가 구성된 후 저장된 쿼리를 구축하고 액세스를 공유하는 곳입니다.

에이전트를 두 개 이상 설치할 수 있나요? +

예. 각 서버는 동일한 조직 인증 키를 사용하여 독립적인 에이전트를 실행합니다. 온프레미스, AWS EC2, Azure VM, Google Cloud 또는 지사 컴퓨터에 설치할 수 있습니다. 모든 에이전트는 포털에 개별 항목으로 표시되며, 각각 자체적으로 구성된 데이터베이스를 갖습니다.

자동 업데이트는 어떻게 작동하나요? +

에이전트는 설치 경로를 감지합니다. .deb 또는 tar.gz 또한 그에 따라 업데이트를 적용하고 백업 및 복원합니다. 앱 설정 json 업그레이드 과정 전반에 걸쳐 진행됩니다. 이 프로세스는 별도의 백그라운드 스크립트로 실행되므로 다운타임이나 수동 작업이 필요하지 않습니다.

설치 후에는 무엇을 해야 하나요? +

Query Streams 포털에서 저장된 쿼리를 생성한 다음 Microsoft Excel, Google Sheets, Nova AI, Claude 또는 Cursor와 같은 MCP 클라이언트, 예약된 자동화 또는 보안 REST API 엔드포인트에서 실행할 수 있습니다.

시작하기

Linux 에이전트를 설치하고 첫 번째 데이터 소스를 연결하세요.

한 번의 명령으로 설치 스크립트를 실행하고, localhost:1823에서 로컬로 커넥터를 구성한 다음, Excel, Google Sheets, 자동화, MCP, REST API 및 Nova AI에 사용할 수 있는 재사용 가능한 쿼리를 저장하세요.

Linux 에이전트 다운로드

카테고리: 설정

태그: Linux, 쿼리 스트림 에이전트, 네트워크 에이전트, 설정, 데이터베이스 커넥터, systemd

메타 설명: Query Streams Agent를 Linux에 설치하고 systemd 서비스로 실행 중인 데이터베이스에 안전하게 연결하세요.

Updated on 2026년 7월 2일

What are your Feelings

Happy
Normal
Sad