Networks: различия между версиями

Материал из Wiren Board
(Новая страница: «{{Draft}} {{DISPLAYTITLE: Настройка сетевых соединений в контроллере Wiren Board с Bullseye}} ==Введение== На этой странице описана настройка проводного Ethernet-соединения, Wi-Fi клиента и точки доступа, CAN-шины. Для понимания инструкции необходимо знать основы сетевых технологи...»)
(не показаны 22 промежуточные версии 3 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Настройка сети в контроллере Wiren Board}}
{{Draft}}
[[Image: netsettings.png |300px|thumb|right| Интерфейс настройки сети в релизе wb-2304]]
{{DISPLAYTITLE: Настройка сетевых соединений в контроллере Wiren Board с Bullseye}}
==Введение==
==Введение==
{{YouTube
На этой странице описана настройка проводного Ethernet-соединения, Wi-Fi клиента и точки доступа, CAN-шины. Для понимания инструкции необходимо знать основы сетевых технологий: TCP/IP, DNS, DHCP, netmask т.д.
|link=https://youtu.be/BVsw2OS-Eus
|text= Настройка сети в контроллерах Wiren Board
|list= PL-yKQAXd5Un_fQfrVVgMt1Em5Qb1f-v6l
}}
Инструкции на этой странице будут работать в релизах wb-2304 и новее. Для старых версий ПО используйте инструкцию [[Network-stretch  | Настройка сети в релизах wb-2207 и старее]].


Предполагаем, что вы имеете представление о строении сетей, поэтому не будем рассказывать про IP-адреса, DNS и DHCP.
Настройка 4G(LTE)-модемов описана в Инструкции по настройке 4G модема в контроллере Wiren Board. Все остальные модемы настраиваются по отдельной инструкции.


Здесь описана настройка Ethernet-соединения, Wi-Fi и CAN-шины, а инструкции по настройке модемов вы найдёте по ссылкам: [[Modem-bullseye|Настройка 4G-модема]] и [[Modem-stretch|Настройка 2G/3G/NB-IOT модемов]].
Начиная с релиза wb-2304 для управления сетевыми соединениями в контроллере Wiren Board используется программа Network Manager, а настройка сетевых соединений выполняется в веб-интерфейсе.


== Нюансы перехода на релиз wb-2304 ==
Поддержка старых инструментов для работы с сетью также сохранена. Их описание можно найти в документации.
[[Image: outdate_connections.png |300px|thumb|right| Cетевые настройки, описанные в файле /etc/network/interfaces, помечены как «Устаревшие»]]
Этот раздел только для пользователей, мигрирующих на релиз [[Wb-2304 | wb-2304]] с контроллеров, купленных до второй половины апреля 2023 года. При обновлении со старых релизов все сетевые настройки, описанные в файле <code>/etc/network/interfaces</code>, останутся без изменений. В веб-интерфейсе такие настройки будут отмечены оранжевым.


Вы можете продолжать использовать старые настройки, или передать управление сетью Network Manager. Если ваша конфигурация сети далека от типовой — не изменяйте настройки без физического доступа к контроллеру.
=== Старые и новые соединения ===
Если вы обновили ПО контроллера до версии wb-2304, то ваши существующие соединения, сконфигурированные в <code>/etc/network/interfaces</code>, будут помечены как Устаревшие, и будет предложено удалить их и использовать Network Manager. Если вы использовали нестандартные конфигурации сети, делайте это с осторожностью.  


Чтобы передать соединение под управление Network Manager:
Новые соединения, настроенные через Network Manager, не будут работать, если существуют такие же «устаревшие», настроенные в  <code>/etc/network/interfaces</code>. Чтобы переключиться на новое соединение, сделайте следующее:


#Добавьте новое соединение в веб-интерфейсе.
#Добавьте новое соединение в веб-интерфейсе.
Строка 25: Строка 19:
#Удалите в веб-интерфейсе старое соединение и подождите 1-2 минуты.  
#Удалите в веб-интерфейсе старое соединение и подождите 1-2 минуты.  


==Настройка сети==
==Настройка соединений в веб-интерфейсе==
Перейдите в раздел '''Настройки Конфигурационные файлы Сетевые соединения'''.
=== Создание и редактирование соединений ===
Менеджер сети каждые 5 секунд проверяет связь с интернетом и, если интернет недоступен — перенаправляет трафик через соединение с доступом в интернет. Все соединения, кроме модема останутся доступными для других задач.
#Перейдите в раздел '''Настройки Конфигурационные файлы Сетевые соединения'''.
#:На вкладке '''Сетевые соединения''' отображают все существующие соединения и их параметры.
#Создайте новое соединений кнопкой '''Добавить соединение''' и в появившемся окне выберите тип.
#Введите параметры соединения и нажмите кнопку '''Сохранить'''.


На вкладке '''Приоритеты соединений''' вы можете указать драйверу, в каком порядке проверять соединения на наличие интернета.
=== Настройка приоритетов ===
На вкладке '''Приоритеты соединений''' можно настроить приоритеты использования соединений, когда их больше одного.


Наличие соединения проверяется запросом к ''http://network-test.debian.org/nm''. Если в ответ не приходит страница с текстом ''NetworkManager is online'', считается что доступа в Интернет нет. При желании, вы можете задать другой URL адрес и ответ для проверки соединения.
Контроллер направляет трафик через доступное соединение, имеющее высший приоритет. Если это соединение перестает работать, контроллер переключается на следующий по приоритету и т.д. Все соединения, кроме модема, останутся активными и могут использоваться для других задач. Менеджер проверяет доступ в интернет каждые 5 секунд.
<gallery mode="packed" heights="150px">
Image: networks_settings.png | Сетевые соединения
Image: priority1.png | Приоритеты соединений
Image: eth-settings.png | Настройка проводного Etherent-соединения
Image: wifi-client.png | Настройка Wi-Fi клиента
Image: wifi-point.png | Настройка точки доступа Wi-Fi
</gallery>


==Выбор диапазона Wi-Fi 2.4 или 5 ГГц==
Наличие соединения проверяется запросом к <code>http://network-test.debian.org/nm</code>. Если в ответ не приходит страница с текстом <code>NetworkManager is online</code>, считается что доступа в Интернет нет. Также можно задать другой URL адрес и ответ для проверки соединения.
[[Image: wifi_5G.png|300px|thumb|right| Переключение диапазона в разделе '''Конфигурационные файлы → Сетевые соединения''' в веб-интерфейсе контроллера Wiren Board]]
{{note|note|Функция доступна в контроллерах с Wi-Fi чипом Realtek RTL8733BU: начиная с ревизии 7.4.3, [[WB7_hardware_revisions |выпускаемой с декабря 2023]] года. Настройка диапазона в веб-интерфейсе появилась начиная с релиза [[Wb-2401 |wb-2401]].}}


По умолчанию контроллер настроен на 2.4 ГГц. При необходимости можно переключить диапазон на 5 ГГц. Это можно сделать в разделе '''Конфигурационные файлы → Сетевые соединения'''.
===Подключение к проводной сети Ethernet===
Сетевые подключения Ethernet для портов eth0 и eth1 настроены по умолчанию. Если вы хотите создать новое, выполните следующие шаги:
#Добавьте новое соединение с типом '''Ethernet-соединение'''.
#Выберите интерфейс <code>eth0</code>, <code>eth1</code> или оставьте поле пустым, чтобы использовать соединение для обоих интерфейсов.
#При необходимости задайте статический IP и маску подсети.
#Нажмите '''Сохранить'''.


Важно учитывать, что одновременно может быть использован только один диапазон. Т.е. нельзя одновременно подключиться к точке доступа с диапазоном 2.4 ГГц и создать точку доступа в диапазоне 5 ГГц.  
===Подключение к Wi-Fi роутеру===
Контроллер можно подключить к интернету по Wi-Fi. Для этого нужно выполнить следующие действия:
#Добавьте новое соединение с типом '''Клиент Wi-Fi'''.
#Введите SSID сети, к которой собираетесь подключиться.
#Если соединение защищено паролем, в поле '''Защита''' выберите ''WPA/WPA2 Personal'' и введите пароль.
#При необходимости задайте статический IP и маску подсети.
#Нажмите '''Сохранить'''.
 
Контроллер Wiren Board может работать в режиме Wi-Fi-клиента и точки доступа одновременно. Но он не может одновременно подключиться к нескольким точкам доступа. Если это нужно, настройте нужные соединения и установите приоритеты.
 
===Установка пароля для точки доступа Wi-Fi===
Точка доступа Wi-Fi настроена в контроллере Wiren Board по умолчанию, но не защищена паролем. Его можно задать или изменить в настройках.
#Перейдите на вкладку точки доступа.
#В поле '''Защита''' выберите ''WPA/WPA2 Personal''.
#Введите пароль. Нажмите '''Сохранить'''.
#Отключите точку доступа и подключите снова кнопкой в правом верхнем углу.
 
===Подключение к CAN-шине===
#Переключите порт RS-485/CAN в режим CAN: в разделе '''Конфигурационные файлы''' перейдите на вкладку '''Модули расширения и порты'''. На вкладке '''Интерфейс RS-485/CAN'''  в поле '''Module type''' выберите режим ''CAN interface'' и нажмите кнопку '''Сохранить'''.
#Вернитесь в '''Сетевые соединения''' и нажмите '''Добавить соединение'''.
#В поле '''Имя интерфейса''' введите ''can0'' и задайте скорость обмена.
#Нажмите '''Сохранить'''.
 
CAN-интерфейс будет подниматься сам при загрузке системы и смене режима порта RS-485/2 в «CAN».


==Работа с Network Manager через консоль==
==Работа с Network Manager через консоль==
[[Image: nmcli_show.png|300px|thumb|right| Список соединений полученный утилитой nmcli]]
Настройка сетевых соединений через консоль может понадобиться если нет доступа к веб-интерфейсу контроллера. Для работы с Network Manager через консоль удобнее всего использовать предустановленную утилиту '''nmcli'''.  
[[Image: nmtui.png|300px|thumb|right| Интерфейс утилиты nmtui]]
Настройка сетевых соединений через консоль может понадобиться если нет доступа к веб-интерфейсу контроллера, а также в скриптах и своём ПО. Для работы с Network Manager через консоль удобнее всего использовать предустановленную утилиту '''nmcli'''.  


'''nmcli''' — консольная утилита позволяющая работать с Network Manager через SSH соединение. Ее аналог — утилита '''nmtui''', имеющая встроенный текстовый графический интерфейс.
'''nmcli''' — консольная утилита позволяющая работать с Network Manager через SSH соединение. Ее аналог — утилита '''nmtui''', имеющая встроенный текстовый графический интерфейс.


Далее описаны самые распространенные сценарии использования утилиты nmcli, полный набор команд можно найти в [https://developer-old.gnome.org/NetworkManager/stable/nmcli.html официальной справке].  
Далее описаны самые распространенные сценарии использования утилиты nmcli, полный набор команд можно найти в официальной справке.  


===Создание нового соединения===
===Создание нового соединения===
Рассмотрим пример создания нового соединения типа ethernet с именем wb-eth2
Рассмотрим пример создания нового соединения типа ethernet с именем wb-eth2


#Создайте новое соединение:
#Создайте новое соединение:
#:<syntaxhighlight lang="bash">
#:nmcli connection add type ethernet ifname wb-eth2
nmcli connection add type ethernet ifname wb-eth2
</syntaxhighlight>
#Выведите список существующих соединений и проверьте, что новое соединение создано, ему присвоен UUID и задан тип ethernet:
#Выведите список существующих соединений и проверьте, что новое соединение создано, ему присвоен UUID и задан тип ethernet:
#:<syntaxhighlight lang="bash">
#:nmcli connection show
nmcli connection show
</syntaxhighlight>
#Поднимите новое соединение:
#Поднимите новое соединение:
#:<syntaxhighlight lang="bash">
#:nmcli connection up ethernet-wb-eth2
nmcli connection up ethernet-wb-eth2
</syntaxhighlight>
 
Сбросить соединение можно командой <code>nmcli connection down ethernet-wb-eth2</code>.


Сбросить соединение можно командой nmcli connection down ethernet-wb-eth2.
===Редактирование параметров соединений===
===Редактирование параметров соединений===
С помощью nmcli можно редактировать параметры существующих соединений.
С помощью nmcli можно редактировать параметры существующих соединений.


Например, установить статический IPv4 адрес для созданного выше соединения можно командами:  
Например, установить статический IPv4 адрес для созданного выше соединения можно командами:  
<syntaxhighlight lang="bash">
 
nmcli connection modify ethernet-wb-eth2 ipv4.address 192.168.4.26/24
nmcli connection modify ethernet-wb-eth2 ipv4.address 192.168.4.26/24
nmcli connection modify ethernet-wb-eth2 ipv4.method manual
nmcli connection modify ethernet-wb-eth2 ipv4.method manual
</syntaxhighlight>
 
Первая устанавливает ip-адрес, а вторая переключает метод установки ip-адреса на ручной.  
Первая устанавливает ip-адрес, а вторая переключает метод установки ip-адреса на ручной.  


Обратно установить DHCP вместо manaul можно командами:  
Обратно установить DHCP вместо manaul можно командами:  
<syntaxhighlight lang="bash">
 
nmcli connection modify ethernet-wb-eth2 ipv4.method auto
nmcli connection modify ethernet-wb-eth2 ipv4.method auto
</syntaxhighlight>


===Работа с устройствами===
===Работа с устройствами===
[[Image: divices1.png |300px|thumb|right| Список устройств]]
[[Image: divices2.png |300px|thumb|right| Информация об устройстве]]
Утилита nmcli позволяет работать с устройствами, используя для этого секцию device.
Утилита nmcli позволяет работать с устройствами, используя для этого секцию device.


Проверить статусы устройств:
Проверить статусы устройств:
<syntaxhighlight lang="bash">
 
nmcli device status
nmcli device status
</syntaxhighlight>
 
Вывести информацию об устройстве:
Вывести информацию об устройстве:
<syntaxhighlight lang="bash">
 
nmcli device show dbg0
nmcli device show dbg0
</syntaxhighlight>


===Установка пароля точки доступа Wi-Fi===
===Установка пароля точки доступа Wi-Fi===
Установить или сменить пароль для точки доступа Wi-Fi с помощью nmcli можно одной командой:
Установить или сменить пароль для точки доступа Wi-Fi с помощью nmcli можно одной командой:
<syntaxhighlight lang="bash">
 
nmcli con modify wb-ap wifi-sec.key-mgmt wpa-psk wifi-sec.psk 1234567890
nmcli con modify wb-ap wifi-sec.key-mgmt wpa-psk wifi-sec.psk 1234567890
</syntaxhighlight>
 
где ''1234567890'' — новый пароль не менее 7 символов, ''wb-ap'' — имя точки доступа.
где ''1234567890'' — новый пароль не менее 7 символов, ''wb-ap'' — имя точки доступа.


После этого перезапустите соединение командами:
После этого перезапустите соединение командами:
<syntaxhighlight lang="bash">
 
nmcli connection down wb-ap
nmcli connection down wb-ap
nmcli connection up wb-ap
nmcli connection up wb-ap
</syntaxhighlight>


===Настройка приоритетов соединений===
===Настройка приоритетов соединений===
[[Image: priority.png |300px|thumb|right| Файл /etc/wb-connection-manager.conf]]
Для настройки приоритетов соединений через консоль сделайте следующее:
Для настройки приоритетов соединений через консоль сделайте следующее:
#Откройте файл <code>/etc/wb-connection-manager.conf</code> в текстовом редакторе, например, nano:
#Откройте файл <code>/etc/wb-connection-manager.conf</code> в текстовом редакторе, например, nano:
#:<syntaxhighlight lang="bash">
#:nano /etc/wb-connection-manager.conf
nano /etc/wb-connection-manager.conf
</syntaxhighlight>
#Перенесите имя соединения в нужный раздел:
#Перенесите имя соединения в нужный раздел:
#:''high'' — высокий приоритет;
#:''high'' — высокий приоритет;
Строка 130: Строка 129:
#:''low'' — низкий.
#:''low'' — низкий.
#Нажмите <kbd>Ctrl</kbd>+<kbd>S</kbd> для сохранения изменений, <kbd>Ctrl</kbd>+<kbd>X</kbd> — для выхода из редактора.
#Нажмите <kbd>Ctrl</kbd>+<kbd>S</kbd> для сохранения изменений, <kbd>Ctrl</kbd>+<kbd>X</kbd> — для выхода из редактора.
==Полезные ссылки==
Пример перенаправления портов с интерфейса к устройству на другом интерфейсе https://support.wirenboard.com/t/network-manager-i-iptables/18767/4

Версия 19:42, 11 апреля 2023

Это черновик страницы. Последняя правка сделана 11.04.2023 пользователем Matveevrj.

Введение

На этой странице описана настройка проводного Ethernet-соединения, Wi-Fi клиента и точки доступа, CAN-шины. Для понимания инструкции необходимо знать основы сетевых технологий: TCP/IP, DNS, DHCP, netmask т.д.

Настройка 4G(LTE)-модемов описана в Инструкции по настройке 4G модема в контроллере Wiren Board. Все остальные модемы настраиваются по отдельной инструкции.

Начиная с релиза wb-2304 для управления сетевыми соединениями в контроллере Wiren Board используется программа Network Manager, а настройка сетевых соединений выполняется в веб-интерфейсе.

Поддержка старых инструментов для работы с сетью также сохранена. Их описание можно найти в документации.

Старые и новые соединения

Если вы обновили ПО контроллера до версии wb-2304, то ваши существующие соединения, сконфигурированные в /etc/network/interfaces, будут помечены как Устаревшие, и будет предложено удалить их и использовать Network Manager. Если вы использовали нестандартные конфигурации сети, делайте это с осторожностью.

Новые соединения, настроенные через Network Manager, не будут работать, если существуют такие же «устаревшие», настроенные в /etc/network/interfaces. Чтобы переключиться на новое соединение, сделайте следующее:

  1. Добавьте новое соединение в веб-интерфейсе.
  2. Убедитесь, что стоит галочка «Подключаться автоматически» и сохраните его.
  3. Удалите в веб-интерфейсе старое соединение и подождите 1-2 минуты.

Настройка соединений в веб-интерфейсе

Создание и редактирование соединений

  1. Перейдите в раздел Настройки — Конфигурационные файлы — Сетевые соединения.
    На вкладке Сетевые соединения отображают все существующие соединения и их параметры.
  2. Создайте новое соединений кнопкой Добавить соединение и в появившемся окне выберите тип.
  3. Введите параметры соединения и нажмите кнопку Сохранить.

Настройка приоритетов

На вкладке Приоритеты соединений можно настроить приоритеты использования соединений, когда их больше одного.

Контроллер направляет трафик через доступное соединение, имеющее высший приоритет. Если это соединение перестает работать, контроллер переключается на следующий по приоритету и т.д. Все соединения, кроме модема, останутся активными и могут использоваться для других задач. Менеджер проверяет доступ в интернет каждые 5 секунд.

Наличие соединения проверяется запросом к http://network-test.debian.org/nm. Если в ответ не приходит страница с текстом NetworkManager is online, считается что доступа в Интернет нет. Также можно задать другой URL адрес и ответ для проверки соединения.

Подключение к проводной сети Ethernet

Сетевые подключения Ethernet для портов eth0 и eth1 настроены по умолчанию. Если вы хотите создать новое, выполните следующие шаги:

  1. Добавьте новое соединение с типом Ethernet-соединение.
  2. Выберите интерфейс eth0, eth1 или оставьте поле пустым, чтобы использовать соединение для обоих интерфейсов.
  3. При необходимости задайте статический IP и маску подсети.
  4. Нажмите Сохранить.

Подключение к Wi-Fi роутеру

Контроллер можно подключить к интернету по Wi-Fi. Для этого нужно выполнить следующие действия:

  1. Добавьте новое соединение с типом Клиент Wi-Fi.
  2. Введите SSID сети, к которой собираетесь подключиться.
  3. Если соединение защищено паролем, в поле Защита выберите WPA/WPA2 Personal и введите пароль.
  4. При необходимости задайте статический IP и маску подсети.
  5. Нажмите Сохранить.

Контроллер Wiren Board может работать в режиме Wi-Fi-клиента и точки доступа одновременно. Но он не может одновременно подключиться к нескольким точкам доступа. Если это нужно, настройте нужные соединения и установите приоритеты.

Установка пароля для точки доступа Wi-Fi

Точка доступа Wi-Fi настроена в контроллере Wiren Board по умолчанию, но не защищена паролем. Его можно задать или изменить в настройках.

  1. Перейдите на вкладку точки доступа.
  2. В поле Защита выберите WPA/WPA2 Personal.
  3. Введите пароль. Нажмите Сохранить.
  4. Отключите точку доступа и подключите снова кнопкой в правом верхнем углу.

Подключение к CAN-шине

  1. Переключите порт RS-485/CAN в режим CAN: в разделе Конфигурационные файлы перейдите на вкладку Модули расширения и порты. На вкладке Интерфейс RS-485/CAN в поле Module type выберите режим CAN interface и нажмите кнопку Сохранить.
  2. Вернитесь в Сетевые соединения и нажмите Добавить соединение.
  3. В поле Имя интерфейса введите can0 и задайте скорость обмена.
  4. Нажмите Сохранить.

CAN-интерфейс будет подниматься сам при загрузке системы и смене режима порта RS-485/2 в «CAN».

Работа с Network Manager через консоль

Настройка сетевых соединений через консоль может понадобиться если нет доступа к веб-интерфейсу контроллера. Для работы с Network Manager через консоль удобнее всего использовать предустановленную утилиту nmcli.

nmcli — консольная утилита позволяющая работать с Network Manager через SSH соединение. Ее аналог — утилита nmtui, имеющая встроенный текстовый графический интерфейс.

Далее описаны самые распространенные сценарии использования утилиты nmcli, полный набор команд можно найти в официальной справке.

Создание нового соединения

Рассмотрим пример создания нового соединения типа ethernet с именем wb-eth2

  1. Создайте новое соединение:
    nmcli connection add type ethernet ifname wb-eth2
  2. Выведите список существующих соединений и проверьте, что новое соединение создано, ему присвоен UUID и задан тип ethernet:
    nmcli connection show
  3. Поднимите новое соединение:
    nmcli connection up ethernet-wb-eth2

Сбросить соединение можно командой nmcli connection down ethernet-wb-eth2.

Редактирование параметров соединений

С помощью nmcli можно редактировать параметры существующих соединений.

Например, установить статический IPv4 адрес для созданного выше соединения можно командами:

nmcli connection modify ethernet-wb-eth2 ipv4.address 192.168.4.26/24 nmcli connection modify ethernet-wb-eth2 ipv4.method manual

Первая устанавливает ip-адрес, а вторая переключает метод установки ip-адреса на ручной.

Обратно установить DHCP вместо manaul можно командами:

nmcli connection modify ethernet-wb-eth2 ipv4.method auto

Работа с устройствами

Утилита nmcli позволяет работать с устройствами, используя для этого секцию device.

Проверить статусы устройств:

nmcli device status

Вывести информацию об устройстве:

nmcli device show dbg0

Установка пароля точки доступа Wi-Fi

Установить или сменить пароль для точки доступа Wi-Fi с помощью nmcli можно одной командой:

nmcli con modify wb-ap wifi-sec.key-mgmt wpa-psk wifi-sec.psk 1234567890

где 1234567890 — новый пароль не менее 7 символов, wb-ap — имя точки доступа.

После этого перезапустите соединение командами:

nmcli connection down wb-ap nmcli connection up wb-ap

Настройка приоритетов соединений

Для настройки приоритетов соединений через консоль сделайте следующее:

  1. Откройте файл /etc/wb-connection-manager.conf в текстовом редакторе, например, nano:
    nano /etc/wb-connection-manager.conf
  2. Перенесите имя соединения в нужный раздел:
    high — высокий приоритет;
    medium — средний;
    low — низкий.
  3. Нажмите Ctrl+S для сохранения изменений, Ctrl+X — для выхода из редактора.