Local Bridge — Konfiguracja Linux

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

Łączny czas: ~45 sekund — bez utrudnień Gatekeepera.

Wybierz architekturę

Twój komputer	Kliknij ten przycisk w CRM	Pobierz ten plik
Większość laptopów, desktopów, VM, serwery x86	Linux (x64)	bridge-linux-x64.tar.gz (~50 MB)
Raspberry Pi, AWS Graviton, serwery ARM	Linux (arm64)	bridge-linux-arm64.tar.gz (~50 MB)

Nie wiesz? Uruchom uname -m w terminalu. x86_64 → wybierz x64. aarch64 lub arm64 → wybierz arm64.

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

1. Pobieranie

W CRM: Settings → Integrations → Bridge Setup → 🐧 Linux (x64) (lub arm64).

Plik bridge-linux-<arch>.tar.gz trafia do ~/Downloads/.

2. Rozpakuj i uruchom

cd ~/Downloads
tar -xzf bridge-linux-x64.tar.gz
cd bridge-linux-x64
bash install.sh

Niektóre przeglądarki (Firefox, GNOME Web) automatycznie rozpakowują przy pobieraniu. Jeśli masz już folder, pomiń linię z tar.

🎞️ Miejsce na GIF — media/bridge/linux-install.gif Specyfikacja nagrania: 15-sekundowe nagranie terminala (eksport asciinema do GIF) — tar -xzf … → cd → bash install.sh → prompty instalatora → ✓ Connected.

Instalator automatycznie uruchamia chmod +x na pliku binarnym.

3. Połącz się

Przed uruchomieniem pobierz dwie wartości z CRM:

Bridge następnie prosi o trzy wartości:

Token (paste from CRM):  Ctrl+Shift+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)

nohup ./bridge-linux-x64 > bridge.log 2>&1 &

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

ripgrep — zalecane

Narzędzie search_files przechodzi do wolnego natywnego skanowania, jeśli ripgrep nie jest zainstalowany. Dla błyskawicznego wyszukiwania:

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

Co dalej

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