Как настроить Wi‑Fi и Bluetooth на Raspberry Pi 3 и 4

Кому это нужно

• Новички, которые впервые подключают Raspberry Pi к сети.
• Разработчики, которые настраивают безголовую (headless) сборку через SSH.
• Инсталляторы и хоббисты, которые собирают устройства с ограниченным доступом к монитору.

Кратко о том, какие модели поддерживают беспроводные интерфейсы

Raspberry Pi 3 стал первой моделью с интегрированным Wi‑Fi и Bluetooth. Затем эти интерфейсы появились в Raspberry Pi Zero W, Raspberry Pi 3 B+ и Raspberry Pi 4.

• Raspberry Pi 3 — Wi‑Fi 802.11n, Bluetooth 4.1 (BLE)
• Raspberry Pi 3 B+ — улучшенный Wi‑Fi 802.11ac (2.4/5 ГГц), Bluetooth 4.2 (BLE)
• Raspberry Pi Zero W — небольшая плата с Wi‑Fi и Bluetooth в корпусе Zero
• Raspberry Pi 4 — Wi‑Fi 802.11ac, Bluetooth 5.0

Важно: характеристики аппаратной части ограничивают скорость и возможности (например, Bluetooth LE или класс передачи данных). Если нужен более широкий диапазон или высокая пропускная способность, выбирайте Raspberry Pi 4.

Таблица совместимости (быстрый обзор)

Как включить Wi‑Fi через рабочий стол Raspberry Pi (GUI)

1. Подключите клавиатуру, мышь и дисплей к Pi (или подключитесь по VNC/RDP через Ethernet).
2. В правом верхнем углу панели найдите значок сети (серый, если Wi‑Fi отключён).
3. Правый клик по значку → выберите «Включить Wi‑Fi» (Turn on Wi‑Fi). Затем в списке выберите нужную сеть.

4. Введите «Pre Shared Key» (пароль сети) и нажмите OK. Дождитесь установления соединения.

Примечание: названия пунктов интерфейса могут отличаться в локализованных сборках системы, но логика аналогична.

Настройка Wi‑Fi в командной строке (через SSH или локально)

Подходит для headless‑установок или если вы работаете по SSH (часто через Ethernet на первом запуске).

1. Обновите пакеты:

sudo apt update && sudo apt upgrade -y

2. Найдите доступные сети (если нужен список SSID):

sudo iwlist wlan0 scan

В выводе ищите строку ESSID — там указан SSID точки доступа.

3. Откройте файл настроек wpa_supplicant:

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

4. Добавьте или отредактируйте блок:

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

network={
  ssid="ВАШ_SSID"
  psk="ВАШ_ПАРОЛЬ"
  key_mgmt=WPA-PSK
}

Замените country=RU на код вашей страны (RU для России, UA для Украины и т.д.). Сохраните Ctrl+X → Y → Enter.

5. Примените изменения:

sudo ifdown wlan0 || true
sudo ifup wlan0 || true
# или перезагрузите систему
sudo reboot

Заметки:

• На некоторых системах управление сетью осуществляет dhcpcd или NetworkManager — используйте systemctl restart dhcpcd, если ifdown/ifup недоступны.
• Если SSID скрыт, указывайте scan_ssid=1 в блоке network.

Настройка Wi‑Fi до первой загрузки (headless, через microSD)

1. Вставьте microSD в считыватель на компьютере и откройте раздел /boot (он доступен в Windows/macOS/Linux).
2. Создайте файл wpa_supplicant.conf в корне /boot и вставьте в него тот же конфиг, что выше (указав ваш SSID и пароль).
3. Вставьте карту в Pi и выполните первую загрузку. Raspbian/ Raspberry Pi OS автоматически перенесёт файл в /etc/wpa_supplicant/.

Важно: в некоторых образах (особенно новых вариантах Raspberry Pi OS) предыдущий метод может не работать из‑за драйверов или политик безопасности — в таком случае используйте метод через SSH или GUI.

Настройка Bluetooth в командной строке

Если пакет Bluetooth не установлен (старые версии системы), выполните обновление и установку:

sudo apt update
sudo apt install bluez pi-bluetooth -y

Запустите утилиту управления Bluetooth:

bluetoothctl

В интерактивной консоли bluetoothctl выполните команды:

power on
agent on
default-agent
scan on

После обнаружения устройства увидите строку с MAC‑адресом и именем. Чтобы подключиться:

pair XX:XX:XX:XX:XX:XX
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX

Если устройство требует PIN/код — введите его, когда будет запрос. Для выхода используйте quit.

Подключение Bluetooth через рабочий стол

1. Нажмите на значок Bluetooth в панели.
2. Выберите «Добавить устройство» (Add Device) — система начнёт поиск.
3. Выберите устройство в списке и нажмите «Спарить» (Pair). Следуйте подсказкам для ввода PIN или подтверждения.

Подключение старых Raspberry Pi (через USB‑донглы)

Если у вас Raspberry Pi 2, оригинальный Zero или модель без встроенных модулей:

• Для Wi‑Fi используйте USB‑Wi‑Fi адаптер совместимый с Linux (ch340/ch34x и чипы Realtek часто требуют дополнительных драйверов).
• Для Bluetooth используйте совместимый USB‑адаптер Bluetooth (чтобы поддерживались BlueZ).

Для Pi Zero рассмотрите Pi Zero W как простую альтернативу: она недорогая и уже содержит беспроводные интерфейсы. Если вы остаётесь на Pi Zero без W, используйте USB‑OTG кабель и хаб, чтобы подключить донглы.

Чек‑лист: перед тем как начать

• У вас есть физический доступ или рабочая сеть Ethernet для первоначального доступа.
• Знаете SSID и пароль точки доступа.
• Убедитесь, что в country стоит код вашей страны (влияет на разрешённые частоты Wi‑Fi).
• Если headless, подготовьте файл wpa_supplicant.conf в /boot.
• Обновите пакеты sudo apt update && sudo apt upgrade.

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

• Новичок: подключить экран, мышь, клавиатуру → GUI → включить Wi‑Fi.
• Headless (разработчик): прописать wpa_supplicant в /boot или подключиться по Ethernet → SSH → настроить /etc/wpa_supplicant/wpa_supplicant.conf.
• Инсталлятор: протестировать в целевой сети, проверить стабильность соединения, добавить авто‑переподключение и мониторинг.

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

• Сеть не видна: проверьте диапазон (2.4 ГГц vs 5 ГГц), country и режим точки доступа; некоторые старые Pi не поддерживают 5 ГГц.
• wlan0 отсутствует: проверьте наличие драйверов, выполнение rfkill list (убрать блокировку sudo rfkill unblock all).
• Authentication failed: перепроверьте SSID и пароль, удалите лишние пробелы, убедитесь, что используете правильную кодировку.
• Bluetooth «No default controller»: проверьте, запущен ли сервис Bluetooth (sudo systemctl status bluetooth) и установлен ли пакет bluez.

Мини‑методология для headless установки (быстрая последовательность)

1. Запишите OS на microSD.
2. Создайте пустой файл ssh в разделе /boot для активации SSH.
3. Создайте wpa_supplicant.conf в /boot с настройками сети.
4. Вставьте карту в Pi и включите питание.
5. Подключитесь по SSH к обнаруженному IP (смотрите DHCP‑сервер роутера или используйте nmap).

Решения в обход: когда встроенный модуль не подходит

• Используйте USB‑донгл с внешней антенной для лучшего приёма.
• Подключите Pi к Ethernet для стабильной передачи данных, если Wi‑Fi срочно нестабилен.
• Для профессионального аудио/контроллеров рассмотрите Bluetooth‑адаптеры с поддержкой соответствующих профилей.

Безопасность и рекомендации

• Смените пароль пользователя pi и, при возможности, используйте SSH‑ключи вместо паролей.
• Отключите прямой доступ к ROOT через SSH (PermitRootLogin no) и запретите аутентификацию паролем, если используются ключи.
• Держите систему в актуальном состоянии: sudo apt update && sudo apt upgrade.
• При необходимости используйте UFW (локальный фаервол) и ограничьте входящие соединения.

Быстрая диаграмма выбора метода (Mermaid)

flowchart TD
  A[Начало] --> B{Есть ли монитор/клавиатура?}
  B -- Да --> C[Настроить через GUI]
  B -- Нет --> D{Есть Ethernet или возможность подключиться по кабелю?}
  D -- Да --> E[Подключиться по SSH и настроить /etc/wpa_supplicant/...]
  D -- Нет --> F[Создать wpa_supplicant.conf в /boot + файл ssh]
  C --> Z[Готово]
  E --> Z
  F --> Z

Краткий глоссарий (1‑строчные определения)

• SSID — имя вашей беспроводной сети.
• PSK — предустановленный ключ (пароль) для WPA/WPA2.
• BLE — Bluetooth Low Energy, низкоэнергетичный профиль Bluetooth.
• wpa_supplicant — служба для аутентификации и управления Wi‑Fi.

Короткое примечание по GDPR/конфиденциальности

Bluetooth и Wi‑Fi видимы в сети: убедитесь, что не испускаете чувствительные данные в открытом виде и применяете шифрование WPA2/WPA3 при работе с личной информацией.

Итог

Raspberry Pi 3, 3 B+, Zero W и 4 имеют встроенные Wi‑Fi и Bluetooth — их настройка проста как через графический интерфейс, так и по командной строке. Для старых плат используйте USB‑донглы. Рекомендуется настроить устройство заранее (wpa_supplicant в /boot) для headless‑сборок, обновить систему и позаботиться о безопасности (смена пароля, SSH‑ключи).

Important: если что‑то не работает — начните с проверки country в wpa_supplicant, наличия драйверов и состояния службы bluetooth.

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

• Проверьте модель платы и её возможности.
• Настройте Wi‑Fi через GUI, SSH или файл в /boot.
• Настройте Bluetooth через bluetoothctl или GUI.
• Используйте донглы для старых плат.