Wyświetl kategorie

Jak zainstalować agenta Query Streams w systemie macOS

9 minut czytania

Logo macOS Agent sieciowy macOS

Zainstaluj Query Streams na macOS

Uruchom agenta sieciowego Query Streams Network Agent obsługującego tylko połączenia wychodzące w systemie macOS 12 Monterey lub nowszym. Jeden skrypt instalacyjny rejestruje go jako agenta systemowego. uruchomiony daemon — natywne kompilacje dla Apple Silicon (M1–M4) i Intel. Użyj lokalnego pulpitu agenta pod adresem http://localhost:1823 aby zarejestrować agenta i zarządzać łącznikami danych, a następnie tworzyć zapisane zapytania w portalu Query Streams dla programów Excel, Google Sheets, automatyzacji, interfejsów API REST, MCP i Nova AI.

Konfiguracja lokalnego złącza Brak portów przychodzących zapory sieciowej Działa jako usługa launchd
Terminal — zsh
%tar -xzf querystreams-agent_x.x.x_osx-arm64.tar.gz
%sudo bash install.sh|
>[4/4] Usługa jest uruchomiona.
>Interfejs użytkownika sieci Web: http://localhost:1823
com.querystreams.agent działanie
Instalujesz na innym systemie operacyjnym?

Query Streams to bezpieczna platforma dostępu do danych w czasie rzeczywistym, która umożliwia użytkownikom komputerów Mac i zespołom programistycznym łączenie baz danych na żywo z programami Excel, Arkuszami Google, automatyzacjami, narzędziami AI zgodnymi z MCP i gotowymi do współpracy interfejsami API REST. Więcej informacji można znaleźć na stronie QueryStreams.com. oraz zarejestruj się za darmo aby zainstalować pierwszego agenta macOS.

W tym przewodniku opisano instalację agenta na macOS. Pakiet zawiera: skrypt instalacyjny z jednym poleceniem który kopiuje pliki do /usr/local/querystreams/agent/ i rejestruje demon launchd na poziomie systemu — dostępne jako natywne kompilacje ARM64 (Apple Silicon M1–M4) i natywne kompilacje x64 (Intel). Dodaj złącza danych w lokalnym panelu agenta, a następnie użyj portalu Query Streams, aby utworzyć pierwsze zapisane zapytanie.

Zanim zaczniesz

Obsługiwane wersje systemu macOS

macOS 12 Monterey lub nowsze (Monterey, Ventura, Sonoma, Sequoia). Zarówno Apple Silicon, jak i Intel obsługują natywne pliki binarne.

Dostęp administratora/sudo

Wymagane. Skrypt instalacyjny uruchamia się jako root, aby zainstalować /usr/local/ i zarejestruj system LaunchDaemon.

Wychodzący HTTPS

Agent potrzebuje wychodzącego dostępu HTTPS na porcie 443 do usług chmurowych Query Streams. Nie jest wymagana żadna reguła zapory dla ruchu przychodzącego.

Dostęp do sieci baz danych

Zainstaluj agenta na komputerze Mac, który znajduje się w tej samej sieci, sieci VPN lub środowisku routowalnym, co Twoja baza danych lub źródło interfejsu API.

Krok 1: Pobierz agenta macOS

1
2
3
4
5
  1. Zaloguj się do my.querystreams.com/download.
  2. Wybierać macOS z opcji pobierania Agenta.
  3. Wybierać ARM64 (Apple Silicon — sprawdź Menu Apple > O tym Macu:jeśli wyświetla się „Apple M1/M2/M3/M4”, użyj tego) lub x64 (Intel Core) i pobierz .tar.gz archiwum.
  4. Skopiuj klucz uwierzytelniający swojej organizacji z tej samej strony pobierania. Będziesz go używać po otwarciu lokalnego pulpitu agenta.

Krok 2: Uruchom skrypt instalacyjny

2
3
4
5

Otwórz Terminal (Aplikacje > Narzędzia > Terminal) i uruchom:

Terminal — zsh
# Wypakuj archiwum tar -xzf querystreams-agent_x.x.x_osx-arm64.tar.gz # Opcjonalnie (podpisane i poświadczone notarialnie, zwykle nie jest wymagane): wyczyść kwarantannę, a następnie uruchom skrypt instalacyjny xattr -dr com.apple.quarantine . sudo bash install.sh

Ten install.sh skrypt wykonuje automatycznie cztery kroki: kopiuje pliki do /usr/local/querystreams/agent/, ustawia prawidłowe uprawnienia, instaluje plik plist launchd /Library/LaunchDaemons/com.querystreams.agent.plist jako demon systemowy i ładuje usługę za pośrednictwem załaduj launchctl — uruchamiając go natychmiast i przy każdym uruchomieniu.

Podpisano i poświadczono notarialnie: Agent Query Streams macOS jest podpisany kodem i poświadczony notarialnie przez Apple, dzięki czemu działa normalnie w systemie Gatekeeper — większość użytkowników nie musi wykonywać żadnych dodatkowych czynności. W rzadkich przypadkach, gdy pojawi się monit o pierwsze uruchomienie (na przykład, jeśli archiwum zostało skopiowane między komputerami po ponownym zastosowaniu flag kwarantanny), wyczyść atrybut kwarantanny za pomocą xattr -dr com.apple.quarantine qs-agent/ i ponownie uruchomić sudo bash install.sh.

Po uruchomieniu usługi lokalny panel będzie dostępny pod adresem http://localhost:1823 na komputerze Mac. Służy do wprowadzania klucza uwierzytelniającego i zarządzania lokalnymi łącznikami danych. Twoje dane uwierzytelniające do bazy danych pozostają na komputerze agenta i nie są wysyłane do chmury Query Streams.

Krok 3: Połącz agenta ze swoim kontem

3
4
5
  1. W lokalnym panelu agenta w http://localhost:1823, wklej swój klucz uwierzytelniania Query Streams.
  2. Zapisz klucz i poczekaj, aż Agent zarejestruje się w Twojej organizacji.
  3. Potwierdź, że usługa jest prawidłowa: sudo launchctl list | grep querystreams.
  4. Wybierz Dodaj źródła danych aby otworzyć kreatora połączeń lokalnych.

Krok 4: Dodaj pierwsze źródło danych w agencie lokalnym

4
5

Nie dodawaj ani nie edytuj łączników z portalu Query Streams. Konfigurację łącznika wykonuje się na pulpicie lokalnego agenta sieciowego. http://localhost:1823Tutaj możesz dodawać, edytować, testować i usuwać łączniki baz danych lub API, takie jak PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation lub iTick.

  1. Otwórz przeglądarkę na komputerze z systemem macOS Agent i przejdź do http://localhost:1823.
  2. Kliknij Dodaj źródła danych lub otwórz obszar połączenia Agenta.
  3. Wybierz typ bazy danych lub łącznika API.
  4. Wprowadź dane połączenia, które są prawidłowe na komputerze z agentem macOS.
  5. Jeśli zostaniesz o to poproszony, wybierz obszar danych.
  6. Przetestuj połączenie i zapisz je.
  7. W przypadku obsługiwanych łączników bazy danych pozostaw opcję Schema Intelligence włączoną, aby klienci Query Builder, Nova AI i MCP uzyskali bogatszy kontekst tabeli i kolumny.
PostgreSQL
PostgreSQLHost, port, baza danych, SSL
MySQL
MySQL / MariaDBHost, port, baza danych, SSL
SQL Server
SQL ServerSerwer, baza danych, nazwa użytkownika, hasło
DuckDB
Pliki lokalneSQLite, DuckDB
Pasek
konektorach APIPoświadczenia, harmonogram synchronizacji, obszar danych
MCP
Gotowy na MCPKlienci AI mogą bezpośrednio wyszukiwać łączniki
Model sieciowy
# Zarządzanie łącznikami Panel lokalnego agenta: http://localhost:1823 # Agent macOS Działa jako demon launchd, przechowuje dane uwierzytelniające lokalnie, łączy się z siecią wychodzącą # Twoja baza danych/API Prywatne połączenie sieciowe z Agentem # Chmura strumieni zapytań Odbiera metadane łącznika i kieruje żądania zapytań

Krok 5: Utwórz i zapisz swoje pierwsze zapytanie

5

Po skonfigurowaniu łącznika i bazy danych w agencie otwórz portal Query Streams i użyj Kreatora zapytań, aby utworzyć pierwsze zapisane zapytanie. Zapisane zapytanie to takie, które można uruchomić w programach Excel, Arkuszach Google, automatyzacjach, bezpiecznych punktach końcowych interfejsu REST API oraz współdzielonych użytkownikach bez konieczności wglądu w surowe dane SQL lub poświadczenia bazy danych.

  1. Otwórz Kreator zapytań w portalu Query Streams.
  2. Wybierz łącznik danych i bazę danych, które skonfigurowałeś w lokalnym Agencie.
  3. Napisz lub wygeneruj zapytanie SQL i uruchom podgląd.
  4. Zapisz zapytanie pod jasną nazwą i wszystkimi filtrami, które użytkownicy mają dostosować.
  5. Uruchom zapisane zapytanie z poziomu programu Microsoft Excel, Arkuszy Google, automatyzacji, interfejsów API REST lub współdzielonych pulpitów nawigacyjnych.
1

Agent lokalny

Dodawaj, edytuj, testuj i usuwaj łączniki w localhost:1823.

2

Kreator zapytań

Wybierz łącznik, wybierz bazę danych, napisz SQL, wyświetl podgląd i zapisz.

3

Narzędzia użytkownika

Zapisane zapytania będą dostępne w programach Excel, Arkuszach Google, automatyzacjach i interfejsach API.

4

Dostęp MCP

Klienci MCP mogą również przeglądać dostępne łączniki i wysyłać zapytania do bazy danych bezpośrednio za pośrednictwem agenta.

Odniesienie do zarządzania usługami

Terminal — zarządzanie launchd
# Zatrzymaj usługę sudo launchctl unload /Library/LaunchDaemons/com.querystreams.agent.plist # Uruchom usługę sudo launchctl load /Library/LaunchDaemons/com.querystreams.agent.plist # Sprawdź status działania sudo launchctl list | grep strumienie zapytań # Przeglądaj logi na żywo ogon -f /usr/local/querystreams/agent/logs/agent-stdout.log # Wyświetl dziennik błędów ogon -f /usr/local/querystreams/agent/logs/agent-stderr.log

Odinstalowywanie agenta

W pakiecie znajduje się: odinstaluj.sh skrypt, który zatrzymuje i rozładowuje usługę launchd, usuwa plik plist z /Biblioteka/Demonów uruchamiania/i usuwa katalog instalacyjny.

Terminal — odinstaluj
sudo bash /usr/local/querystreams/agent/uninstall.sh

Skrypt dezinstalacyjny wyświetli monit: „Zachować konfigurację i logi? (t/N)” - Wchodzić y aby zachować swoje appsettings.json oraz dzienniki/ folder lub N usunąć wszystko.

Rozwiązywanie problemów

macOS wyświetla komunikat „nie można otworzyć, ponieważ nie można zweryfikować programisty” +
Przed uruchomieniem skryptu instalacyjnego usuń atrybut kwarantanny Gatekeeper z wyodrębnionego folderu: xattr -dr com.apple.quarantine qs-agent/, a następnie uruchom ponownie sudo bash install.shAlternatywnie przejdź do Ustawienia systemowe > Prywatność i bezpieczeństwo i kliknij „Pozwól mimo wszystko” po pierwszej zablokowanej próbie.
Agent nie pojawia się w sieci +
Sprawdź logi: ogon -50 /usr/local/querystreams/agent/logs/agent-stdout.log. Najczęstsze przyczyny: nieprawidłowy klucz uwierzytelniania wprowadzony w lokalnym interfejsie internetowym http://localhost:1823; port wychodzący 443 zablokowany przez serwer proxy (test z curl -v https://my.querystreams.com); Gatekeeper nadal blokuje (sprawdź, czy atrybut kwarantanny został usunięty przed instalacją).
Test połączenia z bazą danych nie powiódł się +
Przetestuj na komputerze Mac, na którym zainstalowany jest agent. Agent musi mieć bezpośredni dostęp do hosta i portu bazy danych. Sprawdź również, czy nazwa użytkownika bazy danych ma uprawnienia do odczytu tabel lub widoków, które planujesz przeszukać.
Czy powinienem użyć ARM64 czy x64? +
Przejdź do Menu Apple > O tym Macu. Jeśli na chipie jest napisane „Apple M1/M2/M3/M4”, użyj ARM64. Jeśli wyświetla się „Intel Core”, użyj x64. Użycie niewłaściwej kompilacji nadal będzie działać przez Rosetta 2, ale zawsze preferowana jest pasująca natywna kompilacja.
Czy muszę otwierać porty przychodzące zapory sieciowej? +
Nie. Agent tworzy szyfrowane połączenie wychodzące do strumieni zapytań. Żądania zapytań są przesyłane przez to połączenie, więc nie udostępniasz PostgreSQL, MySQL, SQL Server ani żadnej innej bazy danych publicznie dostępnemu internetowi. Nie są wymagane żadne zmiany w zaporze systemu macOS.
Gdzie są przechowywane dane uwierzytelniające bazy danych? +
Dane uwierzytelniające bazy danych są przechowywane w /usr/local/querystreams/agent/appsettings.json na komputerze agenta. Usługa Query Streams Cloud nie potrzebuje Twojego hasła do bazy danych, aby kierować żądania zapytań przez agenta.
Gdzie mogę dodawać, edytować lub usuwać łączniki? +
Użyj lokalnego pulpitu nawigacyjnego agenta sieciowego pod adresem http://localhost:1823Portal Query Streams to miejsce, w którym można tworzyć zapisane zapytania i udostępniać dostęp po skonfigurowaniu łącznika przez Agenta.
Jak działają automatyczne aktualizacje w systemie macOS? +
Agent sprawdza portal pod kątem nowych wydań pasujących do Twojej platformy (osx-arm64 lub osx-x64). Gdy jest dostępny, wyładowuje plik plist launchd i tworzy kopię zapasową appsettings.json, wyodrębnia nowy plik binarny, przywraca konfigurację i ponownie ładuje usługę — w pełni automatycznie, bez konieczności podejmowania jakichkolwiek działań przez użytkownika.

Rozpocznij

Zainstaluj agenta macOS i podłącz pierwsze źródło danych

Uruchom skrypt instalacyjny składający się z jednego polecenia, skonfiguruj łączniki lokalnie pod adresem localhost:1823, a następnie zapisz wielokrotnego użytku zapytania dla programu Excel, Arkuszy Google, automatyzacji, MCP, interfejsów API REST i Nova AI.

Pobierz agenta macOS

Powiązane przewodniki: Zainstaluj agenta strumieni zapytań w systemie Windows | Zainstaluj agenta strumieni zapytań w systemie Linux | Zainstaluj dodatek Query Streams do Arkuszy Google | Korzystanie ze strumieni zapytań w programie Microsoft Excel

Kategoria: Konfiguracja

Tagi: macOS, agent strumieni zapytań, agent sieciowy, konfiguracja, łącznik bazy danych, launchd

Metaopis: Zainstaluj agenta Query Streams na macOS i bezpiecznie połącz się z bazami danych na żywo jako demon launchd.

Zaktualizowano na lipiec 2, 2026

Powered by BetterDocs