↓ Aller au contenu

Carte réseau sans fil ALFA : prise en charge par OpenWrt ?

1. Résumé du problème
#

Le client demande : « Peut-on utiliser la carte réseau USB ALFA série sur un routeur OpenWrt ? »

Conclusion rapide : OpenWrt est la plateforme des trois principaux systèmes d’exploitation tiers pour les routeurs (DD-WRT / OpenWrt / Tomato) qui offre le meilleur soutien aux cartes réseau USB WiFi ALFA. Les modèles de puces MediaTek (AWUS036ACM / ACHM / AXML / AXM) sont directement pris en charge par le kit officiel kmod-mt76 ; les modèles de puces Realtek (AWUS036ACH / ACS / EACS / AX / AXER) nécessitent l’utilisation de kits de pilotes out-of-tree maintenus par la communauté, leur disponibilité variant selon la version d’OpenWrt. Le modèle AWUS036ACM (MT7612U) est recommandé, ses pilotes sont matures, stables et prennent en charge l’écoute et l’injection.

Évaluation des modèles : ALFA propose 9 cartes réseau USB actuelles (AWUS036ACM / ACHM / ACS / EACS / ACH / AX / AXER / AXML / AXM).

2. Analyser les spécifications et les besoins du logiciel cible
#

2.1 Qu’est-ce que OpenWrt ?
#

OpenWrt est un système de firmware pour routeurs open source, hautement modulaire, utilisant le kernel Linux et le système de gestion de paquets opkg. Contrairement à DD-WRT ou Tomato, les pilotes de OpenWrt sont fournis sous forme de modules noyau (kmod) indépendants, ce qui permet aux utilisateurs d’installer des pilotes WiFi USB sans avoir à recompiler tout le firmware.

2.2 Le cadre de pilotes WiFi USB d’OpenWrt
#

La bibliothèque de paquets officielle d’OpenWrt contient les pilotes WiFi USB suivants :

Paquet de piloteSourceChips / Modèles couvertsÉtat de maintenance
kmod-mt76-usb + kmod-mt76x2uOfficiel in-kernelMediaTek MT7612U (AWUS036ACM)Actif, stable
kmod-mt76-usb + kmod-mt76x0uOfficiel in-kernelMediaTek MT7610U (AWUS036ACHM)Actif
kmod-mt7921uOfficiel in-kernelMediaTek MT7921AUN (AWUS036AXML / AXM)Disponible depuis la version 23.05+
kmod-rtl8812au-ctCommunauté out-of-treeRealtek RTL8812AU / RTL8811AU (AWUS036ACH / ACS)Maintenu par la communauté, des crashs du kernel ont été signalés en 24.10
kmod-rtl8821cuCommunauté out-of-treeRealtek RTL8821CU (AWUS036EACS)Maintenu par la communauté
kmod-rtw89 / kmod-rtl8852buEn développementRealtek RTL8832BU (AWUS036AX / AXER)La prise en charge USB rtw89 est progressivement intégrée, nécessite un kernel plus récent

2.3 Prérequis : Support du noyau USB
#

Avant d’installer les pilotes WiFi, il est nécessaire de s’assurer que OpenWrt a activé le support du noyau USB :

opkg update
opkg install kmod-usb-core kmod-usb2 kmod-usb3 usbutils

La plupart des versions modernes d’OpenWrt incluent déjà kmod-usb-core, mais usbutils (qui fournit la commande lsusb) doit être installé manuellement.

3. Analyse des spécifications et des puces des cartes réseau ALFA
#

Au 9 septembre 2026, la gamme de produits de cartes réseau USB sans fil actuels d’ALFA Network est la suivante (base : 9 modèles) :

ModèleNiveau Wi-FiPuceInterfacePaquet de pilotes OpenWrt
AWUS036AXMLWi-Fi 6EMediaTek MT7921AUNUSB-C / USB 3.2kmod-mt7921u (23.05+)
AWUS036AXMWi-Fi 6EMediaTek MT7921AUNUSB 3.2 + BT 5.2kmod-mt7921u (23.05+)
AWUS036AXWi-Fi 6Realtek RTL8832BUUSB 3.2kmod-rtw89 (en développement) / rtl8852bu personnalisé
AWUS036AXERWi-Fi 6Realtek RTL8832BUUSB 3.2Comme ci-dessus
AWUS036ACHWi-Fi 5 (AC1200)Realtek RTL8812AUUSB 3.0kmod-rtl8812au-ct (communauté)
AWUS036ACHMWi-Fi 5 (AC600)MediaTek MT7610UUSB 2.0kmod-mt76x0u (officiel)
AWUS036ACMWi-Fi 5 (AC1200)MediaTek MT7612UUSB 3.0kmod-mt76x2u (officiel)⭐ Recommandé
AWUS036ACSWi-Fi 5 (AC600)Realtek RTL8811AUUSB 2.0kmod-rtl8812au-ct (couverture)
AWUS036EACSWi-Fi 5 (AC600)Realtek RTL8821CUUSB 2.0kmod-rtl8821cu (communauté)

4. Modèles et SoC compatibles
#

4.1 Catégorie de recommandation
#

Catégorie de recommandationModèle (SoC)Description
⭐ Fortement recommandéAWUS036ACM (MT7612U)Pilotes officiels matures et stables, supporte AP / STA / Monitor / Injection, le meilleur choix sur OpenWrt
✅ RecommandéAWUS036ACHM (MT7610U)Pilotes officiels, double fréquence mais seulement 433Mbps, adapté aux scénarios à faible consommation d’énergie
✅ Recommandé (nouvelle version)AWUS036AXML / AXM (MT7921AUN)Wi-Fi 6E, pilotes officiels, nécessite OpenWrt 23.05+ et kernel 5.15+
⚠️ Disponible mais à surveillerAWUS036ACH (RTL8812AU)Pilotes communautaires, la version 24.10 a des rapports de crash du kernel, recommandé d’utiliser 23.05
⚠️ Disponible mais à surveillerAWUS036ACS (RTL8811AU)Comme ci-dessus, couvert par le pilote 8812au
⚠️ Disponible mais à surveillerAWUS036EACS (RTL8821CU)Pilotes communautaires, stabilité moyenne
❌ DéconseilléAWUS036AX / AXER (RTL8832BU)Wi-Fi 6, le support rtw89 USB est en développement, la plupart des versions OpenWrt ne peuvent pas être utilisées directement

4.2 Exigences matérielles du routeur
#

ItemExigences minimalesExigences recommandées
Port USBUSB 2.0 (AWUS036ACHM / ACS / EACS)USB 3.0 (AWUS036ACH / ACM / AX série)
Flash16MB (installation des pilotes + dépendances)32MB+
RAM128MB256MB+ (mode AP + utilisateurs multiples)
Version OpenWrt21.02+23.05.x (version stable)

5. Nécessités environnementales
#

5.1 Environnement logiciel
#

5.2 Environnement matériel
#

  • Routeur compatible OpenWrt avec un port USB 2.0 / 3.0
  • Pour les modèles à haute puissance (AWUS036ACH), il est recommandé d’utiliser un hub USB 3.0 alimenté pour éviter une alimentation insuffisante du port USB du routeur
  • Le modèle AWUS036AXML est en interface USB-C, veillez à ce que votre routeur dispose d’un port USB-C ou utilisez un adaptateur USB-C to USB-A

6. Détermination de la compatibilité
#

Matrice de compatibilité ALFA modèles actuels × OpenWrt
#

ModèleProcesseurMode de pilotageDétection USBSTA InternetMode APMonitorVersion minimaleÉvaluation globale
AWUS036ACMMT7612Ukmod-mt76x2u✅✅✅✅21.02+⭐ Meilleure
AWUS036ACHMMT7610Ukmod-mt76x0u✅✅✅⚠️ Limitée21.02+✅ Bonne
AWUS036AXMLMT7921AUNkmod-mt7921u✅✅✅⚠️ Limitée23.05+✅ Bonne
AWUS036AXMMT7921AUNkmod-mt7921u✅✅✅⚠️ Limitée23.05+✅ Bonne
AWUS036ACHRTL8812AUkmod-rtl8812au-ct✅✅✅⚠️ Limitée22.03+ (24.10 avec crash)⚠️ Utilisable
AWUS036ACSRTL8811AUkmod-rtl8812au-ct✅✅⚠️❌22.03+⚠️ Utilisable
AWUS036EACSRTL8821CUkmod-rtl8821cu✅⚠️❌❌23.05+⚠️ Utilisable
AWUS036AXRTL8832BUrtw89 (en développement)⚠️❌❌❌Nécessite compilation personnalisée❌ Déconseillé
AWUS036AXERRTL8832BUrtw89 (en développement)⚠️❌❌❌Nécessite compilation personnalisée❌ Déconseillé

Critères de détermination : Accessibilité des paquets kmod dans le dépôt officiel d’OpenWrt (23.05 / 24.10) + retours des utilisateurs du forum OpenWrt. Les pilotes pour les puces Realtek sont maintenus par la communauté, leur stabilité et intégrité fonctionnelle sont inférieures à celles de la série MediaTek mt76.

7. Détails étape par étape détaillés
#

7.1 Préparations initiales : Activer le support USB
#

Étape 1 : Connexion SSH au routeur OpenWrt

Étape 2 : Mise à jour des dépôts de paquets et installation du support USB

opkg update
opkg install kmod-usb-core kmod-usb2 kmod-usb3 usbutils

Étape 3 : Insérer la carte réseau ALFA et vérifier la détection USB

lsusb
# Sortie prévue (AWUS036ACM / MT7612U) :
# Bus 002 Device 003: ID 0e8d:7612 MediaTek Inc. MT7612U 802.11a/b/g/n/ac Wireless Adapter

7.2 Chemin A : Modèles de puces MediaTek (AWUS036ACM / ACHM / AXML / AXM)
#

Par exemple, avec l’AWUS036ACM (MT7612U) :

Étape 1 : Installation des pilotes

# AWUS036ACM (MT7612U)
opkg install kmod-mt76-usb kmod-mt76x2u

# AWUS036ACHM (MT7610U) — Utiliser
# opkg install kmod-mt76-usb kmod-mt76x0u

# AWUS036AXML / AXM (MT7921AUN) — Utiliser (nécessite 23.05+)
# opkg install kmod-mt7921u

Étape 2 : Installation des outils de gestion sans fil

opkg install iw iwinfo wireless-tools hostapd-common wpa-supplicant

Étape 3 : Vérification de la création de l’interface réseau

iw dev
# Sortie prévue : wlan0 ou wlan1

Étape 4 : Scan des réseaux WiFi à proximité (validation des fonctionnalités)

iw dev wlan0 scan | grep -E "SSID|signal"

Étape 5 : Configuration en mode STA (se connecter à un AP existant)

Éditer /etc/config/wireless :

config wifi-device 'radio1'
       option type 'mac80211'
       option path 'platform/usb1/1-1/1-1:1.0'
       option channel 'auto'
       option htmode 'VHT80'

config wifi-iface 'wifinet2'
       option device 'radio1'
       option mode 'sta'
       option network 'wwan'
       option ssid 'Nom de ton WiFi'
       option encryption 'psk2'
       option key 'Mot de passe de ton WiFi'

Étape 6 : Redémarrage du service réseau

/etc/init.d/network restart

Étape 7 : Configuration en mode AP (partage de la connexion)

Éditer /etc/config/wireless, changez le mode en ap :

config wifi-iface 'wifinet2'
   option device 'radio1'
   option mode 'ap'
   option network 'lan'
   option ssid 'ALFA-OpenWrt-AP'
   option encryption 'psk2'
   option key 'Mot de passe de ton hotspot'

Étape 8 : Activation du mode écoute (pour les tests d’intrusion)

opkg install aircrack-ng
ip link set wlan0 down
iw dev wlan0 set type monitor
ip link set wlan0 up
iw dev wlan0 set channel 6
# Validation
iw dev wlan0 info
# type devrait afficher monitor

7.3 Chemin B : Modèles de puces Realtek (AWUS036ACH / ACS / EACS)
#

Par exemple, avec l’AWUS036ACH (RTL8812AU) :

Étape 1 : Installation des pilotes communautaires

opkg update
opkg install kmod-rtl8812au-ct

# AWUS036EACS (RTL8821CU) — Utiliser
# opkg install kmod-rtl8821cu

Étape 2 : Installation des outils de gestion sans fil

opkg install iw iwinfo wireless-tools hostapd-common wpa-supplicant

Étape 3 : Vérification de l’interface

iw dev
# Note : L'interface du pilote kmod-rtl8812au-ct peut être wlan0 ou wlan1

La configuration est la même que pour l’étape 7.2 (configuration en mode STA / AP).

Étape 4 : Mode écoute

# Le pilote kmod-rtl8812au-ct supporte le mode écoute
ip link set wlan0 down
iw dev wlan0 set type monitor
ip link set wlan0 up
# La fonctionnalité d'injection de paquets est limitée, il est recommandé d'utiliser des puces mt76 pour les tests d'intrusion

Étape 5 : Si vous rencontrez un crash du noyau (problème connu depuis la version 24.10)

# Retournez à la version stable 23.05, ou utilisez un pilote personnalisé compilé
# Vérifiez les journaux de crash
logread | grep -i "panic\|crash\|rtl8812"

7.4 Chemin C : Modèles Wi-Fi 6 (AWUS036AX / AXER, RTL8832BU)
#

⚠️ Ce chemin nécessite une compilation personnalisée d’OpenWrt, pas recommandé pour les utilisateurs ordinaires.

Étape 1 : Vérifiez si la version d’OpenWrt contient le support rtw89 USB

opkg list | grep rtw89
# Si vous ne voyez pas de résultat, cela signifie que la version n'inclut pas

Étape 2 : Si nécessaire, compilez l’image d’OpenWrt vous-même

Ajoutez kmod-rtw89 et le firmware correspondant.

Recommandation : Pour les besoins de cartes réseau USB Wi-Fi 6 sur un routeur OpenWrt, l’AWUS036AXML (MT7921AUN) est actuellement le meilleur choix.

8. Erreurs Courantes et Solutions
#

SymptômesCauses ProbablesSolutions
lsusb ne voit pas la carte réseau ALFACore USB non installé / Alimentation insuffisanteVérifiez si kmod-usb-core, kmod-usb2 et kmod-usb3 sont installés ; utilisez un Hub USB avec alimentation
lsusb voit la carte mais iw dev n’a pas d’interfacePilote non installé / Pilote incompatibleInstallez le paquet kmod approprié ; vérifiez dmesg pour des erreurs de firmware manquant
opkg install kmod-mt76x2u affiche « kernel version mismatch »Version OpenWrt et version de la bibliothèque de packages non compatiblesExécutez opkg update puis réessayez ; vérifiez que la version du noyau et l’architecture de la bibliothèque de packages sont compatibles
Échec du démarrage du mode AP (erreur hostapd)Pilote non compatible avec le mode AP / Configuration de canal incorrecteVérifiez si le chip prend en charge le mode AP ; essayez de fixer un canal (comme 6 ou 149) ; vérifiez le domaine réglementaire
Impossible d’injecter des paquets en mode surveillancePilote non compatible avec l’insertion de paquets / Conflit de canalLa série MediaTek mt76 est recommandée ; la fonction d’insertion de paquets sur Realtek 8812au-ct est limitée ; vérifiez airmon-ng check kill
AWUS036ACH se déconnecte lors de l’utilisation à haute puissanceAlimentation USB insuffisanteUtilisez un Hub USB avec alimentation ; dans /etc/config/wireless, réglez option txpower '20' pour réduire la puissance
Kernel panic après l’installation de rtl8812au-ct sur 24.10Problème de compatibilité connu du piloteRetournez à la version stable 23.05.x ; ou suivez les issues GitHub en attendant la correction
MT7921 (AXML/AXM) ne peut pas utiliser la bande 6GHzLimitation du domaine réglementaire / Version du kernelNécessite un kernel 5.19+ et la configuration correcte de la région réglementaire Wi-Fi 6E ; la prise en charge de la bande 6GHz dans OpenWrt 23.05 est encore en test

9. Limites connues
#

  • Le pilote de puce Realtek pour la maintenance de la communauté : kmod-rtl8812au-ct, kmod-rtl8821cu n’est pas maintenu par l’OpenWrt officiel, la stabilité et le calendrier des mises à jour ne peuvent pas être garanties
  • La version 24.10 de rtl8812au-ct a des rapports de crash du kernel : il est recommandé aux utilisateurs de puces Realtek de rester à 23.05.x
  • Le soutien à Wi-Fi 6 (RTL8832BU) est insuffisant : le pilote USB rtw89 est encore en développement, la plupart des versions OpenWrt ne peuvent pas utiliser directement AWUS036AX / AXER
  • La performance en mode AP est limitée : lorsque le WiFi USB fait office d’AP, la capacité de transmission est inférieure à celle du WiFi intégré au routeur (largeur de bande du port USB + overhead du pilote)
  • Les différences de fonctionnalités de surveillance / injection : la série MediaTek mt76 est la plus complète ; les fonctions d’injection des puces Realtek sont limitées, et ne sont pas adaptées aux tests de pénétration professionnels
  • Ressources matérielles du routeur : sur les routeurs de basse gamme (16MB Flash / 128MB RAM), l’installation du pilote peut entraîner un espace insuffisant, affectant d’autres fonctionnalités
  • Interférences de l’USB 3.0 : les appareils USB 3.0 peuvent interférer avec le WiFi 2.4GHz, il est recommandé d’utiliser un port USB 2.0 ou un Hub USB bien isolé
  • Utilisation simultanée de plusieurs cartes réseau : en utilisant simultanément le WiFi intégré au routeur et le WiFi USB, des conflits de canal ou des conflits de ressources peuvent survenir
  • ⚠️ Le mainteneur du pilote RTL8832BU (AWUS036AX/AXER) a recommandé publiquement d’éviter son utilisation : comme indiqué à la section 4.1, la mention «❌ Non recommandé» n’est pas seulement due au fait que rtw89 USB est encore en développement, mais aussi parce que le mainteneur morrownr a déclaré publiquement que cette série de puces est «très mauvais pilote, suspectant que la puce elle-même a des problèmes», recommandant aux utilisateurs Linux d’éviter cela pour le moment (voir la section 10 pour la source)
  • Il faut clarifier les termes de seuil de version du kernel : la mention dans la section 4.1 «MT7921AUN nécessite OpenWrt 23.05+ et kernel 5.15+» peut être trompeuse - le pilote mt7921u nécessite en réalité kernel 5.19+ sur Linux desktop (voir les propos du mainteneur du pilote), mais les kits officiels OpenWrt sont souvent pré-enregistrés via le mécanisme de backport, donc OpenWrt 23.05 (même s’il est marqué kernel 5.15) a toujours des utilisateurs qui signalent une installation réussie de kmod-mt7921u. Veuillez vous référer à la version du client opkg list pour une vérification réelle, et ne pas déduire la version du kernel.

Conditions de réfutation : si les mises à jour ultérieures du kit OpenWrt corrigent le problème de crash du kernel de rtl8812au-ct version 24.10, les recommandations pour AWUS036ACH dans les sections 4.1 et 6 peuvent être mise à jour de «maintenir 23.05»; si le soutien USB rtw89 est officiellement intégré dans le kit OpenWrt, la décision de ne pas recommander AWUS036AX / AXER doit être réexaminée; si une déclaration complète de soutien à la fréquence 6GHz pour MT7921 est publiée par l’officiel, la description des limitations pour AXML / AXM doit être mise à jour.

10. Sources de référence URL
#

SourceDescriptionURLÉtat de vérificationDate de vérification
Documentation officielle OpenWrtEntrée des documents officiels OpenWrt (réglage sans fil / gestion des paquets)https://openwrt.org/docs/start✅ Vérifié2026-09-03
Forum officiel OpenWrtEntrée de discussion sur les pilotes WiFi USBhttps://forum.openwrt.org/✅ Vérifié2026-09-03
morrownr/8812au GitHubPilote Linux RTL8812AU en amonthttps://github.com/morrownr/8812au-20210820✅ Vérifié2026-09-03
ALFA Network Catalogue de produits (Yopitek)Spécifications des produits actuels d’ALFA/fr/products/alfa/✅ Vérifié2026-09-03
morrownr/USB-WiFi Issue #314Déclaration officielle du mainteneur de pilotes : recommandation d’éviter les puces rtl8852/32au (RTL8832BU)https://github.com/morrownr/USB-WiFi/issues/314✅ Vérifié2026-09-03
morrownr/USB-WiFi Discussion #292mt7921u.ko nécessite le kernel 5.19+ pour apparaître dans le noyau (dites du mainteneur de pilotes)https://github.com/morrownr/USB-WiFi/discussions/292✅ Vérifié2026-09-03
Forum officiel OpenWrt — Meilleur dongle USB WiFi pour Raspberry Pi 4BRapports des utilisateurs sur l’installation réussie de kmod-mt7921u avec OpenWrt 23.05.0https://forum.openwrt.org/t/best-usb-wifi-dongle-for-raspberry-pi-4b/160103✅ Vérifié2026-09-03

Articles associés : Est-ce que la carte réseau sans fil ALFA est compatible avec DD-WRT | Est-ce que la carte réseau sans fil ALFA est compatible avec Tomato | Est-ce que la carte réseau sans fil ALFA est compatible avec NVIDIA DGX Spark | Est-ce que la carte réseau sans fil ALFA est compatible avec NVIDIA Jetson Nano

Déclaration d’exonération de responsabilité : La détermination de la compatibilité de cet article est basée sur la bibliothèque de paquets officielle OpenWrt 23.05.x / 24.10.x. La disponibilité des paquets peut varier en fonction des architectures de routeurs (ath79 / ramips / mvebu / x86, etc.). Les pilotes pour les puces Realtek sont maintenus par la communauté, et leur stabilité peut varier selon les versions. Il est recommandé de choisir les modèles de puces MediaTek (AWUS036ACM en premier) comme choix prioritaire pour le USB WiFi OpenWrt.