TrueNAS WiFi: Полное руководство по настройке беспроводного подключения

Представь, что тебе нужно развернуть домашний NAS в месте, где нет возможности протянуть Ethernet-кабель. Или ты хочешь создать мобильное хранилище данных. В этой ситуации возникает закономерный вопрос: а поддерживает ли TrueNAS WiFi? Давай разберем этот вопрос досконально, как настоящие инженеры.

Почему WiFi в TrueNAS — это нетривиальная задача?

По умолчанию ни TrueNAS SCALE (на базе Linux), ни TrueNAS CORE (на базе FreeBSD) не имеют графического интерфейса для настройки беспроводных сетей в WebUI. Это осознанное решение разработчиков, и вот почему:

• Стабильность и надежность: NAS — это сетевое хранилище, где стабильность соединения критически важна. WiFi подвержен помехам.
• Производительность: Даже WiFi 6 редко может сравниться по скорости и задержкам с гигабитным Ethernet.
• Безопасность: Прямой доступ к настройкам сети через WebUI — дополнительный вектор атаки.

Подготовка: проверка совместимости WiFi адаптера

Первое, что нужно сделать — убедиться, что твоя WiFi-карта или USB-адаптер поддерживается системой. Драйверы — наше всё.

Для TrueNAS SCALE (Linux Debian)

Большинство современных адаптеров с чипами Intel, Qualcomm Atheros и Realtek (с драйвером rtw88/rtw89) работают из коробки. Проблемы часто возникают с Broadcom и некоторыми Realtek (старые RTL8812AU, RTL88x2bu).

# Подключись к консоли TrueNAS (Shell в WebUI или SSH)
# 1. Определи модель сетевого адаптера
lspci | grep -i network
# или для USB-адаптеров
lsusb

# 2. Проверь, какие модули (драйверы) загружены для WiFi
lsmod | grep -i wifi
lsmod | grep -E '(rtw|ath|iwlwifi|brcm|mt76)'

# 3. Узнай имя интерфейса. Обычно это wlan0, wlp2s0 и т.д.
ip link show | grep -E '^[0-9]+: w'

Для TrueNAS CORE (FreeBSD)

Ситуация сложнее. Поддержка в FreeBSD есть, но она более ограничена. Хорошо поддерживаются чипы Atheros (драйвер ath) и Intel (драйвер iwm).

# В консоли TrueNAS CORE
# 1. Посмотреть PCI/USB устройства
pciconf -lv | grep -A4 -B2 network
usbconfig list

# 2. Проверить наличие интерфейса WiFi
ifconfig | grep -i link
# Ищи имена вроде wlan0, ath0

Метод 1: Настройка WiFi через командную строку (CLI) в TrueNAS SCALE

Это самый прямой и контролируемый способ. Мы будем использовать утилиту nmcli (NetworkManager), которая уже предустановлена.

Шаг 1: Включение и сканирование сетей

# 1. Убедись, что NetworkManager запущен
sudo systemctl status NetworkManager

# 2. Если нет, включи и запусти (по умолчанию должен быть активен)
sudo systemctl enable --now NetworkManager

# 3. Включи радио-интерфейс WiFi (интерфейс может называться иначе)
sudo nmcli radio wifi on

# 4. Просканируй доступные сети
sudo nmcli device wifi list
# Вывод покажет SSID, сигнал, безопасность и т.д.

Шаг 2: Подключение к сети

Есть два основных сценария: WPA2/WPA3 Personal (пароль) и скрытая сеть.

# Сценарий A: Подключение к открытой сети или сети с паролем
sudo nmcli device wifi connect "Ваш_SSID" password "Ваш_пароль"

# Сценарий B: Подключение к скрытой сети (hidden SSID)
sudo nmcli connection add type wifi con-name "MyHiddenWiFi" ssid "Скрытый_SSID" \
    wifi-sec.psk "Ваш_пароль" wifi-sec.key-mgmt wpa-psk wifi.hidden yes
sudo nmcli connection up "MyHiddenWiFi"

# Сценарий C: Подключение к сети без пароля (OPEN)
sudo nmcli device wifi connect "SSID_OPEN_NETWORK"

Шаг 3: Проверка и настройка статического IP (опционально)

# 1. Проверь подключение и полученный IP-адрес
ip addr show wlan0  # замени wlan0 на имя твоего интерфейса
nmcli connection show --active

# 2. Настрой статический IP-адрес вместо DHCP
# Сначала узнай имя подключения (Connection name) из списка выше
sudo nmcli connection modify "Ваш_SSID" ipv4.method manual \
    ipv4.addresses "192.168.1.150/24" \
    ipv4.gateway "192.168.1.1" \
    ipv4.dns "8.8.8.8 1.1.1.1"

# 3. Примени изменения
sudo nmcli connection down "Ваш_SSID"
sudo nmcli connection up "Ваш_SSID"

Метод 2: Настройка через конфигурационные файлы (Продвинутый)

Если nmcli по каким-то причинам недоступен или ты хочешь полного контроля, можно настроить WiFi через netplan (актуально для новых версий SCALE) или wpa_supplicant.

Использование wpa_supplicant

# 1. Создай конфигурационный файл для твоей сети
sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

# 2. Добавь в файл следующее содержимое:
ctrl_interface=/var/run/wpa_supplicant
ap_scan=1

network={
    ssid="Ваш_SSID"
    psk="Ваш_пароль"
    # Для скрытой сети добавь:
    scan_ssid=1
    # Приоритет сети (если их несколько)
    priority=5
}

# 3. Запусти wpa_supplicant вручную для проверки
sudo wpa_supplicant -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf -B

# 4. Запроси IP через DHCP
sudo dhclient wlan0

Метод 3: TrueNAS CORE и WiFi (FreeBSD)

Здесь процесс отличается. Основная утилита — wpa_supplicant, а настройка интерфейса происходит через ifconfig и dhclient.

# 1. Создай базовый конфиг wpa_supplicant
echo 'network={
    ssid="Ваш_SSID"
    psk="Ваш_пароль"
}' | sudo tee /etc/wpa_supplicant.conf

# 2. Найди свой WiFi интерфейс (например, wlan0)
ifconfig | grep -E '^wlan|^ath'

# 3. Запусти wpa_supplicant на этом интерфейсе
sudo wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf -B

# 4. Получи IP-адрес
sudo dhclient wlan0

# 5. Для автозагрузки при старте добавь в /etc/rc.conf
# (ВНИМАНИЕ: Изменение системных файлов в TrueNAS CORE может быть сброшено при обновлении!)
echo 'wlans_ath0="wlan0"' | sudo tee -a /etc/rc.conf
echo 'ifconfig_wlan0="WPA SYNCDHCP"' | sudo tee -a /etc/rc.conf

Сравнение методов подключения WiFi

Частые проблемы и их решения

1. Адаптер не определяется или нет интерфейса wlan0

Причина: Отсутствие драйвера в ядре.
Решение для SCALE: Установи проприетарный драйвер через dkms (сложно, может сломаться при обновлении). Часто проще купить совместимый адаптер (Intel AX200/AX210).

2. Подключение есть, но нет доступа в интернет или к NAS

# Диагностика:
# 1. Проверь маршрутизацию
ip route show
# Должен быть default via твой.шлюз dev wlan0

# 2. Проверь DNS
nslookup google.com

# 3. Возможно, брандмауэр блокирует
sudo iptables -L -n -v  # для SCALE
sudo ipfw show          # для CORE

# 4. Если у тебя также есть Ethernet (igb0) и WiFi (wlan0), может быть конфликт.
# Отключи авто-поднятие eth или настрой метрики.
sudo nmcli connection modify "Проводное-подключение" ipv4.route-metric 100
sudo nmcli connection modify "Ваш_SSID" ipv4.route-metric 50  # WiFi приоритетнее

3. Соединение обрывается или нестабильно

• Улучши сигнал: Используй адаптер с внешней антенной.
• Настрой канал на роутере: Выбери наименее загруженный канал (1, 6, 11 для 2.4 GHz).
• Отключи power saving на адаптере (SCALE):
  bash

  # Создай конфиг для отключения энергосбережения
  echo 'options iwlwifi power_save=0' | sudo tee /etc/modprobe.d/iwlwifi-no-power-save.conf
  sudo update-initramfs -u  # пересобрать initramfs
  sudo reboot

Альтернатива: WiFi Bridge (Мост) или Клиент

Если настройка WiFi прямо на NAS кажется слишком сложной, рассмотри эти варианты:

• Внешний WiFi-роутер в режиме клиента: Настрой старый роутер (например, на OpenWRT) как WiFi-клиента, а от него протяни Ethernet к TrueNAS. NAS будет думать, что он на проводной сети.
• WiFi to Ethernet адаптер: Готовые устройства (как TP-Link TL-WR802N в режиме клиента), которые подключаются к WiFi и выдают Ethernet-порт.

FAQ: Ответы на частые вопросы

Заключение и итоговая рекомендация

Давай резюмируем. Подключить TrueNAS к WiFi — задача выполнимая, особенно на платформе SCALE с помощью nmcli. Однако, это решение сопряжено с компромиссами в стабильности и производительности.

• Для домашнего медиа-сервера (Plex, Jellyfin), где не требуется постоянная высокая скорость записи, WiFi может быть приемлемым вариантом.
• Для рабочего NAS или хранения критичных данных — однозначно используй проводное Ethernet-подключение. Если кабель физически невозможно протянуть, рассмотри технологию Powerline (сетевые адаптеры через розетки) или точку доступа в режиме моста, как описано выше.

Как Senior DevOps ментор, мой совет: если ты всё же решил пойти по пути WiFi, тщательно протестируй стабильность соединения в течение нескольких дней перед тем, как переносить на NAS важные данные. Создай тестовый пул и «погоняй» его нагрузкой. Удачи в настройке!