Ubuntu Server 网络配置实战：Netplan 配置 WiFi 与静态 IP 详解

在 Ubuntu Server（特别是 18.04/20.04/22.04+ 版本）中，传统的 /etc/network/interfaces 配置文件已逐渐被 Netplan 取代。对于使用 USB 无线网卡或需要固定服务器 IP 的场景，掌握 Netplan 的配置至关重要。

本文将手把手教你如何通过命令行完成 WiFi 连接及静态 IP 设置，并深度解析配置文件中每一个参数的含义。

第一步：确认无线网卡名称

在开始之前，我们需要知道系统识别到的无线网卡接口名称。USB 网卡通常以 wlx 开头。

打开终端，输入以下命令：

ip link show

输出示例分析：

1: lo: <LOOPBACK,UP...>
2: enp1s0: <BROADCAST,MULTICAST...>  <-- 这是有线网卡
3: wlx485f082e470d: <BROADCAST,MULTICAST...> <-- 这就是我们的 USB 无线网卡

注意：请记下第 3 行的接口名称（例如 wlx485f082e470d），后续配置必须完全一致。

第二步：编辑 Netplan 配置文件

Ubuntu 的网络配置文件位于 /etc/netplan/ 目录下，通常是 .yaml 格式。

1. 打开编辑器

使用 nano 编辑器打开文件（文件名可能略有不同，常见为 01-network-manager-all.yaml 或 50-cloud-init.yaml）：

sudo nano /etc/netplan/01-network-manager-all.yaml

2. 写入配置代码

清空原有内容，根据你的需求选择以下两种配置之一。

方案 A：动态获取 IP (DHCP)

适用于普通上网，IP 地址由路由器自动分配。

network:
  version: 2
  renderer: networkd
  wifis:
    wlx485f082e470d:   # 替换为你的实际网卡名称
      dhcp4: true
      access-points:
        "Your_WiFi_Name":  # 替换为你的 WiFi 名称 (SSID)
          password: "Your_WiFi_Password" # 替换为你的 WiFi 密码

方案 B：配置静态 IP (Static IP)

适用于服务器环境，确保 IP 地址固定不变，方便远程管理。

network:
  version: 2
  renderer: networkd
  wifis:
    wlx485f082e470d:   # 替换为你的实际网卡名称
      dhcp4: no        # 关闭自动获取 IP
      addresses:
        - 192.168.1.200/24  # 你想要设置的固定 IP 和子网掩码
      routes:
        - to: default
          via: 192.168.1.1  # 你的路由器网关地址
      nameservers:
        addresses: [8.8.8.8, 114.114.114.114] # DNS 服务器地址
      access-points:
        "Your_WiFi_Name":
          password: "Your_WiFi_Password"

3. 保存并退出

按 Ctrl + O 然后回车保存。
按 Ctrl + X 退出编辑器。

第三步：应用配置

配置写好后，需要让 Netplan 重新生成后端配置并应用：

sudo netplan apply

如果没有报错，说明配置成功。你可以使用 ping baidu.com 测试网络是否通畅，或使用 ip addr show 查看 IP 是否已变更。

核心参数详解

理解每个参数的含义，能让你在排查故障时事半功倍。

1. 基础架构参数

version: 2
- 含义：指定 Netplan 配置文件的语法版本。目前 Ubuntu 主要使用 Version 2，Version 1 已被废弃。
renderer: networkd
- 含义：指定由哪个后端程序来管理网络。
- 选项：
  - networkd：即 systemd-networkd。Server 版（无图形界面）的标准选择，轻量高效。
  - NetworkManager：Desktop 版（有图形界面）的标准选择。
wifis:
- 含义：定义无线网络接口块。如果是有线网络，则使用 ethernets:。

2. 设备与连接参数

**wlx485f082e470d** (接口名称)
- 含义：具体的物理设备标识符。对于 USB 网卡，Ubuntu 倾向于使用基于 MAC 地址的可预测命名。这个名字必须和 ip link show 查出来的一模一样。
**access-points**
- 含义：定义要连接的 WiFi 热点列表。
**"Your_WiFi_Name"** (SSID)
- 细节：如果 WiFi 名称包含空格或特殊字符，必须加双引号。建议养成始终加引号的习惯。
**password**
- 含义：WiFi 的预共享密钥（PSK）。

3. IP 地址配置参数 (重点)

**dhcp4: true / no**
- true：开启 IPv4 动态主机配置协议，自动从路由器获取 IP。
- no：关闭自动获取，准备手动指定 IP。
**addresses** (静态 IP 专用)
- 格式：[IP地址/子网掩码位数]
- 解释：例如 192.168.1.200/24。这里的 /24 等同于子网掩码 255.255.255.0。
**routes** (静态 IP 专用)
- 含义：定义路由规则。
- 解释：to: default 表示默认路由（即所有不知道去哪的数据包都走这里），via: 192.168.1.1 指定下一跳网关（通常是路由器地址）。如果不配这个，你只能连局域网，上不了互联网。
**nameservers** (静态 IP 专用)
- 含义：DNS 域名解析服务器。
- 解释：如果不配这个，你能 ping 通 IP 地址（如 8.8.8.8），但无法解析域名（如 www.baidu.com）。推荐使用 8.8.8.8 (Google) 或 114.114.114.114 (国内通用)。

避坑指南

缩进是灵魂：YAML 对缩进非常敏感。层级关系必须通过空格体现（通常每级 2 个空格），严禁使用 Tab 键，否则会导致解析失败。
服务未启动：如果执行 netplan apply 报错提示 systemd-networkd is not running，请先手动启动服务：
驱动问题：如果 ip link show 根本看不到 wlx... 设备，说明无线网卡的驱动程序没装好，这时候配置网络是没用的，需要先解决驱动问题。