Arc OS Docs Open in app →

Local Bridge — Konfiguracja macOS

Przewodnik instalacji dla macOS. Ogólny przegląd, lista pre-flight, błędy, model bezpieczeństwa i diagnostyka znajdziesz w Local Bridge — Przewodnik konfiguracji.

Łączny czas: ~60 sekund zakładając, że token jest już skopiowany.

Najpierw sprawdź chip

Twój Mac Kliknij ten przycisk w CRM Pobierz ten plik
Apple Silicon (M1 / M2 / M3 / M4 / M5) macOS (Apple Silicon) bridge-darwin-arm64.tar.gz (~50 MB)
Intel (Mac sprzed 2020) macOS (Intel) bridge-darwin-x64.tar.gz (~50 MB)

Nie wiesz, jaki masz chip? Kliknij logo 🍎 (lewy górny róg) → About This Mac → szukaj „Chip: Apple M1/M2/M3/M4/M5" (Apple Silicon) lub „Processor: Intel Core …" (Intel). W razie wątpliwości: Apple Silicon — każdy Mac sprzedany od listopada 2020.

Poniższe kroki są identyczne dla obu chipów. Zamień tylko arm64 ↔ x64 w nazwach folderów i pliku binarnego.

1. Pobieranie

W CRM: Settings → Integrations → Bridge Setup → 🍎 macOS (Apple Silicon) (lub 🍏 dla Intel).

Safari pobiera bridge-darwin-arm64.tar.gz i automatycznie rozpakowuje do ~/Downloads/bridge-darwin-arm64/.

🎞️ Miejsce na GIF — media/bridge/macos-download.gif Specyfikacja nagrania: 8-sekundowe nagranie ekranu — kursor klika przycisk 🍎 → pasek postępu Safari wypełnia się → folder pojawia się w Finderze.

Folder zawiera:

bridge-darwin-arm64/
├── bridge-darwin-arm64    ← plik binarny
├── install.sh             ← skrypt powłoki (przyjazny terminalowi)
└── install.command        ← launcher przyjazny Finderowi

2. Uruchom instalator

Łatwy sposób (Finder, bez Terminala)

🎞️ Miejsce na GIF — media/bridge/macos-rightclick-open.gif Specyfikacja nagrania: 12-sekundowe nagranie — Finder otwarty na ~/Downloads/bridge-darwin-arm64/, kliknięcie prawym przyciskiem install.command, wybór Open z menu, pojawia się dialog „developer cannot be verified", kliknięcie Open, Terminal uruchamia się z działającym instalatorem.

  1. Otwórz ~/Downloads/bridge-darwin-arm64/ w Finderze
  2. Kliknij prawym przyciskiem install.command → Open
  3. Kliknij Open w oknie dialogowym „developer cannot be verified"
  4. Terminal uruchamia się i automatycznie wykonuje instalator

❗ Kliknięcie prawym przyciskiem → Open jest obowiązkowe przy pierwszym uruchomieniu. Zwykłe dwukliknięcie powoduje twardy blok Gatekeepera. Po pierwszym udanym uruchomieniu dwuklik działa zawsze.

Sposób dla zaawansowanych (Terminal)

cd ~/Downloads/bridge-darwin-arm64
bash install.sh

3. Połącz się

Przed uruchomieniem pobierz dwie wartości z CRM:

Co Gdzie
Token Settings → Integrations → Bridge Setup → kliknij Copy (JWT, TTL 24h)
Techniczna nazwa projektu Sidebar → twój projekt → slug URL (np. ta małymi literami z myślnikami, nie nazwa wyświetlana)

Bridge następnie prosi o trzy wartości:

Token (paste from CRM):  ⌘+V
Project name:             <project>
Server URL [enter for default]:  press ⏎

🖼️ Miejsce na zrzut ekranu — media/bridge/macos-connected.png Specyfikacja zdjęcia: okno Terminala po połączeniu. Widoczne linie: ✓ Token validated · ✓ Connected to ws://…/ws/local-bridge · Watching <abs-path>. Tytuł okna: Terminal — install.command.

P: Dlaczego nazwa projektu, jeśli mam ich kilka? Jedna instancja bridge jest powiązana z jednym projektem — workerzy z tego projektu czytają pliki tylko z katalogu, z którego uruchomiono bridge (piaskownica). Aby pracować z wieloma projektami, uruchom po jednym bridge na projekt w jego własnym katalogu.

P: Dlaczego adres URL serwera? Po prostu naciśnij Enter. Domyślny wskazuje na przekaźnik produkcyjny Arc OS. Niestandardowy URL jest dla instalacji self-hosted; nie musisz go zmieniać.

Jeśli widzisz ✓ Connected, gotowe. Przejdź do CRM → Bridge Setup i potwierdź zielony punkt.

❌ Trzy rzeczy, których NIE robić na macOS

🖼️ Miejsce na zrzut ekranu — media/bridge/macos-damaged-error.png Specyfikacja zdjęcia: dialog macOS "bridge-darwin-arm64" is damaged and can't be opened. z przyciskami Move to Trash / Cancel. Adnotacja: czerwone X nad Move to Trash, zielony znacznik wyboru nad Cancel.

Nie rób Dlaczego Zamiast tego
Kliknij dwukrotnie bridge-darwin-arm64 bezpośrednio Gatekeeper oznaczy go jako „damaged" — mylące, ale oczekiwane dla niepodpisanych plików binarnych Najpierw uruchom install.command; usuwa atrybut kwarantanny
Kliknij „Move to Trash" przy dialogu damaged Tracisz pobrany plik binarny Kliknij Cancel i użyj install.command
Przeciągnij folder do Applications Bridge musi działać z katalogu, w którym go uruchomiono (korzeń piaskownicy) Uruchom bezpośrednio z ~/Downloads/bridge-darwin-arm64/

Uruchamianie w tle (daemonizacja)

nohup ./bridge-darwin-arm64 > bridge.log 2>&1 &

Tryb trwałej usługi (launchd) jest w roadmapie — zob. Phase 23.4.

Co dalej