Arc OS Docs Open in app →

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

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

Общее время: ~60 секунд включая подтверждение SmartScreen. Протестировано на Windows 10 и 11.

1. Скачай

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

Получишь bridge-windows-x64.exe напрямую (без архива — у Windows нет карантинной системы наподобие Gatekeeper).

Размер файла: ~55 МБ. По умолчанию скачивается в %USERPROFILE%\Downloads\.

2. Запусти

🎞️ Заглушка GIF — media/bridge/windows-smartscreen.gif Спецификация: 10-секундная запись — двойной клик по .exe, синий диалог Windows protected your PC, клик More info, клик Run anyway, открывается командная строка с запросами bridge.

  1. Двойной клик по bridge-windows-x64.exe в папке Downloads
  2. SmartScreen предупреждает Windows protected your PC → нажми More info → Run anyway

❗ Запрос SmartScreen появляется только при первом запуске. После этого двойной клик запускает напрямую.

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

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

Если PowerShell блокирует выполнение: Set-ExecutionPolicy -Scope Process Bypass для текущей сессии.

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

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

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

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

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

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

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

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

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

PowerShell — скрывает окно консоли:

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

Или запланируй через Task Scheduler → Create Task → триггер: At log on → действие: Start a program: bridge-windows-x64.exe. Постоянный режим службы (Windows Service) запланирован в фазе 23.4.

Вмешательство антивируса

Некоторые антивирусы (Windows Defender, Kaspersky, Bitdefender) помещают неподписанные бинарники в карантин. Если файл исчезает после скачивания:

  1. Открой Settings → Privacy & security → Windows Security → Virus & threat protection → Protection history
  2. Найди запись о карантине bridge-windows-x64.exe
  3. Нажми Actions → Allow on device

Корпоративные машины под MDM могут блокировать это — обратись в IT или используй личную машину для бета-теста.

Что дальше