Vacuula: свой сервер и установщик для оживления пылесосов Neato

Vacuula: свой сервер и установщик для оживления пылесосов Neato

Vacuula, проект на GitHub (vacuula/vacuula), который описывает себя как комплексное решение, чтобы починить и контролировать «сломанный» робот-пылесос Neato. Имена авторов в README не названы.

Поддержка по поколениям выглядит так. Gen1, без Wi-Fi, поэтому не охвачено. Gen2 (BotVac Connected) пока не поддерживается: пункт стоит в списке задач, а в примечании сказано, что оригинальный BotVac Connected не удалось включить в первый выпуск, поддержка «в работе и появится совсем скоро». Gen3 (D3, D4, D5, D6, D7) и Gen4 (D800, D8, D9, D10) отмечены как поддерживаемые. Если вашей модели в списке нет, авторы просят связаться с ними. Владельцам Gen4 в «радужном режиме» (мигают разные цвета, робот не запускается) предлагают обратиться в Discord проекта: там помогут с ремонтом.

Ремонт состоит из двух частей: поднять сервер и настроить сам робот. Сервер должен работать постоянно, поэтому нужно выделенное оборудование; если его нет, советуют прочитать раздел про железо в FAQ. Общественный сервер авторы изучают, но к первому выпуску он не будет готов, так что сервер придётся ставить самостоятельно.

Способов установки сервера несколько: Docker Compose, приложение для Home Assistant и вариант LXC/standalone. Для пользователей Home Assistant рекомендуют репозиторий приложений, который сделали авторы, для остальных, Docker Compose. Для Docker Compose нужно установить Docker (авторы называют это самым сложным этапом для тех, кто не знаком с самостоятельным размещением, и начали писать руководство в FAQ), скачать docker-compose.yaml из последнего релиза (например, через wget), запустить docker compose up -d. Сервер настраивается переменными окружения. Логи смотрят командой docker compose logs vacuula, остановка, docker compose down, запуск, docker compose up -d. Чтобы навсегда удалить сохранённые данные, нужно выполнить docker volume rm vacuula-data, предварительно остановив Vacuula.

Для настройки робота есть простой установщик: его скачивают под свою операционную систему по ссылке, в таблице отмечены проверенные системы. На Linux перед использованием нужно добавить пользователя в группу dialout командой sudo usermod -aG dialout $USER и перезагрузить компьютер. Исходный код установщика лежит в отдельном репозитории github.com/vacuula/installer. Тем, у кого нестандартная конфигурация и установщик не запускается, предлагают связаться с авторами.

Технические ограничения. Роботам Gen3 нужен порт 443; если эта опция включена, на нём же размещаются сервер Vacuula и веб-приложение (чтобы работали PWA). Сервер проверен только на ARM 64-бит и x86 64-бит. Авторы хотят поддержать как минимум ARM 32-бит и, возможно, x86 32-бит, главным образом чтобы сервер работал на старых одноплатных компьютерах, но пока лишь изучают такую возможность.

Ключевые факты

  • Vacuula, проект на GitHub: сервер для самостоятельного размещения плюс установщик для настройки робота-пылесоса Neato.
  • Поддерживаются Gen3 (D3, D7) и Gen4 (D800, D8, D9, D10); Gen2 BotVac Connected пока нет, Gen1 без Wi-Fi не охвачен.
  • Сервер должен работать постоянно на выделенном оборудовании; варианты установки: Docker Compose, приложение для Home Assistant, LXC/standalone.
  • Gen3 требует порт 443; сервер проверен только на ARM 64-бит и x86 64-бит, поддержку 32-бит авторы лишь изучают.
  • Общественного сервера к первому выпуску не будет, каждому придётся поднимать свой.

Почему это важно

Для владельцев Neato проект, способ вернуть к жизни «сломанные» роботы-пылесосы, поставив собственный сервер. Почему именно роботы перестали работать, README не объясняет, поэтому масштаб проблемы по нему оценить нельзя. Это нишевый любительский инструмент без отношения к ИИ, но показательный пример того, как сообщество само берёт на себя поддержку устройств.

Кому это важно

Владельцам роботов Neato поколений Gen3 (D3, D7) и Gen4 (D800, D8, D9, D10), особенно тем, у кого Gen4 застрял в «радужном режиме». Также тем, кто уже ведёт домашний сервер или пользуется Home Assistant. Владельцам Gen1 (без Wi-Fi) проект не поможет, а владельцам Gen2 BotVac Connected придётся ждать обещанной поддержки.

Как это применить

Нужно выделенное устройство, которое работает без перерыва; сервер проверен на ARM 64-бит и x86 64-бит. Дальше два шага: поднять сервер и настроить робота установщиком. Пользователям Home Assistant рекомендуют приложение из репозитория проекта, остальным, Docker Compose (скачать docker-compose.yaml и выполнить docker compose up -d). Установщик скачивают под свою систему; на Linux сначала добавляют пользователя в группу dialout и перезагружаются. Для Gen3 учтите, что требуется порт 443. Если модели нет в списке или установщик не запускается, авторы просят написать им. Цены и лицензия в README не указаны.

Можно ли доверять

Это README самого проекта, то есть его собственное описание. Авторы, ответственная организация, лицензия, номер версии и дата релиза в тексте не названы; данных о результатах тестов и числе пользователей тоже нет. Отметки о поддержке моделей, заявления авторов, независимо в материале они не подтверждены. Исходный код установщика открыт в отдельном репозитории.

Риски и подводные камни

Сервер должен работать постоянно, поэтому нужно отдельное оборудование и самостоятельная эксплуатация. Общественного сервера к первому выпуску не будет. Установка Docker названа самой сложной частью для новичков. Gen3 занимает порт 443, а при включённой опции на нём же размещаются сервер и веб-приложение. Проверены только ARM 64-бит и x86 64-бит; 32-битные платформы пока под вопросом. Поддержка Gen2 обещана как «очень скоро» без конкретных сроков. Удаление данных командой docker volume rm необратимо, а Vacuula перед этим нужно остановить.