Настройка Wi‑Fi на Raspberry Pi

Как настроить Wi‑Fi на Raspberry Pi через командную строку

Быстрые ссылки

Почему это нужно
Что потребуется
Включение Wi‑Fi адаптера через терминал
Проверка и устранение неполадок

Почему это нужно

Когда Raspberry Pi настроен как «headless» (без монитора и клавиатуры), любая новая аппаратная или сетевая конфигурация может заставить вас снова подключать периферийные устройства. Настройка Wi‑Fi по SSH позволяет избегать этой рутины: вы продолжаете управлять устройством удалённо и переводите его на беспроводную сеть без физического доступа.

Коротко: настройка полезна для переносимых проектов, удалённых датчиков и случаев, когда Ethernet недоступен.

Что потребуется

1 Raspberry Pi с установленной Raspbian (или совместимой Linux‑сборкой).
Проводной Ethernet‑кабель и доступ к сети (временное подключение для настройки).
USB Wi‑Fi‑донгл, поддерживаемый ядром Linux/драйвером (проверьте раздел USB Wi‑Fi adapters на вики Raspberry Pi).
SSID, пароль и тип шифрования вашей Wi‑Fi сети (WPA/WPA2, TKIP/CCMP и т. п.).

Важно: если ваш адаптер требует проприетарных драйверов, настройка по SSH может не сработать до установки драйвера. В таком случае временно подключите монитор/клавиатуру или используйте совместимый адаптер.

Включение Wi‑Fi адаптера через терминал

Подключите Raspberry Pi к сети через Ethernet и зайдите по SSH:

ssh pi@

Откройте файл /etc/network/interfaces в текстовом редакторе nano:

sudo nano /etc/network/interfaces

Вы увидите базовую конфигурацию, например:

auto lo
iface lo inet loopback
iface eth0 inet dhcp

Добавьте строки для Wi‑Fi интерфейса (wlan0):

allow-hotplug wlan0
iface wlan0 inet dhcp
wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
iface default inet dhcp

Сохраните CTRL+X, Y, Enter.

Отредактируйте /etc/wpa_supplicant/wpa_supplicant.conf:

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

Если файл пуст или отсутствует, заполните следующим образом, заменив YOURSSID и YOURPASSWORD на реальные значения:

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

network={
  ssid="YOURSSID"
  psk="YOURPASSWORD"
  # Protocol type can be: RSN (for WPA2) and WPA (for WPA1)
  proto=WPA
  # Key management type can be: WPA-PSK or WPA-EAP
  key_mgmt=WPA-PSK
  # Pairwise can be CCMP or TKIP (for WPA2 or WPA1)
  pairwise=TKIP
  # Authorization option should be OPEN for both WPA1/WPA2
  auth_alg=OPEN
}

Примечание: если у вас скрытая сеть, добавьте в блок network строку scan_ssid=1.

Защитите файл с паролем Wi‑Fi:

sudo chmod 600 /etc/wpa_supplicant/wpa_supplicant.conf

Отключите Ethernet, подключите Wi‑Fi‑донгл и перезагрузите Pi:

sudo reboot

После перезагрузки устройство должно автоматически подключиться к сети, указанной в wpa_supplicant.conf.

Проверка подключения и базовые команды диагностики

Если после перезагрузки Pi не появился в вашей сети, подключите Ethernet обратно и выполните проверки:

Просмотреть сетевые интерфейсы и IP‑адреса:

ip addr show

Проверить состояние WLAN и список обнаруженных сетей:

sudo iwlist wlan0 scan
sudo iwconfig wlan0

Просмотреть системные сообщения ядра для Wi‑Fi‑адаптера:

dmesg | grep -i wlan
lsusb

Проверить логи службы сети (для systemd‑систем):

sudo journalctl -u dhcpcd -b

Убедиться, что DHCP‑сервер выдал адрес и есть маршрут:

ip route
ping -c 3 8.8.8.8

Если адаптер не распознаётся, проверьте совместимость модели и драйверы.

Устранение распространённых проблем

Адаптер не виден в lsusb: попробуйте другой USB‑порт, убедитесь, что адаптер получает питание.
wpa_supplicant не подключается: проверьте правильность SSID/psk и параметры proto/key_mgmt/pairwise; для WPA2 используйте proto=RSN и pairwise=CCMP.
Неправильные права на wpa_supplicant.conf приводят к отказу: используйте chmod 600.
Для сетей с EAP/Enterprise применяйте соответствующую конфигурацию key_mgmt=WPA-EAP и дополнительные поля (identity, password, ca_cert).

Альтернативные подходы

raspi-config: если у вас доступ к консоли, утилита raspi-config может настроить Wi‑Fi в интерактивном режиме.
NetworkManager/wicd: современные дистрибутивы могут использовать другие менеджеры сети; конфигурационные файлы отличаются.
Настройка wpa_cli: интерактивный инструмент для управления wpa_supplicant на лету.

Безопасность и права доступа

Храните пароли только в /etc/wpa_supplicant/wpa_supplicant.conf с правами 600.
По возможности используйте WPA2 (proto=RSN, pairwise=CCMP).
Ограничьте доступ по SSH (отключите root‑вход, используйте ключи). Это особенно важно, если устройство будет подключено к публичной сети.

Кратко: ключевые команды (cheat sheet)

Редактирование конфигурации сети:

sudo nano /etc/network/interfaces
sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

Перезагрузка:

sudo reboot

Диагностика:

ip addr show
sudo iwlist wlan0 scan
dmesg | grep -i wlan
lsusb
sudo journalctl -u dhcpcd -b

Роль‑ориентированные чек‑листы

Для разработчика/создателя проекта:
- Проверить совместимость донгла заранее
- Настроить SSH и сохранить доступные ключи
- Защитить wpa_supplicant паролем (chmod 600)
Для администратора сети:
- Убедиться, что сеть выдаёт DHCP‑адреса
- Проверить фильтрацию по MAC (если включена)
- Логировать подключение новых устройств
Для тестировщика/QA:
- Перезагрузить Pi и подтвердить автоподключение
- Проверить доступность службы по SSH через Wi‑Fi
- Выполнить сетевые пинги и тесты скорости (при необходимости)

Критерии приёмки

Raspberry Pi получает IP‑адрес на интерфейсе wlan0.
Можно подключиться по SSH к IP‑адресу, назначенному по Wi‑Fi.
Пингуются внешние адреса (например, 8.8.8.8).
Файл /etc/wpa_supplicant/wpa_supplicant.conf защищён правами 600.

Когда этот метод не подойдёт

Адаптер требует дополнительных проприетарных драйверов и без них не работает.
Сеть использует нестандартную аутентификацию (Enterprise/EAP) без соответствующей настройки.
У вас нет временного Ethernet‑подключения и нужно настроить адаптер «с нуля» без физического доступа — тогда необходим монитор/клавиатура или предварительная подготовка карточки SD.

Короткое резюме

Настройка Wi‑Fi на headless Raspberry Pi через командную строку — удобный способ перевести устройство на беспроводную сеть без физического доступа. Главное — корректно отредактировать /etc/network/interfaces и /etc/wpa_supplicant/wpa_supplicant.conf, защитить файл с паролем и проверить подключение после перезагрузки. При возникших проблемах используйте перечисленные команды диагностики и проверьте совместимость адаптера.

Важно: если что‑то не работает, подключите Ethernet обратно и пошагово проверьте конфигурационные файлы и системные логи.