С чего начать

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

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

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

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

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

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

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

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

02 · Деньги

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

Баланс устройства пополняется с TON-кошелька владельца, а списывает с него оплату за обслуживание само устройство — списать лишнее некому.

Смена ноды — независимого сервера, который держит связь с устройством, — на этом никак не сказывается: оплаченный период к ноде не привязан, и если она пропала, устройство дообслуживается у другой. На практике понадобится только 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 их не хранит и восстановить не может. Потеря seed-фразы означает потерю доступа к консоли и балансу без возможности его вернуть, поэтому хранить фразу стоит отдельно от устройства и не показывать никому.

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

Сообщество

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

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

Открыть @subrose