Архитектура GrigDesk
Приложение — там, где вы работаете. Сервер — там, где выполняются задачи. Ретранслятор помогает связать устройства, когда прямое подключение недоступно.
Как они связаны
Выберите свой вариант: всё на одном компьютере, прямое подключение к удалённому серверу или доступ к домашнему ПК с телефона.
Всё на одном компьютере
Приложение и сервер работают рядом на вашем Linux-компьютере.
Напрямую к удалённому серверу
У сервера есть доступный из интернета адрес и включён вход для приложений.
Домашний проект — с собой
Ретранслятор на VPS связывает телефон с домашним ПК, недоступным из интернета.
Домашний сервер сам устанавливает связь с ретранслятором. За домашним ПК приложение работает с этим же сервером напрямую.
Во всех вариантах вы отправляете команды из приложения, а сервер выполняет работу и возвращает результат. Место хранения проектов и запуска агентов определяется тем, где установлен сервер.
Три компонента
Сервер — выполняет работу
Сервер управляет чатами и конвейерами, запускает ИИ-исполнителей, хранит историю и результаты. Он работает на Linux-машине, где находятся ваши репозитории, инструменты и окружение проекта. Это может быть домашний ПК или удалённый сервер.
Серверу не требуется открытое окно приложения: его можно запустить как фоновую службу. Пока машина включена и сервер работает, задачи могут выполняться без открытого интерфейса.
Приложение — управляет работой
Через приложение вы ставите задачи, общаетесь с агентами и принимаете решения. На компьютере это отдельное окно GrigDesk, на телефоне или планшете — Android-приложение. Код и инструменты проекта остаются на машине сервера.
Приложение можно установить и открыть отдельно от сервера. Для подключения к удалённой машине локальный сервер на вашем компьютере не требуется. На экране «Машины» можно добавить сервер и выбрать, с каким из подключений работать.
Для работы на этом же компьютере приложение использует уже запущенный локальный сервер или запускает свой. Десктоп также подключается напрямую к удалённому серверу, если тот доступен по сети. Ретранслятор для такого подключения не нужен.
Ретранслятор — обеспечивает удалённую связь
Когда домашний ПК скрыт за роутером и недоступен извне (например, из-за NAT), ретранслятор помогает подключить к нему мобильное приложение. Его размещают на отдельном VPS с доступным из интернета адресом. В технических руководствах он также называется «посредник» или relay.
Ретранслятор передаёт зашифрованный трафик между устройством и сервером GrigDesk. Он не запускает агентов и не получает содержимое чатов в открытом виде. Репозитории и инструменты проекта переносить на него не требуется.
Это три отдельно запускаемых компонента. Для выполнения задач нужен работающий сервер, а необходимость ретранслятора зависит от способа подключения.
Варианты запуска
Всё на одном компьютере
Установите GrigDesk на Linux-компьютер и откройте приложение. Если сервер ещё не запущен, приложение поднимет свой и остановит его при закрытии окна. Это удобный вариант, когда вы работаете только за этим компьютером.
Прямое подключение к удалённому серверу
Если у удалённого сервера есть доступный из интернета адрес, он не скрыт за NAT и принимает подключения приложений, десктоп обращается к нему напрямую, без ретранслятора. Так можно работать, например, с собственным VPS.
- Установите сервер GrigDesk, репозитории, CLI-исполнителей и зависимости проекта на удалённую Linux-машину.
- Включите на сервере вход для приложений и разрешите подключение к нему по выбранному адресу и порту.
- Получите строку или QR-код привязки в разделе «Доступ → Устройства» либо через CLI.
- Добавьте машину в десктоп-приложении по этой строке или QR-коду и подключитесь к ней.
Приложение остаётся на вашем компьютере, а агенты работают с проектом на удалённом сервере. Устанавливать сервер GrigDesk локально для этого не нужно. Привязка и доступ описаны в руководстве подключения устройств.
Чтобы сервер работал без открытого окна
Запустите сервер как службу, если задачи должны продолжаться после закрытия окна или нужен доступ с мобильного устройства. Службу запускают до открытия приложения; тогда окно использует уже работающий сервер и не выключает его при закрытии.
Удалённый сервер тоже работает независимо от десктопа: закрытие приложения на вашем компьютере не останавливает сервер на другой машине.
Домашний ПК и ретранслятор на VPS
Если основная работа идёт дома, а следить за ней хочется и с телефона или планшета:
- Запустите сервер GrigDesk на домашнем Linux-компьютере как службу.
- Установите ретранслятор на удалённый VPS.
- В настройках GrigDesk, в разделе «Приложение на телефоне», добавьте адрес ретранслятора и получите настройки для его запуска.
- Подключите Android-приложение по QR-коду из настроек GrigDesk.
Теперь за компьютером вы работаете в обычном окне GrigDesk, а с телефона или планшета — через ретранслятор. Домашний ПК должен оставаться включённым, с работающим сервером и соединением с ретранслятором. VPS обеспечивает связь, а выполнение задач остаётся дома.
Схема с ретранслятором описана в руководстве мобильного подключения. Полное Android-приложение также поддерживает прямое подключение к доступной машине — подробнее в описании единого приложения.
Что дальше
- Установка GrigDesk — сервер и приложение на одной Linux-машине.
- Подключение устройств — прямой доступ к серверу.
- Развёртывание ретранслятора — подключение мобильных устройств.
- Первый проект — путь от установки до своей задачи.