Local Bridge — Konfiguracja Windows

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

Łączny czas: ~60 sekund łącznie z potwierdzeniem SmartScreen. Testowane na Windows 10 i 11.

1. Pobieranie

W CRM: Settings → Integrations → Bridge Setup → 🪟 Windows (x64).

Pobierasz bridge-windows-x64.exe bezpośrednio (bez archiwum — Windows nie ma systemu kwarantanny podobnego do Gatekeepera).

Rozmiar pliku: ~55 MB. Domyślnie pobierany do %USERPROFILE%\Downloads\.

2. Uruchom

🎞️ Miejsce na GIF — media/bridge/windows-smartscreen.gif Specyfikacja nagrania: 10-sekundowe nagranie — dwuklik .exe, niebieski dialog Windows protected your PC, kliknięcie More info, kliknięcie Run anyway, Wiersz polecenia otwiera się z promptami bridge.

Kliknij dwukrotnie bridge-windows-x64.exe w folderze Downloads
SmartScreen ostrzega Windows protected your PC → kliknij More info → Run anyway

❗ Okno SmartScreen pojawia się tylko przy pierwszym uruchomieniu. Potem dwuklik uruchamia je bezpośrednio.

Sposób dla zaawansowanych (PowerShell)

cd $HOME\Downloads
.\bridge-windows-x64.exe

Jeśli PowerShell blokuje wykonanie: Set-ExecutionPolicy -Scope Process Bypass dla bieżącej sesji.

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):  Ctrl+V
Project name:             <project>
Server URL [enter for default]:  press ⏎

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.

Uruchamianie w tle (daemonizacja)

PowerShell — ukrywa okno konsoli:

Start-Process .\bridge-windows-x64.exe -WindowStyle Hidden

Lub zaplanuj przez Harmonogram zadań → Create Task → wyzwalacz: At log on → akcja: Start a program: bridge-windows-x64.exe. Tryb trwałej usługi (Windows Service) jest w roadmapie — zob. Phase 23.4.

Ingerencja programu antywirusowego

Niektóre programy AV (Windows Defender, Kaspersky, Bitdefender) poddają kwarantannie niepodpisane pliki binarne. Jeśli plik zniknie po pobraniu:

Otwórz Settings → Privacy & security → Windows Security → Virus & threat protection → Protection history
Znajdź wpis kwarantanny bridge-windows-x64.exe
Kliknij Actions → Allow on device

Komputery firmowe zarządzane przez MDM mogą to blokować — skontaktuj się z IT lub użyj komputera osobistego do bety.

Co dalej

⬅ Wróć do strony głównej — błędy, bezpieczeństwo, diagnostyka i sekcja „co bridge faktycznie robi"
Konfiguracja macOS
Konfiguracja Linux