openEuler2403 安装UKUI桌面并配置 Intel AX210 无线驱动

已为您整理为一份结构化文档，请复制以下内容保存为 .md 或 .txt 文件。

 


 1. 安装桌面环境和 VNC 服务
# 安装 UKUI 桌面
sudo dnf install ukui -y

# 安装 TigerVNC 服务端
sudo dnf install tigervnc-server -y

2. 配置 VNC 启动脚本（解决黑屏问题）

用普通用户登录后执行以下操作：

bash

# 备份原文件
mv ~/.vnc/xstartup ~/.vnc/xstartup.bak

# 创建新的 xstartup 文件v
i ~/.vnc/xstartup

写入以下内容：

#!/bin/sh

#unset SESSION_MANAGER
#unset DBUS_SESSION_BUS_ADDRESS

# Assume either Gnome will be started by default when installed
# We want to kill the session automatically in this case when user logs out. In case you modify
# /etc/X11/xinit/Xclients or ~/.Xclients yourself to achieve a different result, then you should
# be responsible to modify below code to avoid that your session will be automatically killed
#if [ -e /usr/bin/gnome-session ]; then
#    vncserver -kill $DISPLAY
#fi

# 1. 清除冲突的环境变量
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS

/etc/X11/xinit/xinitrc

# 2. 设置 UKUI 所必需的环境变量
export XDG_RUNTIME_DIR=/tmp/runtime-$USER
export XDG_CURRENT_DESKTOP=UKUI

# 3. 启动 D-Bus 会话
if [ -z "$DBUS_SESSION_BUS_ADDRESS" ]; then
    eval $(dbus-launch --sh-syntax)
    export DBUS_SESSION_BUS_ADDRESS
fi

# 4. 设置美观的灰蓝色背景
#xsetroot -solid "#5A6E7A"

# 5. 启动 UKUI 桌面环境
exec ukui-session

赋予执行权限：

chmod +x ~/.vnc/xstartup

3. 启动 VNC 服务

# 先停止可能运行的会话
vncserver -kill :1


# 启动新会话（分辨率 1920x1080，24位色深）
vncserver :1 -geometry 1920x1080 -depth 24

4. 防火墙放行端口

sudo firewall-cmd --add-port=5901/tcp --permanent

sudo firewall-cmd --reload

使用 VNC 客户端连接 服务器IP:1 即可看到 UKUI 桌面。

二、Intel AX210 无线网卡驱动安装

1. 确认硬件和内核

bash

# 检查网卡是否被识别
lspci | grep -i network | grep AX210


# 确认内核版本（应为 6.x）

uname -r

2. 安装基础固件包

bash

sudo dnf updates

sudo dnf install linux-iwlwifi-firmware

注意：安装后可能仍缺少最新版本的 .ucode 文件，需手动下载补充。 openEuler系统中的软件包是： linux-firmware-iwlwifi

3. 检查错误并手动下载固件

查看内核日志：

dmesg | grep iwlwifi

常见错误示例：

• Direct firmware load for iwlwifi-ty-a0-gf-a0-XX.ucode failed

• PNVM data is missing, please install iwlwifi-ty-a0-gf-a0.pnvm

根据日志提示的版本范围（最小59，最大83），下载所需固件：

# 下载 PNVM 文件
wget  

# 下载缺失的 .ucode 文件（以 59 和 83 为例）
wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/intel/iwlwifi/iwlwifi-ty-a0-gf-a0-59.ucode
wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/intel/iwlwifi/iwlwifi-ty-a0-gf-a0-83.ucode


# 复制到固件目录
sudo cp -a  iwlwifi-ty-a0-gf-a0* /usr/lib/firmware/intel/iwlwifi/

4. 彻底卸载并重新加载驱动模块

# 按依赖顺序卸载模块
sudo modprobe -r iwlmvm
sudo modprobe -r iwlmei
sudo modprobe -r iwlwifi

# 确认卸载干净（无输出则正常）
lsmod | grep iwl


# 重新加载驱动
sudo modprobe iwlwifi

5. 验证 WiFi 是否正常

bash

# 查看日志确认固件加载成功
dmesg | grep iwlwifi | tail -20


# 检查无线网卡接口（如 wlp5s0）

ip a show

成功日志应包含类似：

iwlwifi 0000:05:00.0: loaded firmware version 83...iwlwifi 0000:05:00.0: Detected Intel(R) Wi-Fi 6 AX210...

三、附录：蓝牙驱动

Intel AX210 的蓝牙部分通常使用内核自带的 btintel 驱动，若无法工作，可尝试：

sudo dnf install bluez bluez-obexd
sudo systemctl enable --now bluetooth

并检查是否需要下载对应的蓝牙固件文件（可参考 WiFi 固件手动下载流程）。

从你最新的日志可以发现，问题的核心是 NetworkManager 在扫描 Wi‑Fi 前尝试修改 MAC 地址，触发固件命令 MAC_CONFIG_CMD 失败，错误码 -5，导致网卡无法正常工作。

platform-linux: do-change-link[7]: failure 5 (Input/output error)
iwlwifi 0000:05:00.0: Failed to send MAC_CONFIG_CMD (action:1): -5

你的驱动和固件之间通信正常，但固件拒绝了 NM 发送的 MAC 地址更改请求。这在某些版本的 iwlwifi 固件或驱动中是一个已知兼容性问题。

 立即解决：禁用随机 MAC 地址

方法一：针对你当前的 Wi‑Fi 连接配置

# 查看你的连接名（应该是 YuPan）

nmcli connection show

# 修改 YuPan 连接，禁止使用随机 MAC 地址

nmcli connection modify YuPan wifi.cloned-mac-address permanent

然后重新连接：

nmcli connection up YuPan

方法二：全局禁用扫描时随机 MAC（若方法一无效）

创建 NetworkManager 配置文件：

sudo tee /etc/NetworkManager/conf.d/99-disable-random-mac.conf << EOF 
[connection]
wifi.cloned-mac-address=permanent
[device]
wifi.scan-rand-mac-address=no
EOF


sudo systemctl restart NetworkManager

之后再次尝试连接 Wi‑Fi，扫描和激活应该能顺利完成。

 如果问题依旧，再执行底层重置

有时固件的错误状态需要重新加载模块才能清除：

sudo modprobe -r iwlmvm iwlwifi

sudo modprobe iwlwifi

sudo modprobe iwlmvm

然后再次尝试连接（确保已按上面方法禁用随机 MAC）。

为什么会出现这个问题？

• NetworkManager 默认会在扫描和连接时使用随机 MAC 地址以保护隐私，这个特性叫做 scan-rand-mac-address。

• Intel AX210 的固件在某些版本中对动态更改 MAC 地址的命令支持不完善，导致返回 I/O 错误。

• 你的内核 (7.0.11) 非常新，可能 iwlwifi 驱动期望的 MAC 配置功能与当前固件不完全匹配，而禁用该特性即可规避。

预期结果

设置永久 MAC 后，wlp5s0 的扫描和连接将不再触发 MAC_CONFIG_CMD，网卡会直接使用硬件原始 MAC 地址工作，-5 和 -100 错误也会消失。

现在请按步骤操作，然后观察 dmesg | grep iwlwifi 和 nmcli device wifi list 是否恢复正常。如果还有困难，随时告诉我。