Raspberry Pi: настройка Wi-Fi на всех моделях в консоли и GUI

Приветствую! В этой статье мы посмотрим, как можно произвести настройку Wi-Fi в Raspberry Pi через консоль и не только. Аккуратно, точно, без воды от нашего вайфайного портала. Поехали!

Нашли ошибку? Есть дополнение? Обязательно напишите об этом в комментариях к этой статье. Помогите другим читателям решить их проблему!

Предупреждение

Встроенного Wi-Fi нет не у всех Raspberry Pi, но он есть далеко не только у Raspberry Pi 3. На сегодня встроенный беспроводной модуль встречается у Zero W, Zero 2 W, Raspberry Pi 3, Raspberry Pi 4, Raspberry Pi 400 и Raspberry Pi 5. У старых моделей без Wi-Fi действительно нужен отдельный USB-адаптер, но тут важно слово «совместимый» – не каждый дешевый донгл заводится на свежей Raspberry Pi OS без ручной установки драйверов.

Ниже я рассмотрю подключение Wi-Fi как для плат со встроенным модулем, так и для моделей с внешним USB-адаптером. Сразу поправлю важный момент: на текущий день в Raspberry Pi OS многое изменилось. Старые инструкции с правкой файла /etc/network/interfaces и ручным запуском dhclient уже нельзя считать основным способом настройки. На свежих выпусках Raspberry Pi OS главную роль обычно играет NetworkManager, а для первичной настройки удобно использовать Raspberry Pi Imager, raspi-config или nmcli. Поэтому ниже я покажу и современный путь, и старый вариант – но старый только как запасной для Legacy-образов.

Подготовка до первого запуска

Если система у вас еще не установлена, проще всего настроить Wi-Fi еще до первого включения Raspberry Pi. Для этого в Raspberry Pi Imager после выбора образа откройте настройки кастомизации, задайте имя пользователя, пароль, включите SSH и сразу введите имя Wi-Fi сети, пароль и страну. Это особенно удобно для Raspberry Pi OS Lite, когда у вас нет подключенного монитора и вся первая настройка идет «вслепую» через сеть.

Такой способ хорош тем, что после первой загрузки плата уже сама попытается выйти в интернет и вы сможете зайти на нее по SSH. Для домашних сценариев это реально экономит время: не нужно сначала подключать монитор, клавиатуру, потом искать мышку, а уже потом разбираться с Wi-Fi. Если вы делаете мини-сервер, ретро-консоль, контроллер умного дома или просто хотите убрать «Малину» подальше в шкаф, этот путь почти всегда удобнее ручной настройки после загрузки.

Если вы настраиваете Raspberry Pi без монитора, не забудьте одновременно включить SSH. Иначе Wi-Fi вы, возможно, зададите правильно, но зайти на устройство по сети не сможете. На первый взгляд мелочь, а на практике именно она чаще всего заставляет заново доставать карту памяти и перепрошивать образ.

Проверка подключения

Прежде чем использовать Wi-Fi, предлагаю посмотреть, а видит ли его устройство вообще. Это особенно актуально для подключаемых «свистков», но и на платах со встроенным модулем проверка тоже полезна – вдруг интерфейс отключен, заблокирован по стране или просто не поднялся после загрузки.

Если у вас внешний USB-адаптер, начните с команды:

lsusb

Она покажет список USB-устройств. Для внешнего донгла это нормально и полезно. Но тут есть важное уточнение: встроенный Wi-Fi на Raspberry Pi 3, 4, 5, Zero W и других моделях не обязан отображаться в lsusb, потому что он не USB-устройство. Поэтому для встроенного модуля правильнее проверять уже сам сетевой интерфейс.

Для этого удобнее использовать современные команды:

ip link show

или

iw dev

Обычно беспроводной интерфейс называется wlan0. На некоторых нестандартных системах имя может отличаться, но на Raspberry Pi OS это все еще самый частый вариант. Если хотите сразу увидеть IP-адреса, используйте:

ip a

Старую команду ifconfig -a тоже можно встретить в старых гайдах, но на свежей Raspberry Pi OS пакет net-tools часто не установлен по умолчанию. Поэтому сегодня логичнее привыкать именно к ip a. Для обычного пользователя смысл очень простой: если интерфейс есть, он появится в списке; если интерфейса нет вообще, проблема либо в железе, либо в драйвере, либо в блокировке устройства.

Если интерфейс есть, но не работает, выполните еще одну полезную команду: rfkill list. Она покажет, не заблокирован ли Wi-Fi программно или аппаратно. Такое бывает после неудачных настроек, работы с GPIO, старых скриптов автозапуска и некоторых сборок под серверные задачи. Если видите блокировку, сначала снимайте ее, а уже потом копайте дальше.

Настройка интерфейса

Если с модулем все в порядке и он отображается среди подключенных, значит самое время посмотреть на способ настройки. И вот здесь старая статья требует самой серьезной правки. На текущий день для свежей Raspberry Pi OS не нужно начинать с ручного редактирования файла:

/etc/network/interfaces

Раньше такой подход был обычным делом, но в современных выпусках Raspberry Pi OS основным инструментом для сетевых подключений стал NetworkManager. Поэтому старый рецепт с заменой строк вида allow-hotplug wlan0, iface wlan0 inet manual и wpa-roam уже не стоит считать главным и обязательным. Более того, без необходимости править этот файл на свежей системе может быть даже вредно – потом сложнее понять, почему Wi-Fi ведет себя странно.

На сегодня я рекомендую два основных консольных пути:

1. Через raspi-config – самый понятный вариант для новичка.
2. Через nmcli – самый универсальный и гибкий вариант для консоли.

Сначала обязательно задайте страну беспроводной сети. Это важный шаг, который многие пропускают, а потом удивляются, почему Wi-Fi не поднимается или не видит часть сетей. Делается это так:

sudo raspi-config

Далее откройте раздел локализации и выберите WLAN Country. Если любите команды без меню, можно сделать то же самое сразу:

sudo raspi-config nonint do_wifi_country RU

После этого можно задать саму сеть через raspi-config:

sudo raspi-config nonint do_wifi_ssid_passphrase <ssid> <passphrase>

Если в названии сети или пароле есть пробелы, берите значение в обычные кавычки. Это мелочь, но именно из-за нее консольные команды часто «ломаются» у новичков. А если ваша сеть скрыта, то у команды есть и дополнительный параметр для hidden-SSID, но большинству домашних пользователей это не требуется. Кстати, если вы не помните пароль от своей сети, вот подсказка – как узнать пароль от своего Wi-Fi.

Важно! Если у вас Raspberry Pi OS Bookworm и свежее, не нужно слепо копировать старые инструкции с созданием wpa_supplicant.conf в загрузочном разделе карты памяти. Для современных образов этот способ уже не считается штатным путем первичной настройки. Проще и надежнее использовать Raspberry Pi Imager, raspi-config или nmcli.

Получение списка сетей

Едем дальше, попробуем просканировать все окружающие нас сети. Для свежей Raspberry Pi OS удобнее использовать такую команду:

nmcli dev wifi list

Она покажет доступные точки доступа, уровень сигнала, канал, тип защиты и текущий статус подключения. Для обычного пользователя это гораздо нагляднее, чем старые низкоуровневые команды. Вы сразу увидите, к какой сети стоит подключаться, работает ли она в 2.4 ГГц или 5 ГГц и есть ли на ней защита.

Старую команду:

iwlist wlan0 scan

тоже можно встретить в старых инструкциях, и на некоторых системах она еще пригодна. Но на практике сегодня чаще удобнее и понятнее именно nmcli. Если нужная сеть не отображается, первым делом проверьте, не скрыта ли она. В таком случае сканирование может не показать привычного имени SSID, и сеть придется добавлять вручную. Если не понимаете, что вообще такое скрытая сеть, можете отдельно почитать как подключаться к скрытому Wi-Fi.

Еще одна важная мелочь – далеко не все платы и донглы поддерживают 5 ГГц. Поэтому если у вас Raspberry Pi не находит домашнюю сеть, а телефон и ноутбук видят ее без проблем, не спешите грешить на саму плату. Вполне возможно, что роутер раздает отдельную сеть только в 5 ГГц, а ваш адаптер умеет работать только с 2.4 ГГц. Разницу между этими диапазонами я подробно разбирал здесь – чем отличаются 2.4 и 5 ГГц.

Подключение

На Linux удобно вводить данные для доступа к сети заранее, но на современных версиях Raspberry Pi OS самый практичный способ подключения через консоль выглядит так.

Сначала на всякий случай включаем радио Wi-Fi:

nmcli radio wifi on

Потом подключаемся к обычной видимой сети:

sudo nmcli --ask dev wifi connect <имя_сети>

Команда сама спросит пароль и сохранит подключение. После этого Raspberry Pi обычно будет подключаться к этой сети автоматически. Если же сеть скрыта, используйте такой вариант:

sudo nmcli --ask dev wifi connect <имя_сети> hidden yes

Проверить, успешно ли прошло подключение, можно так:

nmcli dev wifi list

В колонке IN-USE рядом с вашей сетью появится звездочка. Дополнительно можно еще раз посмотреть IP-адрес:

ip a

Если нужен не обычный DHCP, а статический IP-адрес, вот уже конкретное решение для консоли. Сначала посмотрите точное имя созданного подключения:

nmcli con show

А потом задайте ручной адрес, шлюз и DNS, подставив свои значения:

sudo nmcli con mod "<имя_соединения>" ipv4.method manual ipv4.addresses "192.168.1.50/24" ipv4.gateway "192.168.1.1" ipv4.dns "1.1.1.1 8.8.8.8"
sudo nmcli con up "<имя_соединения>"

Это удобно, если Raspberry Pi у вас работает как мини-сервер, медиасервер, контроллер умного дома, ретро-консоль или файловое хранилище, и вы хотите всегда заходить на нее по одному и тому же адресу. Для обычного домашнего сценария статический IP нужен не всегда, но для Raspberry Pi это один из самых частых практических запросов.

Если у вас старая Raspberry Pi OS Legacy или другой старый образ, где еще активно используется wpa_supplicant, ручная правка файла /etc/wpa_supplicant/wpa_supplicant.conf все еще может пригодиться. Но даже там чаще всего достаточно минимального варианта: страна, SSID и пароль. Перегружать файл параметрами proto, pairwise, group и прочими тонкостями стоит только тогда, когда вы точно понимаете, зачем это делаете и действительно уперлись в нестандартную сеть.

Если вы все же работаете со старой системой и хотите именно классический способ, файл обычно выглядит так:

country=RU
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
ssid="имя_сети"
psk="пароль_сети"
}

Но еще раз подчеркну – на текущий день для обычного пользователя на Raspberry Pi OS гораздо проще и надежнее идти через raspi-config, nmcli или настройки в Imager.

Через графический интерфейс

Здесь все зависит от версии вашей операционной системы, но обычно подключение выглядит очень похоже на привычный Linux-рабочий стол: щелкаете по значку сети, выбираете нужную точку доступа, вводите пароль и ждете несколько секунд, пока сеть поднимется.

Т.е. привычно – щелкнули по значку, выбрали нужную сеть среди доступных, ввели от нее пароль. Но здесь тоже есть актуальное уточнение: внешний вид окон на Raspberry Pi OS может отличаться в зависимости от версии системы, темы и типа рабочего стола. Поэтому не цепляйтесь к мелочам вроде формы значка или цвета кнопки. Суть та же – ищем сетевой значок, нужную точку доступа и поле для ключа безопасности. Если не помните, какой тип защиты лучше использовать на роутере, вот отдельный разбор – что такое WPA, WPA2 PSK и WPA3.

Если ваша сеть скрыта, в графическом интерфейсе обычно есть пункт вроде «Подключиться к скрытой сети» или «Advanced Options». Там уже нужно вручную ввести имя сети, тип защиты и пароль. Для домашнего Wi-Fi скрытие SSID редко дает реальную пользу, а вот лишних проблем при подключении добавляет легко. Так что если вы сами настраиваете роутер и хотите, чтобы Raspberry Pi подключалась проще, обычно лучше оставить обычную видимую сеть.

В случае необходимости точной настройки, например ручного назначения IP-адреса, лучше использовать дополнительные параметры соединения через меню сети или уже перейти в консоль и выполнить настройку через nmcli. Так получается и быстрее, и нагляднее, и удобнее для последующего обслуживания. Особенно это важно для headless-устройств, где вы потом все равно будете работать по SSH.

Частые проблемы

Если Wi-Fi у Raspberry Pi не работает, чаще всего проблема кроется не в «магии Linux», а в одной из нескольких банальных вещей:

• Не задана страна WLAN. Особенно часто это ломает работу 5 ГГц на платах с двухдиапазонным модулем.
• Роутер раздает только 5 ГГц. А плата или USB-адаптер умеют только 2.4 ГГц.
• На роутере включен слишком новый режим безопасности. Некоторые старые адаптеры и сборки плохо дружат с WPA3.
• Слишком современный режим беспроводной сети. Иногда старому USB-донглу проще подключиться, если на роутере стоит совместимый смешанный режим. Если не знаете, где это меняется, посмотрите что такое Wireless Mode и какой режим выбрать.
• Недостаточное питание USB-адаптера. Такое чаще бывает на старых моделях Raspberry Pi и дешевых свистках.
• Неверный пароль или скрытая сеть. Классика, которая встречается чаще любой «сложной» причины.

Если вы используете очень старый USB-адаптер, не удивляйтесь, что он подключается нестабильно, роняет скорость или вообще не видит часть сетей. Это не всегда можно починить командами. Иногда проблема банально в чипсете, драйвере или слабом питании по USB. В такой ситуации часто проще взять другой совместимый донгл, чем бесконечно воевать с настройками.

Еще один частый сценарий – Raspberry Pi раньше подключалась, а потом перестала после смены настроек роутера. Обычно это происходит после перевода сети в WPA3, смены пароля, включения только 5 ГГц или изменения режима беспроводной сети. Если вы недавно что-то меняли на маршрутизаторе, начните именно с него. При необходимости вот инструкция, как поменять пароль на Wi-Fi и не запутаться в настройках.

FAQ

Нужно ли редактировать /etc/network/interfaces на свежей Raspberry Pi OS?
Обычно нет. На текущий день это уже не основной способ настройки Wi-Fi. Для свежих систем лучше использовать Raspberry Pi Imager, raspi-config, nmcli или графический интерфейс.

 

Почему команда ifconfig не работает?
Потому что на свежей системе пакет net-tools может быть не установлен. Вместо этого используйте ip a и ip link show. Это уже стандартный современный путь в Linux.

 

Можно ли настроить Wi-Fi без монитора и клавиатуры?
Да, и это один из самых удобных сценариев для Raspberry Pi. Проще всего задать сеть и SSH еще в Raspberry Pi Imager, а потом подключиться к плате удаленно после первой загрузки.

 

Почему Raspberry Pi не видит мою сеть?
Чаще всего потому, что сеть работает только в 5 ГГц, скрыта, использует слишком новый режим безопасности или на самой Raspberry Pi не задана страна WLAN. Иногда проблема и в самом USB-адаптере, если он старый или плохо поддерживается системой.

 

Как понять, что проблема именно в роутере, а не в Raspberry Pi?
Самый простой тест – раздать Wi-Fi со смартфона в диапазоне 2.4 ГГц и попробовать подключиться к нему. Если Raspberry Pi цепляется к телефону без проблем, значит плата живая, а искать причину нужно уже в домашнем роутере или его настройках.

Вот и все. Если есть что дополнить или остались вопросы – пишите смело в комментарии. Вместе мы можем помочь друг другу и разрешить все вопросы в этой сфере!

Видео

YouTube