С чего начать

Установка агента и привязка устройства.

Подойдёт роутер с OpenWrt или Keenetic, Raspberry Pi, Linux- или macOS-машина с доступом по SSH. Дальше всё делается из веб-консоли Subrose в браузере: команды, события, настройки.

01 · Перед стартом

Что понадобится.

Роутер на OpenWrt или Keenetic, Raspberry Pi, Linux- или macOS-машина.

Доступ к устройству по SSH с правами администратора.

Выход устройства в интернет.

TON-кошелёк с секретными словами (seed-фразой): по ним идёт вход в консоль и оплата обслуживания.

02 · Деньги

Оплата обслуживания.

Баланс пополняется с TON-кошелька владельца. Оплата идёт напрямую, за период вперёд, без карт и посредников, поэтому списать лишнее некому. Автоматическое списание с самого устройства на подходе.

Смена ноды на оплату не влияет. Нода — это независимый сервер, который держит связь с устройством. Оплаченный период к ней не привязан, и если она пропала, устройство дообслуживается у другой.

03 · Установка

Установка агента.

ssh root@192.168.1.1
opkg update
opkg install curl
curl -fsSL https://subrose.co/dl/install.sh | sh

Это путь для роутеров. Установщик сам определит, Keenetic перед ним или OpenWrt, скачает свежий пакет под нужную архитектуру и сверит контрольную сумму. Адрес 192.168.1.1 типовой для роутеров. Если у роутера другой адрес, в команде указывается он.

Linux, macOS и Raspberry Pi ставятся пакетами со страницы «Пакеты»: через apt, brew или готовым файлом. Там же описан ручной путь для роутеров. Дальше везде одинаково: сервис стартует сам, а связь с устройством держит нода.

04 · Привязка

Привязка устройства по коду.

Досмотреть установку до конца, не закрывая терминал

Агент покажет в нём 5-значный код привязки.

Открыть веб-консоль Subrose в браузере

Войти через TON-кошелёк

По секретным словам.

Добавить устройство

Ввести код из терминала, дать имя и подтвердить привязку.

Если код не показался или терминал закрылся, привязку можно запустить заново:

cd /opt/subrose
./subrose setup --env subrose

05 · После установки

Что появится на устройстве.

OpenWrt/opt/subrose/subrose, /etc/init.d/subrose, /var/log/subrose.log

Keenetic/opt/subrose/subrose, /opt/etc/init.d/S50subrose, /opt/var/log/subrose.log

Локальная конфигурация/root/.config/subrose/: ключи устройства и его настройки.

Готово: устройство записано в TON и выполняет только команды с подписью владельца. Первая команда из консоли сразу появится в истории устройства.

06 · Вопросы

Что спрашивают на старте.

Код привязки не показался. Что делать?Если терминал закрылся раньше, чем появился код, привязку можно запустить заново: cd /opt/subrose, затем ./subrose setup --env subrose. Агент покажет новый 5-значный код.

Устройство не появилось в консоли. Что делать?Обычно причина в прерванной привязке или в том, что у устройства нет интернета. Стоит проверить, что устройство в сети, заглянуть в лог агента (/var/log/subrose.log на OpenWrt, /opt/var/log/subrose.log на Keenetic) и повторить привязку кодом.

Как понять, что всё работает?После первой команды из веб-консоли Subrose в истории устройства появляется событие о её выполнении. Значит, агент, нода и подпись владельца сработали вместе.

Что будет с доступом, если потерять секретные слова от кошелька?Секретные слова — единственный ключ к кошельку и через него к устройству. Subrose их не хранит и восстановить не может. Если слова потеряны, доступ к консоли и балансу вернуть нельзя, поэтому хранить их стоит отдельно от устройства и никому не показывать.

Можно ли поставить агента на несколько устройств?Да. Агент ставится на каждое устройство отдельно, у каждого свой код привязки и своя запись в TON. В веб-консоли Subrose все они собираются под одним владельцем.

Сообщество

Помощь с первым устройством.

В Telegram проекта отвечают на вопросы по установке и совместимым моделям.

Открыть @subrose