Arc OS Docs Open in app →

Local Bridge — Настройка macOS

Гайд по установке для macOS. Общий обзор, чеклист перед стартом, ошибки, модель безопасности и диагностика — в Local Bridge — Гайд по настройке.

Общее время: ~60 секунд при условии, что токен уже скопирован.

Сначала определи свой чип

Твой Mac Нажми эту кнопку в CRM Получишь файл
Apple Silicon (M1 / M2 / M3 / M4 / M5) macOS (Apple Silicon) bridge-darwin-arm64.tar.gz (~50 МБ)
Intel (Mac до 2020) macOS (Intel) bridge-darwin-x64.tar.gz (~50 МБ)

Не знаешь, какой у тебя чип? Кликни логотип 🍎 (верхний левый угол) → About This Mac → ищи «Chip: Apple M1/M2/M3/M4/M5» (Apple Silicon) или «Processor: Intel Core …» (Intel). Если не уверен — Apple Silicon: каждый Mac, проданный после ноября 2020 года.

Шаги ниже одинаковы для обоих чипов. Просто замени arm64 ↔ x64 в именах папок и бинарников.

1. Скачай

В CRM: Settings → Integrations → Bridge Setup → 🍎 macOS (Apple Silicon) (или 🍏 для Intel).

Safari скачает bridge-darwin-arm64.tar.gz и автоматически распакует его в ~/Downloads/bridge-darwin-arm64/.

🎞️ Заглушка GIF — media/bridge/macos-download.gif Спецификация: 8-секундная запись экрана — курсор кликает кнопку 🍎 → прогресс-бар Safari заполняется → папка появляется в Finder.

Папка содержит:

bridge-darwin-arm64/
├── bridge-darwin-arm64    ← бинарник
├── install.sh             ← shell-скрипт (для терминала)
└── install.command        ← лаунчер для Finder

2. Запусти установщик

Простой способ (Finder, без Terminal)

🎞️ Заглушка GIF — media/bridge/macos-rightclick-open.gif Спецификация: 12-секундная запись — Finder открыт в ~/Downloads/bridge-darwin-arm64/, правый клик по install.command, выбор Open из меню, появляется диалог «developer cannot be verified», клик Open, запускается Terminal с установщиком.

  1. Открой ~/Downloads/bridge-darwin-arm64/ в Finder
  2. Правый клик по install.command → Open
  3. Нажми Open в диалоге «developer cannot be verified»
  4. Terminal запустится и автоматически выполнит установщик

❗ Правый клик → Open обязателен при первом запуске. Обычный двойной клик вызовет жёсткую блокировку Gatekeeper. После первого успешного запуска двойной клик будет работать всегда.

Способ для продвинутых (Terminal)

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

3. Подключись

Перед запуском возьми из CRM два значения:

Что Где
Токен Settings → Integrations → Bridge Setup → нажми Copy (JWT, TTL 24 ч)
Техническое имя проекта Sidebar → твой проект → slug из URL (строчный с дефисами, не отображаемое имя)

Затем bridge запросит три значения:

Token (paste from CRM):  ⌘+V
Project name:             <project>
Server URL [enter for default]:  нажми ⏎

🖼️ Заглушка скриншота — media/bridge/macos-connected.png Спецификация: окно Terminal после подключения. Видимые строки: ✓ Token validated · ✓ Connected to ws://…/ws/local-bridge · Watching <abs-path>. Заголовок окна: Terminal — install.command.

В: Зачем имя проекта, если их несколько? Один экземпляр bridge привязывается к одному проекту — воркеры этого проекта читают файлы только из директории, из которой запущен bridge (песочница). Для работы с несколькими проектами запускай по одному bridge на проект в отдельной директории.

В: Зачем Server URL? Просто нажми Enter. По умолчанию указывает на производственный релей Arc OS. Кастомный URL — для self-hosted установок; тебе не нужно его менять.

Если видишь ✓ Connected, готово. Переключись в CRM → Bridge Setup и убедись, что есть зелёная точка.

❌ Три вещи, которые НЕ стоит делать на macOS

🖼️ Заглушка скриншота — media/bridge/macos-damaged-error.png Спецификация: диалог macOS "bridge-darwin-arm64" is damaged and can't be opened. с кнопками Move to Trash / Cancel. Аннотация: красный X над Move to Trash, зелёная галочка над Cancel.

Не делай Почему Что делать вместо
Двойной клик по bridge-darwin-arm64 напрямую Gatekeeper помечает его «damaged» — запутанно, но ожидаемо для неподписанных бинарников Сначала запусти install.command — он снимает атрибут карантина
Нажать «Move to Trash» в диалоге damaged Потеряешь скачанный бинарник Нажми Cancel и используй install.command
Перетащить папку в Applications Bridge должен запускаться из директории запуска (корень песочницы) Запускай прямо из ~/Downloads/bridge-darwin-arm64/

Запуск в фоне (daemonize)

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

Постоянный режим службы (launchd) запланирован в фазе 23.4.

Что дальше