Armbian Minimal 镜像网络设置指南：systemd-networkd + Netplan

适用范围：Armbian minimal 镜像（Debian / Ubuntu 均适用），有线 / WiFi 无线连接均可
Backend：systemd-networkd（没有 NetworkManager，nmcli / nmtui 命令在此镜像上不可用）
配置方式：Netplan（Armbian 24.05 及以后版本统一使用）

---

1. 确认当前网络状态

ip addr                          # 查看接口名和当前 IP（无线一般是 wlan0 / wlx开头）
ls /etc/netplan/                 # 查看现有配置文件
cat /etc/netplan/*.yaml          # 查看配置内容
networkctl status                # networkd 专用状态查看
resolvectl status                # 查看 DNS 配置
iw dev                           # 确认无线接口是否被内核识别

---

2. 有线网络

2.1 DHCP（默认）

默认文件 /etc/netplan/10-dhcp-all-interfaces.yaml：

network:
  version: 2
  renderer: networkd
  ethernets:
    all-eth-interfaces:
      match:
        name: "e*"
      dhcp4: yes
      dhcp6: yes
      ipv6-privacy: yes

2.2 改为静态 IP

创建新文件前，先删除或改名默认的 DHCP 配置文件，避免规则冲突覆盖。

新建 /etc/netplan/20-eth-static.yaml：

network:
  version: 2
  renderer: networkd
  ethernets:
    eth0:                    # 换成实际接口名（用 ip addr 查）
      dhcp4: no
      addresses:
        - 192.168.1.199/24
      routes:
        - to: default
          via: 192.168.1.1
      nameservers:
        addresses:
          - 9.9.9.9
          - 1.1.1.1

---

3. WiFi 前置依赖

networkd 处理 WiFi 需要 wpa_supplicant，先确认已安装：

which wpa_supplicant || sudo apt install wpasupplicant -y

---

4. WiFi 配置（DHCP，自动获取 IP，推荐）

新建 /etc/netplan/30-wifi.yaml：

network:
  version: 2
  renderer: networkd
  wifis:
    wlan0:                   # 换成实际无线接口名，用 ip addr 或 iw dev 确认
      dhcp4: yes
      access-points:
        "你的SSID":
          password: "你的密码"

---

5. WiFi 配置（静态 IP）

如果不想用 DHCP，改成静态 IP：

network:
  version: 2
  renderer: networkd
  wifis:
    wlan0:
      dhcp4: no
      addresses:
        - 192.168.1.199/24
      routes:
        - to: default
          via: 192.168.1.1
      nameservers:
        addresses:
          - 9.9.9.9
          - 1.1.1.1
      access-points:
        "你的SSID":
          password: "你的密码"

---

6. 应用配置

sudo chmod 600 /etc/netplan/*.yaml   # 权限不对不会生效
sudo netplan generate                 # 检查语法
sudo netplan try                      # 试运行，120秒内不确认会自动回滚（远程操作强烈建议先用这个）
sudo netplan apply                    # 正式应用

⚠️ **远程 SSH 操作时优先用 netplan try**，避免配置出错导致远程连接直接断开、只能物理接屏幕救。

---

7. 断开重连 WiFi / 接口

networkd 没有 nmcli connection down/up 这种命令，对应操作是：

sudo networkctl reconfigure wlan0

或重启整个 networkd 服务：

sudo systemctl restart systemd-networkd

如果只是改了 SSID/密码，直接编辑 yaml 后 netplan apply 即可，不需要单独”断开”这一步。

---

8. WiFi 常见问题排查

• iw dev 看不到无线接口 → 内核驱动没识别到硬件，检查 dmesg | grep -i wlan 或 dmesg | grep -i firmware，多半是固件文件缺失或驱动不支持该芯片。
• 接口存在但连不上 → 确认 SSID/密码拼写、wpasupplicant 是否装了，然后看日志：

  journalctl -u systemd-networkd -f
  journalctl -u wpa_supplicant@wlan0 -f

• 能连上但没有 IP → 大概率是 DHCP 没拿到地址，检查路由器 DHCP 池是否够用，或换成静态 IP 配置排除干扰。
• 信号弱 / 频繁掉线 → networkd 本身不做信号强度展示，用 iw dev wlan0 link 看当前连接的信号质量（signal 值越接近 0 越好，一般 -70dBm 以内可用）。
• 改了配置没生效 → 检查文件权限（chmod 600）和文件名排序是否被别的 yaml 覆盖（ls /etc/netplan/ 按字典序确认加载顺序）。

---

9. 常用命令对照表（nmcli → networkd）

想干什么	networkd / netplan 命令
看设备状态	networkctl status 或 networkctl status wlan0
看某接口详情	networkctl status <接口名>
重新应用配置	sudo netplan apply
重连某接口	sudo networkctl reconfigure <接口名>
扫描 WiFi	iw dev wlan0 scan（networkd 本身不支持扫描）
看 DNS	resolvectl status

---

10. 常见坑

• 多个 .yaml 文件按文件名字典序加载，同名字段后加载的会覆盖前面的，新建静态 IP 配置时记得处理掉默认的 DHCP 文件。
• yaml 文件权限要求严格，权限不对（比如全局可读）会静默不生效或报警告，务必 chmod 600。
• WiFi 配置缺 wpasupplicant 包时，netplan apply 不会报错但连接建立不起来，排查时先确认这个依赖装了。
• 改错配置导致断网时，物理接屏幕/串口后可以直接编辑 yaml 文件修复，再 netplan apply。