Wiren Board Cloud: различия между версиями

Материал из Wiren Board
(не показано 56 промежуточных версий 2 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Wiren Board Cloud — удалённое администрирование}}
{{DISPLAYTITLE:Удалённый доступ к контроллеру Wiren Board}}
== Описание ==
== Введение ==
{{YouTube
Wiren Board Cloud — сервис удалённого администрирования контроллеров Wiren Board, который позволяет отслеживать текущий статус контроллера, а также получать доступ к SSH и веб-интерфейсу. По умолчанию сервис выключен.
|link=https://youtu.be/rWrG4mDfgec
|text=Демонстрация}}
[https://wirenboard.cloud Wiren Board Cloud] — сервис удаленного администрирования систем автоматизации на контроллерах Wiren Board. '''[https://wirenboard.com/ru/pages/cloud/ Подробное описание возможностей]'''


Работает в контроллерах Wiren Board 6 и новее.
Cервис находится в стадии открытого бета-тестирования. Его можно использовать для продакшена, но могут встречаться незначительные ошибки и временная потеря связи с облаком. Информацию об ошибках и пожелания присылайте в [https://t.me/+mF77lEE0kB01NGY6 Чат пользователей Wiren Board Cloud].


Информацию об ошибках и пожелания присылайте на [https://support.wirenboard.com/ портал техподдержки]. Если вы сообщаете о проблемах — приложите к сообщению [[Wiren_Board_Web_Interface#diagnostic |диагностический архив]].
<gallery mode="packed" heights="120px" caption="Интерфейс облака и демонстрация возможностей">
Image: wb-cloud-controllers.png | Список контроллеров
Image: wb-cloud-controller-page.png | Страница контроллера
Image: wb-cloud-controller-ssh.png | Доступ к SSH через браузер
Image: wb-cloud-controller-webui.png | Доступ к веб-интерфейсу
</gallery>


== Принцип работы ==
== Принцип работы ==
На контроллер Wiren Board устанавливается агент ''wb-cloud-agent'', который соединяется с облаком и получает из него настройки для создания тоннелей и отправки метрик. Для отправки метрик используется сервис ''wb-cloud-agent-telegraf'', а для тоннелей ''wb-cloud-agent-frpc''.  
На контроллере устанавливается агент ''wb-cloud-agent'', который соединяется с облаком и получает оттуда настройки для создания тоннелей и отправки метрик. Для отправки метрик используется сервис ''wb-cloud-agent-telegraf'', а для тоннелей ''wb-cloud-agent-frp''.  


Данные передаются по защищённому каналу. Авторизация контроллера в облаке происходит по ключу, хранящемся в чипе [[CryptodevATECCx08_Auth|ATECCx08]].
Данные передаются по защищённому каналу. Авторизация контроллера в облаке происходит по сертификату, хранящемся в чипе [[CryptodevATECCx08_Auth|ATECCx08]].


=== Порты ===
== Подключение контроллера ==
Для работы Wiren Board Cloud не нужно пробрасывать порты, так как все соединения с контроллера исходящие:
# агент стучится по адресу https://agent.wirenboard.cloud ;
# для тоннелей на стороне облака открываются порты из диапазона 10000 - 30000 и frpc на контроллере подключается по ним.
 
Это позволяет держать контроллер за NAT, что повышает безопасность.
 
== Подключение контроллера к облаку ==
=== Установка агента ===
=== Установка агента ===
Агент доступен на контроллерах Wiren Board 6 и новее с релизами ПО testing, wb-2207, wb-2310 и новее. [[Wiren_Board_Software#releases|Как узнать релиз ПО на контроллере]].
Процедура установки зависит от релиза ПО, которое установлено на контроллере.


Установка:
testing-релиз:
# Обновите список пакетов:
# Обновите список пакетов:
#:<syntaxhighlight lang="bash">
#:<syntaxhighlight lang="bash">
apt update
apt update
</syntaxhighlight>
</syntaxhighlight>
# Установите агент:
# Установите агент
#:<syntaxhighlight lang="bash">
#:<syntaxhighlight lang="bash">
apt install wb-cloud-agent
apt install wb-cloud-agent
</syntaxhighlight>
</syntaxhighlight>


В дальнейшем агент будет обновляться вместе с операционной системой командами:
stable-релиз:
:<syntaxhighlight lang="bash">
#<syntaxhighlight lang="bash">
apt update ; apt upgrade
echo "deb http://deb.wirenboard.com/all experimental.wb-cloud-agent main" > /etc/apt/sources.list.d/wb-cloud.list ; apt update
</syntaxhighlight>
#<syntaxhighlight lang="bash">
apt install wb-cloud-agent
</syntaxhighlight>
</syntaxhighlight>


Важно! После обновления контроллера fit-файлом надо заново поставить агента. В будущем это будет исправлено.
=== Добавление контроллера в облако ===


=== Добавление контроллера в облако ===
[[Image: wb-cloud-add-controller-1.png |thumb|300px|Ссылка на добавление в веб-интерфейсе контроллера]]
По умолчанию контроллер отключен от облака, надо его добавить:
По умолчанию контроллер отключен от облака, надо его добавить:
# Откройте веб-интерфейс контроллера, перейдите '''Настройки''' → '''Система''' и кликните на появившейся ссылке в разделе '''Подключение к облаку'''.
# Откройте веб-интерфейс контроллера, перейдите '''Настройки''' → '''Система''' и кликните на появившейся ссылке в разделе '''Подключение к облаку'''.
# После перехода по ссылке вы попадёте в личный кабинет, либо система попросит авторизоваться или создать аккаунт.
# После перехода по ссылке вы попадёте в личный кабинет, либо система попросит авторизоваться или создать аккаунт.


Также ссылку на добавление можно получить в консоли, для этого подключитесь к контроллеру по [[SSH]] и введите команду <code>wb-cloud-agent</code>:
<gallery mode="packed" heights="150px">
Image: wb-cloud-add-controller-1.png | Ссылка на добавление в веб-интерфейсе контроллера
Image: wb-cloud-add-controller-2.png | Запрос на добавление, если пользователь авторизован
Image: wb-cloud-add-controller-3.png | Заполнение дополнительной информации
</gallery>


<syntaxhighlight lang="console">
=== Удаление контроллера из облака ===
# wb-cloud-agent
Если вы не хотите использовать облако:
👉 https://wirenboard.cloud/controllers?add=69bdf824559896554d15abeaba3e62ad30c5a8f65er82f52be0bf87f084b1
# Перейдите в личный кабинет и откройте страницу контроллера.
</syntaxhighlight>
# Внизу страницы нажмите кнопку '''Удалить контроллер'''.


Важно! Если в контроллере удалить данные через factory reset, а потом снова поставить агент — контроллер подключится к облаку автоматически.
<gallery mode="packed" heights="150px">
Image: wb-cloud-controller-page.png | Кнопка ''Удалить контроллер'' внизу
Image: wb-cloud-delete-controller-1.png | Подтверждение удаления контроллера
</gallery>


== Отключение контроллера от облака ==
=== Отключение агента на контроллере ===
 
Если вы никогда не планируете подключать контроллер к облаку, можно отключить агента:
Инструкция:
# Перейдите в личный кабинет, откройте страницу контроллера и удалите контроллер.
# Подключитесь к контроллеру по [[SSH]].
# Подключитесь к контроллеру по [[SSH]].
# Введите команду:
# Введите команды:
#:<syntaxhighlight lang="bash">
#:<syntaxhighlight lang="bash">
apt purge wb-cloud-agent
systemctl stop wb-cloud-agent ; systemctl disable wb-cloud-agent
</syntaxhighlight>
</syntaxhighlight>


Если вы раньше использовали stable-релиз и добавляли при установке экспериментальный репозиторий — удалите его:
Чтобы повторно активировать агента:
:<syntaxhighlight lang="bash">
# Подключитесь к контроллеру по [[SSH]].
rm /etc/apt/sources.list.d/wb-cloud.list ; apt update
# Введите команды:
#:<syntaxhighlight lang="bash">
systemctl enable wb-cloud-agent ; systemctl start wb-cloud-agent
</syntaxhighlight>
</syntaxhighlight>

Версия 13:54, 6 декабря 2023

Введение

Wiren Board Cloud — сервис удалённого администрирования контроллеров Wiren Board, который позволяет отслеживать текущий статус контроллера, а также получать доступ к SSH и веб-интерфейсу. По умолчанию сервис выключен.

Cервис находится в стадии открытого бета-тестирования. Его можно использовать для продакшена, но могут встречаться незначительные ошибки и временная потеря связи с облаком. Информацию об ошибках и пожелания присылайте в Чат пользователей Wiren Board Cloud.

  • Интерфейс облака и демонстрация возможностей

  • Список контроллеров

  • Страница контроллера

  • Доступ к SSH через браузер

  • Доступ к веб-интерфейсу

Принцип работы

На контроллере устанавливается агент wb-cloud-agent, который соединяется с облаком и получает оттуда настройки для создания тоннелей и отправки метрик. Для отправки метрик используется сервис wb-cloud-agent-telegraf, а для тоннелей wb-cloud-agent-frp.

Данные передаются по защищённому каналу. Авторизация контроллера в облаке происходит по сертификату, хранящемся в чипе ATECCx08.

Подключение контроллера

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

Процедура установки зависит от релиза ПО, которое установлено на контроллере.

testing-релиз:

  1. Обновите список пакетов: 
    apt update
  2. Установите агент 
    apt install wb-cloud-agent

stable-релиз: 

  1. echo "deb http://deb.wirenboard.com/all experimental.wb-cloud-agent main" > /etc/apt/sources.list.d/wb-cloud.list ; apt update

  2. apt install wb-cloud-agent

Добавление контроллера в облако

По умолчанию контроллер отключен от облака, надо его добавить:

  1. Откройте веб-интерфейс контроллера, перейдите Настройки → Система и кликните на появившейся ссылке в разделе Подключение к облаку.
  2. После перехода по ссылке вы попадёте в личный кабинет, либо система попросит авторизоваться или создать аккаунт.

  • Ссылка на добавление в веб-интерфейсе контроллера

  • Запрос на добавление, если пользователь авторизован

  • Заполнение дополнительной информации

Удаление контроллера из облака

Если вы не хотите использовать облако:

  1. Перейдите в личный кабинет и откройте страницу контроллера.
  2. Внизу страницы нажмите кнопку Удалить контроллер.

  • Кнопка Удалить контроллер внизу

  • Подтверждение удаления контроллера

Отключение агента на контроллере

Если вы никогда не планируете подключать контроллер к облаку, можно отключить агента:

  1. Подключитесь к контроллеру по SSH.
  2. Введите команды: 
    systemctl stop wb-cloud-agent ; systemctl disable wb-cloud-agent

Чтобы повторно активировать агента:

  1. Подключитесь к контроллеру по SSH.
  2. Введите команды: 
    systemctl enable wb-cloud-agent ; systemctl start wb-cloud-agent
Источник — https://wirenboard.com/wiki/index.php?title=Wiren_Board_Cloud&oldid=77550