Arc OS Docs Open in app →

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

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

Общее время: ~45 секунд — никакой возни с Gatekeeper.

Выбери архитектуру

Твоя машина Нажми эту кнопку в CRM Получишь файл
Большинство ноутбуков, десктопов, VM, x86-серверов Linux (x64) bridge-linux-x64.tar.gz (~50 МБ)
Raspberry Pi, AWS Graviton, ARM-серверы Linux (arm64) bridge-linux-arm64.tar.gz (~50 МБ)

Не уверен? Выполни uname -m в терминале. x86_64 → выбирай x64. aarch64 или arm64 → выбирай arm64.

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

1. Скачай

В CRM: Settings → Integrations → Bridge Setup → 🐧 Linux (x64) (или arm64).

Получишь bridge-linux-<arch>.tar.gz в ~/Downloads/.

2. Распакуй и запусти

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

Некоторые браузеры (Firefox, GNOME Web) автоматически распаковывают при скачивании. Если папка уже есть — пропусти строку tar.

🎞️ Заглушка GIF — media/bridge/linux-install.gif Спецификация: 15-секундная запись терминала (asciinema в GIF) — tar -xzf … → cd → bash install.sh → запросы установщика → ✓ Connected.

Установщик автоматически выполнит chmod +x для бинарника.

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

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

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

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

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

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

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

ripgrep — рекомендуется

Инструмент search_files откатывается на медленный нативный сканер, если ripgrep не установлен. Для мгновенного поиска:

# Debian / Ubuntu
sudo apt install ripgrep

# Fedora / RHEL
sudo dnf install ripgrep

# Arch
sudo pacman -S ripgrep

Что дальше