1. 為什么RTL8812BU在Ubuntu上總是不省心手里有一塊瑞昱RTL8812BU方案的USB無線網(wǎng)卡插上Ubuntu之后發(fā)現(xiàn)系統(tǒng)壓根不認lsusb能看到設(shè)備但ip link里就是沒有對應(yīng)的無線接口——這個場景我遇到過太多次了。RTL8812BU是一顆雙頻AC 1200級別的USB 3.0無線芯片市面上大量USB網(wǎng)卡、天線延長底座、甚至一些迷你主機內(nèi)置模塊都在用它。性能不錯價格便宜但Linux下的驅(qū)動支持一直是個老大難問題內(nèi)核主線里沒有它的原生驅(qū)動Ubuntu自帶的rtl8xxxu只能勉強識別部分老型號對8812BU的支持非常有限經(jīng)常出現(xiàn)能識別但連不上、或者連上后速率只有幾十兆的情況。這篇文章要解決的問題很具體在Ubuntu系統(tǒng)下讓RTL8812BU網(wǎng)卡正常工作并且把編譯驅(qū)動過程中那些讓人抓狂的坑一次性講清楚。適合誰看手里有這類網(wǎng)卡、剛裝完Ubuntu發(fā)現(xiàn)沒WiFi、或者之前編譯失敗過想搞清楚原因的讀者。我會從驅(qū)動方案選型開始一步步走到編譯、加載、驗證中間穿插大量實際踩坑經(jīng)驗保證你跟著做能跑通。先說一個基本判斷RTL8812BU在Linux下的驅(qū)動目前最靠譜的方案是使用社區(qū)維護的rtl8812au驅(qū)動分支注意不是8812au原版而是專門適配8812BU的aircrack-ng維護版本或者morrownr維護的版本。為什么不用Ubuntu自帶的因為自帶驅(qū)動對8812BU的芯片ID覆蓋不全而且缺少完整的802.11ac支持。自己編譯雖然麻煩但可控性最強出了問題也能自己排查。2. 驅(qū)動方案選型與準備工作2.1 三種驅(qū)動來源的對比在動手之前先搞清楚你有哪些選擇以及各自的優(yōu)缺點。我整理了一個對比表方便你根據(jù)自己情況決定方案來源優(yōu)點缺點適用場景內(nèi)核自帶rtl8xxxuUbuntu內(nèi)核免安裝插上就有對8812BU支持差速率低經(jīng)常斷流臨時應(yīng)急官方rtl8812au驅(qū)動Realtek官網(wǎng)功能完整老對新內(nèi)核兼容差編譯報錯多不推薦社區(qū)維護rtl8812au分支GitHub morrownr/rtl8812au-20210820持續(xù)更新支持新內(nèi)核8812BU適配好需要自己編譯推薦我實測下來morrownr維護的那個分支是目前最省心的。它把8812BU、8811CU、8821CU等一堆RTL88xxBU系列芯片的ID都合并進去了而且針對5.x和6.x內(nèi)核做了大量適配。另一個aircrack-ng版本也可以但那個更偏向滲透測試場景會打監(jiān)控模式補丁日常使用反而可能引入不穩(wěn)定因素。2.2 編譯前必須確認的三件事很多人編譯失敗不是驅(qū)動本身的問題而是環(huán)境沒準備好。動手之前先確認這三項第一確認你的內(nèi)核版本。運行uname -r記下輸出。比如6.5.0-35-generic。這個信息決定了你后面要不要額外打內(nèi)核兼容補丁。5.15以上的內(nèi)核DKMS方式基本都能自動處理但如果你用的是6.8以上的新內(nèi)核有些老驅(qū)動分支會報implicit-function-declaration錯誤需要手動改代碼。第二確認你已經(jīng)裝了編譯工具鏈。最小依賴是build-essential、git、dkms以及當前內(nèi)核對應(yīng)的頭文件linux-headers-$(uname -r)。缺頭文件是最常見的失敗原因報錯通常是/lib/modules/xxx/build: No such file or directory。一條命令補齊sudo apt update sudo apt install -y build-essential git dkms linux-headers-$(uname -r)第三確認Secure Boot狀態(tài)。如果你的主板開了Secure Boot編譯出來的第三方內(nèi)核模塊默認會被拒絕加載modprobe會報Operation not permitted。要么進BIOS關(guān)掉Secure Boot要么給模塊簽名。我一般建議直接關(guān)掉省事。檢查命令mokutil --sb-state輸出SecureBoot disabled就沒事如果是enabled要么關(guān)要么走簽名流程。提示如果你是在虛擬機里操作USB網(wǎng)卡需要先通過虛擬機軟件把設(shè)備直通給Ubuntu否則lsusb根本看不到。VMware在“虛擬機設(shè)置-USB控制器”里勾選對應(yīng)設(shè)備VirtualBox在“設(shè)備-USB”里掛載。2.3 確認網(wǎng)卡芯片ID不是所有標著“AC1200”的網(wǎng)卡都是8812BU有些是8811CU或者8821CU。插上網(wǎng)卡運行l(wèi)susb | grep -i realtek你會看到類似ID 0bda:b812 Realtek Semiconductor Corp.的輸出。b812就是8812BU的典型PID。常見的對應(yīng)關(guān)系b812是8812BUc811是8811CUb82c是8821CU。記下你的ID后面驗證驅(qū)動是否匹配時要用。3. 編譯實操從克隆到加載的完整流程3.1 獲取驅(qū)動源碼我推薦用morrownr的倉庫直接克隆cd /usr/src sudo git clone https://github.com/morrownr/rtl8812au-20210820.git為什么放在/usr/src因為DKMS默認會去這個目錄找源碼放這里后面注冊DKMS最順?？寺⊥瓿珊筮M去看一眼目錄結(jié)構(gòu)確認有dkms-install.sh這個腳本有就說明是支持DKMS的版本。如果你網(wǎng)絡(luò)環(huán)境拉GitHub慢也可以先在其他機器下載zip包再傳過去解壓到/usr/src下同樣可以。3.2 用DKMS方式安裝推薦DKMS的好處是內(nèi)核升級后驅(qū)動會自動重新編譯不用你每次手動折騰。這是我最推薦的方式。進入源碼目錄直接跑安裝腳本cd /usr/src/rtl8812au-20210820 sudo ./dkms-install.sh這個腳本背后做的事把源碼注冊到DKMS、編譯、安裝模塊、加載。整個過程大概一到兩分鐘。如果一切順利你會看到Module installed successfully之類的提示。但現(xiàn)實往往沒那么順。下面是我遇到過的幾個典型報錯和解決辦法。3.3 編譯報錯排查三個高頻坑坑一error: implicit declaration of function cfg80211_...這個錯誤通常出現(xiàn)在內(nèi)核6.5以上。原因是新內(nèi)核改了cfg80211子系統(tǒng)的函數(shù)簽名老驅(qū)動沒跟上。解決辦法是打補丁。morrownr的倉庫其實已經(jīng)處理了大部分但如果你用的是更老的fork就需要手動改。具體做法是找到報錯的文件和行號對照新內(nèi)核的頭文件改參數(shù)。比如cfg80211_roamed在新內(nèi)核里參數(shù)變了需要把調(diào)用處改成新簽名。坑二error: ‘struct timer_list’ has no member named ‘data’內(nèi)核5.15之后timer_list結(jié)構(gòu)體去掉了data成員改用from_timer宏。這個錯誤在8812au驅(qū)動里很常見。修改方法把原來的timer.data相關(guān)代碼替換成from_timer方式。具體代碼改動比較細建議直接換用已經(jīng)適配好的分支比如morrownr的20210820版本就已經(jīng)修好了?？尤齧odprobe: ERROR: could not insert 88XXau: Required key not available這就是Secure Boot在作祟。兩個選擇關(guān)Secure Boot或者簽名。簽名流程稍微麻煩需要生成密鑰、導入MOK、簽名模塊這里不展開。最直接的辦法是重啟進BIOS關(guān)掉Secure Boot。注意如果你之前用apt裝過rtl8812au-dkms這個包先卸載掉否則會和手動編譯的版本沖突。命令sudo apt remove rtl8812au-dkms。3.4 手動編譯方式DKMS失敗時的備選如果DKMS腳本跑不通可以手動編譯。流程是cd /usr/src/rtl8812au-20210820 sudo make clean sudo make sudo make install sudo modprobe 88XXaumake這一步如果報錯仔細看錯誤信息基本都是內(nèi)核兼容問題。手動編譯的好處是錯誤信息更直接方便定位。缺點是內(nèi)核升級后要重新來一遍。3.5 驗證驅(qū)動是否加載成功加載之后用這幾條命令驗證lsmod | grep 88XXau ip link show iw devlsmod能看到88XXau說明模塊加載了。ip link里應(yīng)該多出一個wlanX接口。iw dev能看到接口的詳細信息包括支持的頻段和模式。如果ip link里沒有新接口但lsmod有模塊那可能是芯片ID沒匹配上需要檢查驅(qū)動的ID表里有沒有你的PID。我遇到過一種情況模塊加載了但接口名是wlan0卻顯示DOWN狀態(tài)。這時候運行sudo ip link set wlan0 up如果報Operation not permitted多半是rfkill軟阻塞用rfkill list查看rfkill unblock wifi解鎖。4. 常見問題與排查技巧實錄4.1 網(wǎng)卡識別了但搜不到WiFi這是最典型的問題。iw dev能看到接口但nmcli dev wifi list空空如也。原因通常有三個一是驅(qū)動雖然加載了但固件沒加載成功二是信道被管制域限制三是接口被rfkill阻塞。排查順序先dmesg | grep -i 88XXau看內(nèi)核日志有沒有firmware相關(guān)的報錯。8812BU需要rtl8812bu_fw.bin這個固件文件通常在/lib/firmware/rtlwifi/下。如果沒有從驅(qū)動源碼的firmware目錄復制過去。然后檢查rfkill list確認沒有軟阻塞。最后看管制域iw reg get如果顯示country 00說明沒設(shè)置用sudo iw reg set CN設(shè)置一下。4.2 連接后速率只有幾十兆8812BU是AC1200理論速率867Mbps5G頻段。如果你連上后iw dev wlan0 link顯示速率只有54Mbps或者更低大概率是連到了2.4G頻段或者驅(qū)動協(xié)商有問題。先確認連的是5G AP然后檢查iw dev wlan0 link里的bitrate字段。如果5G下還是低速率可能是驅(qū)動版本太老換最新分支重新編譯。另一個隱藏原因是USB接口速率。8812BU需要USB 3.0才能跑滿如果你插在USB 2.0口上上限就是480Mbps實際吞吐也就200Mbps左右。檢查方法lsusb -t看設(shè)備掛在哪個總線上5000M才是USB 3.0。4.3 內(nèi)核升級后驅(qū)動失效這是DKMS方式也會遇到的問題新內(nèi)核的頭文件還沒裝DKMS自動編譯失敗。解決辦法很簡單升級內(nèi)核后先裝頭文件sudo apt install linux-headers-$(uname -r) sudo dkms autoinstalldkms autoinstall會重新編譯所有注冊過的模塊。如果還是失敗dkms status看具體哪個模塊報錯進源碼目錄手動make一次看詳細錯誤。4.4 常見問題速查表現(xiàn)象可能原因解決命令/操作lsusb有設(shè)備但無wlan接口驅(qū)動未加載或ID不匹配檢查lsmod確認驅(qū)動ID表含你的PID模塊加載報Required key not availableSecure Boot開啟關(guān)閉Secure Boot或簽名模塊接口存在但搜不到WiFi固件缺失或rfkill阻塞復制固件rfkill unblock wifi速率低USB 2.0或連了2.4G換USB 3.0口確認5G連接內(nèi)核升級后失效頭文件未裝裝headers后dkms autoinstall編譯報timer_list錯誤內(nèi)核5.15不兼容換用已適配分支4.5 幾個我踩過的坑第一個坑不要同時裝多個版本的8812au驅(qū)動。我有一次先apt裝了rtl8812au-dkms又手動編譯了一個結(jié)果兩個模塊搶設(shè)備時好時壞。后來全部卸載只留一個手動編譯的才穩(wěn)定。第二個坑make install之后忘了depmod。有些老教程只寫make install但沒寫depmod -a導致模塊依賴關(guān)系沒更新modprobe找不到模塊。加上sudo depmod -a再modprobe就好了。第三個坑虛擬機里USB直通后如果虛擬機重啟USB設(shè)備可能沒自動掛載回去需要重新在虛擬機設(shè)置里勾選。這個不是驅(qū)動問題但很容易誤判。5. 長期維護與自動化建議5.1 用DKMS實現(xiàn)內(nèi)核升級自動重編前面已經(jīng)用了DKMS這里再強調(diào)一下它的價值。DKMS會在/var/lib/dkms/下維護模塊狀態(tài)每次內(nèi)核更新dkms autoinstall會自動觸發(fā)重編。你唯一要保證的是新內(nèi)核的頭文件已經(jīng)安裝?？梢詫懸粋€簡單的apt鉤子讓內(nèi)核升級時自動裝頭文件但更簡單的做法是養(yǎng)成習慣每次apt upgrade看到內(nèi)核更新手動跑一次sudo apt install linux-headers-$(uname -r) sudo dkms autoinstall。5.2 備份可用驅(qū)動版本社區(qū)驅(qū)動更新頻繁有時候新版本反而引入回歸。我的做法是當前穩(wěn)定可用的版本把整個源碼目錄打包備份一份。命令sudo tar czf rtl8812au-stable.tar.gz /usr/src/rtl8812au-20210820下次如果更新后出問題解壓回去重新dkms-install.sh就能回滾。這個習慣幫我省過好幾次重裝系統(tǒng)的時間。5.3 監(jiān)控驅(qū)動狀態(tài)的小腳本我寫了一個簡單的檢查腳本放在~/check_wifi.sh每次覺得網(wǎng)絡(luò)不對勁就跑一下#!/bin/bash echo USB設(shè)備 lsusb | grep -i realtek echo 模塊狀態(tài) lsmod | grep 88XXau echo 接口狀態(tài) ip link show | grep wlan echo 連接信息 iw dev 2/dev/null | grep -E Interface|ssid|channel echo rfkill rfkill list這個腳本能快速定位問題出在哪一層是USB沒識別、模塊沒加載、還是接口沒起來。比一條條敲命令快得多。5.4 關(guān)于替代方案的思考如果你實在不想折騰編譯還有一個選擇換一塊內(nèi)核原生支持的網(wǎng)卡。比如基于MT7921或者AX210的網(wǎng)卡Linux內(nèi)核直接支持插上就能用。但如果你手頭已經(jīng)有8812BU或者需要它的特定功能比如外置天線、監(jiān)控模式那編譯驅(qū)動還是值得的。我自己的主力機上就是8812BU編譯一次之后用DKMS維護一年多沒出過問題。最后分享一個判斷驅(qū)動是否真正穩(wěn)定的方法連續(xù)跑iperf3打流半小時同時ping網(wǎng)關(guān)看延遲抖動。如果速率穩(wěn)定、延遲沒有周期性尖峰說明驅(qū)動和固件配合良好。如果每隔幾秒就卡一下多半是電源管理在搗亂可以在/etc/modprobe.d/下加一個配置文件禁用USB自動掛起echo options 88XXau rtw_power_mgnt0 rtw_enusbss0 | sudo tee /etc/modprobe.d/88XXau.conf然后重新加載模塊。這個參數(shù)關(guān)掉了驅(qū)動的省電模式對穩(wěn)定性提升很明顯代價是待機功耗略高臺式機無所謂筆記本自己權(quán)衡。