1. 先把配网这件事拆开看Ubuntu 配网这个词外行看着像插上网线就完事实际上手过的人都知道它至少包含四层意思物理链路能不能通、网卡有没有被系统接管、IP 怎么拿到、DNS 和路由怎么走。我见过太多人卡在第三步却一直在第一步折腾网线也见过不少人把 DNS 写错了然后花一晚上怀疑是不是系统装了假的。这篇文章就是把这四层从头到尾捋一遍把桌面版、服务器版、虚拟机、开发板这几类常见场景都覆盖到你手上不管是刚装完的 Ubuntu 22.04 还是 24.04 LTS都能照着往下走。先明确一下适合谁看。第一种是刚把 Ubuntu 装进 VMware 或者 VirtualBox发现 ping 不通外网、SSH 连不上的新手第二种是在服务器上要配静态 IP、双网卡、多路由的运维同学第三种是拿开发板、WSL 当日常开发环境需要让系统稳定跑起 Docker、GCC、CMake 这类工具链的人。这三类人关注的点其实不太一样新手最需要的是先确认链路是不是活的老手最在意的是配置怎么写才不会被系统自己改回去。下面我会把这两种需求分开讲。在动手之前先给一个基本认知Ubuntu 的网络配置这几年变化挺大的。早期是/etc/network/interfaces一家独大后来 NetworkManager 接管桌面再后来 Netplan 变成了统一的抽象层服务器版由它生成 systemd-networkd 的配置。所以你从网上抄到的一份 2016 年的教程大概率在 24.04 上是跑不通的不是教程错了是这套东西已经被换过一轮了。搞清楚当前这套系统用哪一层在管网络比记住某个具体命令重要得多。1.1 三套网络管理工具别让它们打架Ubuntu 里同时存在好几个能改网络的东西它们的关系不是哪个更好用而是谁在管这块网卡。搞混了就会出现我改了配置怎么不生效这种情况。工具配置文件位置常见于特点Netplan/etc/netplan/*.yaml17.10 之后所有版本只是个翻译层自己不实现网络把 YAML 翻译给后端systemd-networkd/etc/systemd/network/Server 版默认后端轻量、无 GUI、适合服务器和容器NetworkManager/etc/NetworkManager/Desktop 版默认后端有 GUI 和 nmcli能管 WiFi、蓝牙共享等ifupdown/etc/network/interfaces老版本现在要手动装不建议新系统用关键点在于 Netplan 的renderer字段写networkd就交给 systemd-networkd写NetworkManager就交给 NetworkManager。桌面版默认的/etc/netplan/01-network-manager-all.yaml里写的就是 NetworkManager所以你在桌面上用图形界面点一下就能生效服务器版默认是 networkd必须改 YAML。注意同一块网卡不要被两套工具同时声明。我踩过的坑是在桌面版服务器上装了 networkd 的配置结果 NetworkManager 把网卡标成 unmanaged两边都不干活网卡亮着灯但就是没 IP。1.2 上手第一件事确认网卡到底叫什么这一步看起来废话实际能省掉后面一大半时间。Ubuntu 从 16.04 开始默认用可预测网卡名eth0变成了ens33、enp3s0、eno1这类名字虚拟机里常见的是ens33或ens160无线网卡是wlp2s0这种格式。命名规则大概是en开头是有线wl开头是无线后面跟的是 PCI 总线位置。ip -br link show # 简洁列出所有网卡和状态 ip -br addr show # 额外显示 IP lspci -k | grep -A 3 -i net # 看网卡的 PCI 信息和正在用的驱动 lshw -C network # 更详细的硬件信息需要 sudoip -br link的输出里如果状态是DOWN说明链路层没起来可能是网线没插好、虚拟机网络适配器没连上、或者驱动没加载。如果是UP但没有 IP那就是配置层面的问题了往后看第三节。USB 网卡的话用lsusb看有没有被识别插上后dmesg | tail -20一般能看到内核给它分配的名字。1.3 四种场景先想清楚你要哪一种很多人配网配得痛苦是因为一开始没想清楚自己到底要什么。实际上无非四种情况动态 IPDHCP路由器给什么用什么适合家用、临时虚拟机、随手测试。静态 IP自己指定地址适合服务器、需要被别人稳定访问的机器、开发板。双网卡分工一块对内一块对外或者一块跑管理流量一块跑业务流量。无线连接笔记本、树莓派这类没有网口的设备。选错了场景后面所有命令都白搭。比如你在家里用桥接模式给虚拟机配了个静态 IP结果路由器 DHCP 池和这个地址撞了就会出现时通时不通的玄学问题。判断标准很简单这台机器需不需要被局域网里其他设备主动访问需要就静态不需要就 DHCP。2. 桌面版 Ubuntu 配网实操桌面版是最省心的因为 NetworkManager 给了图形界面和 nmcli 两套入口改完立刻生效不用重启网络服务。但省心不代表没坑尤其是当你从图形界面切到命令行的时候容易把已有的连接配置搞乱。2.1 图形界面配置三分钟搞定的标准流程点右上角网络图标进设置找到网络这一栏。有线连接下会显示当前的连接名比如有线连接 1点齿轮图标进入详情页切到 IPv4 标签页。这里有四个选项自动 (DHCP)默认路由器分配。手动静态 IP下面填写地址、子网掩码、网关。仅本地链接只做二层通信不配 IP。共享到其他计算机把本机当网关给别的设备做网络共享。选手动之后地址格式要写成192.168.1.50/24这种带掩码位数的形式只写 IP 不写/24会报错。DNS 那一栏要手动填比如223.5.5.5,119.29.29.29逗号分隔。填完点应用图标上的小问号消失就说明通了。注意图形界面里如果不小心把自动关掉了却没填网关会出现能 ping 通同网段设备但上不了网的经典症状本质是缺默认路由。这个时候别急着怀疑 DNS先ip route看一眼有没有default via。2.2 nmcli真正好用的其实是命令行图形界面适合一次性配置但要批量改、脚本化改、远程改还是 nmcli 靠谱。它的逻辑是连接connection和设备device分开管理一个设备上可以挂多个连接配置按优先级自动切换。这个设计刚接触会觉得绕习惯了就知道很方便比如笔记本换到不同办公室可以预存多套 WiFi 配置。先看现状nmcli device status # 设备和当前连接状态 nmcli connection show # 所有连接配置 nmcli connection show 有线连接 1 # 看某个配置的所有细节配一个静态 IP 的完整流程# 1. 先改配置此时不生效 sudo nmcli connection modify 有线连接 1 \ ipv4.method manual \ ipv4.addresses 192.168.1.50/24 \ ipv4.gateway 192.168.1.1 \ ipv4.dns 223.5.5.5 119.29.29.29 # 2. 再重新激活让它生效 sudo nmcli connection up 有线连接 1 # 3. 验证 ip -br addr show ip route注意这里ipv4.dns的值是空格分隔的字符串写在引号里而ipv4.addresses在较新版本里支持逗号分隔多个地址。nmcli connection modify是改配置文件不会立即生效必须up一次这个改和生效分离的机制经常把人绕进去。如果想退回去用 DHCPsudo nmcli connection modify 有线连接 1 ipv4.method auto ipv4.gateway ipv4.addresses ipv4.dns sudo nmcli connection up 有线连接 1这里把其他字段清空是好习惯。NetworkManager 在method auto时会忽略静态字段但有些版本会在两个配置之间反复横跳清干净最稳。# 新建一个连接配置不动原来的 sudo nmcli connection add type ethernet con-name static-ens33 ifname ens33 \ ipv4.method manual \ ipv4.addresses 192.168.1.60/24 \ ipv4.gateway 192.168.1.1 \ ipv4.dns 223.5.5.5 # 删除某个连接配置 sudo nmcli connection delete static-ens332.3 WiFi 连接与射频开关那些事无线网卡的问题比有线多一层射频开关。rfkill list能看到每个无线设备的软阻塞software blocked和硬阻塞hard blocked。硬阻塞一般是笔记本上的物理开关或者 Fn 组合键软阻塞可以用rfkill unblock wifi解除。rfkill list nmcli device wifi list # 扫描周边 WiFi sudo nmcli device wifi connect SSID名称 password 密码 nmcli connection show --active笔记本上有个很常见的坑有线连上后 WiFi 会自动断开这是 NetworkManager 的单连接策略在起作用。要两个都留着得把连接配置的connection.autoconnect-priority和connection.secondary改一下把 WiFi 设成ipv4.may-fail yes的辅助连接。这个配置在写多网卡分流脚本时很有用但普通人一般遇不到。2.4 DNS 缓存和 resolv.conf 的真实关系Ubuntu 18.04 以后用 systemd-resolved 做 DNS 缓存和转发/etc/resolv.conf实际上是一个软链接指向/run/systemd/resolve/stub-resolv.conf里面只写了一个127.0.0.53真正的 DNS 服务器地址在别处。很多人vi /etc/resolv.conf改了半天发现重启就丢原因就在这里。ls -l /etc/resolv.conf # 看它指向哪里 resolvectl status # 看每块网卡实际用的 DNS resolvectl query example.com # 用 systemd-resolved 查一次如果确实需要手写 resolv.conf比如某些容器环境先把它从软链接改成真实文件sudo rm /etc/resolv.conf sudo tee /etc/resolv.conf EOF nameserver 223.5.5.5 nameserver 119.29.29.29 EOF注意这么做会绕过 systemd-resolved 的缓存长期看反而更容易出问题。我的建议是优先在 NetworkManager 或 Netplan 里配 DNS让系统自己维护 resolv.conf不要直接改文件。3. 服务器版 Ubuntu 配网Netplan 是主角Server 版没有图形界面默认用 Netplan 加 systemd-networkd。配置文件放在/etc/netplan/下文件名一般长这样00-installer-config.yaml手动装的、50-cloud-init.yaml云主机自动生成的、01-netcfg.yaml老一点的版本。多个文件会按文件名排序合并后面的覆盖前面的所以改配置的时候先ls一下别只看一个文件就下手。3.1 一份能直接用的静态 IP 配置YAML 的缩进是硬要求必须用空格不能用 Tab缩进错了netplan apply会直接报错。下面这份是我在 22.04 和 24.04 上都在用的模板network: version: 2 renderer: networkd ethernets: ens33: dhcp4: false dhcp6: false addresses: - 192.168.1.50/24 routes: - to: default via: 192.168.1.1 nameservers: addresses: [223.5.5.5, 119.29.29.29] search: [local]24.04 之前的教程里常见gateway4: 192.168.1.1这种写法从 22.04 开始它被标记为废弃了虽然还能用但会打警告。现在统一用routes里的to: default好处是能写多条路由方便做策略路由或者多网卡分流。应用配置的标准动作是三步sudo chmod 600 /etc/netplan/*.yaml # 权限不对会报警告 sudo netplan generate # 只生成后端配置不生效 sudo netplan try # 试运行120 秒内不确认自动回滚 sudo netplan apply # 真正生效netplan try这个命令值得单独说一句它会临时应用配置然后等你按回车确认如果 120 秒内没确认比如你把自己 SSH 搞断了会自动回滚到之前的状态。远程改网络配置的时候一定要用try而不是直接apply这是保命操作。我第一次在云主机上改静态 IP 就是直接apply然后和机器失联了二十分钟最后靠控制台救回来。3.2 网卡名不固定怎么办match 加 set-name虚拟机克隆、云主机重建、换硬件都可能让网卡名变化写死了ens33就失效了。Netplan 提供了匹配的写法network: version: 2 renderer: networkd ethernets: lan: match: macaddress: 00:0c:29:aa:bb:cc set-name: lan0 dhcp4: true这样配置就跟着 MAC 地址走不管内核给它起什么名字最后都会被统一命名成lan0。多网卡服务器上这个技巧特别实用配置文件读起来清楚得多脚本里也不用改来改去。3.3 双网卡与多默认路由metric 决定谁优先服务器上经常是两块网卡一块接内网一块接外网或者一块管理一块业务。如果两块网卡都有默认网关系统就懵了到底从哪块出去解决办法是给路由加 metric数值小的优先。network: version: 2 ethernets: ens33: dhcp4: true dhcp4-overrides: route-metric: 100 ens34: addresses: [10.0.0.10/24] routes: - to: 10.10.0.0/16 via: 10.0.0.1 metric: 200这里ens33走默认路由metric 100ens34只负责10.10.0.0/16这个网段且不设默认网关。这是最干净的写法只有一块网卡有默认路由另一块只写明细路由。比两块都写默认路由再靠 metric 抢要可靠得多。3.4 云主机上的改了不生效问题云主机各家都类似第一次启动时cloud-init 会根据元数据生成一份 netplan 配置通常叫50-cloud-init.yaml。你手改之后重启发现配置被覆盖回去了这就是 cloud-init 在干活。标准做法是禁掉它的网络管理sudo tee /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg EOF network: {config: disabled} EOF然后再去改自己的 netplan 文件。另外要注意云主机的静态 IP 通常不能随便改很多平台是靠 DHCP 下发固定地址的你硬配一个别的地址可能直接失联。要改的话一般走控制台改弹性地址而不是改系统里的配置文件。4. 虚拟机与开发板场景的配网前面两节讲的是通用逻辑这一节说说几个高频场景因为大部分人第一次接触 Ubuntu 配网都是在虚拟机里。4.1 桥接、NAT、仅主机三种模式怎么选三种模式的差别用一句话概括就是虚拟机在不在你的局域网里。模式虚拟机 IP 来源局域网其他设备能否访问典型用途桥接和宿主机同一个网段的 DHCP能虚拟机像是局域网里一台独立主机需要被局域网访问、做服务端测试NAT宿主机分配的内部网段不能除非配端口转发只想上网不想被打扰仅主机宿主机内部网段无外网只能宿主机访问纯隔离测试、抓包实验桥接模式下最容易出的问题是IP 拿到了但上不了网通常是宿主机所在网络有 MAC 地址限制、或者公司网络对陌生设备做了准入。NAT 模式则相反能上网但 SSH 连不进去需要做端口转发。VMware 里在编辑 - 虚拟网络编辑器里配置 NAT 设置VirtualBox 里在网卡高级选项里点端口转发。# 在虚拟机里确认自己是不是 NAT ip route # 看到 192.168.x.0/24 且网关是 .1多半是 NAT ip -br addr show # 地址落在 10.0.2.x 段则基本可以确定是 NAT 模式4.2 虚拟机装完黑屏只有两个小图标先别慌有人在虚拟机里装 Ubuntu 时遇到黑屏屏幕下方只有两个小图标转圈第一反应是镜像坏了。实际上大概率是显卡和显示服务不兼容属于显示层面的问题跟配网没关系。处理办法是先等两三分钟如果确实卡死就在启动时按 Esc 进 GRUB在内核参数后面加nomodeset先进到系统再装合适的显卡驱动。装完之后网络配置照常做不受影响。注意虚拟机里配静态 IP 时一定要先确认宿主机的虚拟网卡网段。VMware 默认 NAT 网段是192.168.x.0/24里的一段VirtualBox 默认是10.0.2.0/24如果你在虚拟机里配的地址不在这两个网段里直接就不通跟写错网关是两回事。4.3 WSL 里的网络是另一套逻辑WSL2 本质上是一台轻量虚拟机网络默认是 NAT每次重启后 IP 都可能变。所以在 WSL 里配静态 IP 意义不大真正该做的是把服务监听地址设成0.0.0.0然后在 Windows 侧用端口转发或者防火墙规则放行。最近几个版本的 WSL 支持镜像网络模式在用户目录下的.wslconfig里加一行[wsl2] networkingModemirrored开了之后 WSL 会和 Windows 共享网络接口不再有独立的虚拟网卡localhost直接互通访问局域网设备也顺了。这个改动对开发体验提升挺大尤其是以前老是要去查 WSL 当前 IP 的人。不过它对 Windows 版本有要求太老的版本不支持改之前先确认一下自己的版本。4.4 开发板通过串口挂载网络共享的正确姿势拿开发板做 Zephyr 或者其他嵌入式开发的同学经常需要让开发板在没接网线的情况下联网做法是把 PC 的网络共享给开发板。PC 上的 USB 转串口芯片常见的 CH340、CP2102Ubuntu 内核自带驱动插上后dmesg | grep -i ch34能看到识别日志串口设备是/dev/ttyUSB0。用 picocom 或者 minicom 连上去sudo apt install picocom sudo picocom -b 115200 /dev/ttyUSB0 # 退出是 CtrlA 然后 CtrlX串口通了之后在开发板系统里配网网关指向 PC 的局域网地址就行。如果 PC 上用的是 NetworkManager还能用共享到其他计算机这个选项它会自动在 PC 上起一个内部网段并把这块网卡设成网关开发板从它拿 DHCP 地址省事不少。前提是开发板得有线口或者 USB 网卡。5. 连不上网时的排查顺序前面聊的都是怎么配这一节聊配完不通怎么办。我给的建议是严格按层排查别跳步。链路层、网络层、传输层、应用层一层一层看比东试西试快得多。5.1 第一步永远是看链路和地址ip -br link # DOWN 就是链路问题去查网线/虚拟机设置/驱动 ip -br addr # 没有 IP 就是配置或 DHCP 问题 ping -c 3 192.168.1.1 # 网关通不通这一步验证二层和三层 ping -c 3 223.5.5.5 # 直接 ping 公网 IP验证路由和出口 ping -c 3 example.com # 域名能解析说明 DNS 正常这四步的结果组合能直接定位问题链路 DOWN物理层跟配置无关。有 IP网关不通子网掩码或网段错了或者交换机 VLAN 隔离。网关通公网 IP 不通缺默认路由或者宿主机 NAT 没开。公网 IP 通域名不通DNS 配置问题去查 resolv.conf 或者 resolvectl。这个判断逻辑看起来简单但我见过太多人一上来就 ping 域名不通就以为没网实际上只是 DNS 没配。分层排查能把范围一下子收窄。5.2 SSH 连不上的完整排查链条SSH 连不上是高频问题排查顺序我一般是这样systemctl status ssh # 服务在不在跑 ss -tlnp | grep :22 # 有没有监听 22 端口监听的是 0.0.0.0 还是 127.0.0.1 sudo ufw status # 防火墙有没有拦 ip -br addr show # 是不是 IP 变了DHCP 租约到期很常见四个点里最容易忽略的是第三个。Ubuntu 桌面版默认不装 ufw 或者装了但没开Server 版有些镜像会默认开启。开了之后如果不放行 22 端口外面是永远连不上的而且本机测试ssh localhost还是通的特别容易误导人。还有一种情况是监听地址绑在了127.0.0.1外部连不上。这个是sshd_config里ListenAddress被改过改回0.0.0.0或者直接注释掉即可。改完记得sudo systemctl restart ssh。如果只在局域网内连不上但同一个网段的其他机器能连通它那问题多半在对端客户端所在网段和服务器之间被路由器隔离了或者服务器上有 iptables 规则。云主机的话还要看安全组这个经常被忘明明系统里所有配置都对就是连不上最后发现是控制台的安全组没放行 22 端口。5.3 常见问题速查表现象可能原因快速验证处理方向网卡显示 unmanagedNetworkManager 里被排除或 netplan 后端冲突nmcli device status检查/etc/NetworkManager/NetworkManager.conf和 netplan 的 renderer改了 netplan 不生效YAML 缩进用了 Tab或文件权限不对sudo netplan generate看报错改成空格缩进chmod 600重启后配置被覆盖cloud-init 在管理网络ls /etc/cloud/cloud.cfg.d/加99-disable-network-config.cfg能上网但解析不了域名resolv.conf 软链接被破坏或 DNS 没配resolvectl status在 netplan 或 nmcli 里补 nameservers多网卡时通时不通两条默认路由在抢ip route只保留一条默认路由其他写明细路由虚拟机 ping 不通外网宿主机 NAT 没开或防火墙拦了宿主机上抓包检查虚拟网络编辑器放行转发SSH 本机能通外部不通防火墙或监听地址问题ss -tlnp放行端口改 ListenAddress网卡名重启后变了硬件顺序或克隆导致ip -br link用 netplan 的 match set-name 绑定 MACWiFi 扫描不到射频被软/硬阻塞rfkill listrfkill unblock wifi或按物理开关静态 IP 和 DHCP 地址冲突手配的地址落在 DHCP 池里路由器后台看分配换一个池外地址或者做地址保留5.4 几个只有踩过才知道的细节说几个文档里不太会写、但实际会遇到的点。第一个是netplan apply之后网络会有短暂中断如果此时你正在用 SSH连接会卡一下但一般不会断因为 Netplan 是先配置新地址再摘旧地址。但如果你把网卡名改错了那就真的断了所以还是推荐netplan try。第二个是虚拟机快照。很多人配好网之后拍了个快照后面恢复快照发现网络又坏了。原因通常是快照恢复后 MAC 地址变了而你的 netplan 里写死了网卡名或者 MAC。要么改用 DHCP要么确认虚拟机设置里保留 MAC 地址是勾上的。第三个是时间同步。看起来跟配网无关但系统时间偏差太大时某些基于时间的认证会失败表现出来像是网络不通。装完系统先timedatectl status看一眼时间对不对顺手sudo timedatectl set-ntp true打开自动同步能省掉不少莫名其妙的麻烦。第四个是软件源。刚装完的系统如果连不上外网apt 装什么都失败看起来像是网络全坏了。实际上先ping一下源地址如果通就只是源站问题换一个源或者等一会儿再试就行别急着回滚网络配置。反过来说如果确实需要在没有外网的环境下装东西提前把 deb 包下好拷进去用dpkg -i装比在现场折腾网络靠谱。我自己这几年的习惯是任何一次网络配置改动之前先ip -br addr show /tmp/net-before.txt和ip route /tmp/net-before.txt存一份。改完之后如果不对照着这份记录手动退回去。这个习惯救了我不止一次尤其是那些隔了一层虚拟化、隔了一层云平台的机器你永远不知道中间哪一层在悄悄改你的配置。还有一个建议是给服务器配完静态 IP 之后把配置文件和当时的输出日志一起记到自己的笔记里。半年后机器出问题你翻笔记比翻系统快得多因为netplan生成的运行态配置在/run/systemd/network/下面机器重启后是空的想回溯都回溯不了。配网这事本身就是个做好记录比技术强的活。 
长河君 · 2026/9/17 5:15:33 · 阅读 1.2k Ubuntu配网实战：Netplan与NetworkManager配置排错指南
1. 先把配网这件事拆开看Ubuntu 配网这个词外行看着像插上网线就完事实际上手过的人都知道它至少包含四层意思物理链路能不能通、网卡有没有被系统接管、IP 怎么拿到、DNS 和路由怎么走。我见过太多人卡在第三步却一直在第一步折腾网线也见过不少人把 DNS 写错了然后花一晚上怀疑是不是系统装了假的。这篇文章就是把这四层从头到尾捋一遍把桌面版、服务器版、虚拟机、开发板这几类常见场景都覆盖到你手上不管是刚装完的 Ubuntu 22.04 还是 24.04 LTS都能照着往下走。先明确一下适合谁看。第一种是刚把 Ubuntu 装进 VMware 或者 VirtualBox发现 ping 不通外网、SSH 连不上的新手第二种是在服务器上要配静态 IP、双网卡、多路由的运维同学第三种是拿开发板、WSL 当日常开发环境需要让系统稳定跑起 Docker、GCC、CMake 这类工具链的人。这三类人关注的点其实不太一样新手最需要的是先确认链路是不是活的老手最在意的是配置怎么写才不会被系统自己改回去。下面我会把这两种需求分开讲。在动手之前先给一个基本认知Ubuntu 的网络配置这几年变化挺大的。早期是/etc/network/interfaces一家独大后来 NetworkManager 接管桌面再后来 Netplan 变成了统一的抽象层服务器版由它生成 systemd-networkd 的配置。所以你从网上抄到的一份 2016 年的教程大概率在 24.04 上是跑不通的不是教程错了是这套东西已经被换过一轮了。搞清楚当前这套系统用哪一层在管网络比记住某个具体命令重要得多。1.1 三套网络管理工具别让它们打架Ubuntu 里同时存在好几个能改网络的东西它们的关系不是哪个更好用而是谁在管这块网卡。搞混了就会出现我改了配置怎么不生效这种情况。工具配置文件位置常见于特点Netplan/etc/netplan/*.yaml17.10 之后所有版本只是个翻译层自己不实现网络把 YAML 翻译给后端systemd-networkd/etc/systemd/network/Server 版默认后端轻量、无 GUI、适合服务器和容器NetworkManager/etc/NetworkManager/Desktop 版默认后端有 GUI 和 nmcli能管 WiFi、蓝牙共享等ifupdown/etc/network/interfaces老版本现在要手动装不建议新系统用关键点在于 Netplan 的renderer字段写networkd就交给 systemd-networkd写NetworkManager就交给 NetworkManager。桌面版默认的/etc/netplan/01-network-manager-all.yaml里写的就是 NetworkManager所以你在桌面上用图形界面点一下就能生效服务器版默认是 networkd必须改 YAML。注意同一块网卡不要被两套工具同时声明。我踩过的坑是在桌面版服务器上装了 networkd 的配置结果 NetworkManager 把网卡标成 unmanaged两边都不干活网卡亮着灯但就是没 IP。1.2 上手第一件事确认网卡到底叫什么这一步看起来废话实际能省掉后面一大半时间。Ubuntu 从 16.04 开始默认用可预测网卡名eth0变成了ens33、enp3s0、eno1这类名字虚拟机里常见的是ens33或ens160无线网卡是wlp2s0这种格式。命名规则大概是en开头是有线wl开头是无线后面跟的是 PCI 总线位置。ip -br link show # 简洁列出所有网卡和状态 ip -br addr show # 额外显示 IP lspci -k | grep -A 3 -i net # 看网卡的 PCI 信息和正在用的驱动 lshw -C network # 更详细的硬件信息需要 sudoip -br link的输出里如果状态是DOWN说明链路层没起来可能是网线没插好、虚拟机网络适配器没连上、或者驱动没加载。如果是UP但没有 IP那就是配置层面的问题了往后看第三节。USB 网卡的话用lsusb看有没有被识别插上后dmesg | tail -20一般能看到内核给它分配的名字。1.3 四种场景先想清楚你要哪一种很多人配网配得痛苦是因为一开始没想清楚自己到底要什么。实际上无非四种情况动态 IPDHCP路由器给什么用什么适合家用、临时虚拟机、随手测试。静态 IP自己指定地址适合服务器、需要被别人稳定访问的机器、开发板。双网卡分工一块对内一块对外或者一块跑管理流量一块跑业务流量。无线连接笔记本、树莓派这类没有网口的设备。选错了场景后面所有命令都白搭。比如你在家里用桥接模式给虚拟机配了个静态 IP结果路由器 DHCP 池和这个地址撞了就会出现时通时不通的玄学问题。判断标准很简单这台机器需不需要被局域网里其他设备主动访问需要就静态不需要就 DHCP。2. 桌面版 Ubuntu 配网实操桌面版是最省心的因为 NetworkManager 给了图形界面和 nmcli 两套入口改完立刻生效不用重启网络服务。但省心不代表没坑尤其是当你从图形界面切到命令行的时候容易把已有的连接配置搞乱。2.1 图形界面配置三分钟搞定的标准流程点右上角网络图标进设置找到网络这一栏。有线连接下会显示当前的连接名比如有线连接 1点齿轮图标进入详情页切到 IPv4 标签页。这里有四个选项自动 (DHCP)默认路由器分配。手动静态 IP下面填写地址、子网掩码、网关。仅本地链接只做二层通信不配 IP。共享到其他计算机把本机当网关给别的设备做网络共享。选手动之后地址格式要写成192.168.1.50/24这种带掩码位数的形式只写 IP 不写/24会报错。DNS 那一栏要手动填比如223.5.5.5,119.29.29.29逗号分隔。填完点应用图标上的小问号消失就说明通了。注意图形界面里如果不小心把自动关掉了却没填网关会出现能 ping 通同网段设备但上不了网的经典症状本质是缺默认路由。这个时候别急着怀疑 DNS先ip route看一眼有没有default via。2.2 nmcli真正好用的其实是命令行图形界面适合一次性配置但要批量改、脚本化改、远程改还是 nmcli 靠谱。它的逻辑是连接connection和设备device分开管理一个设备上可以挂多个连接配置按优先级自动切换。这个设计刚接触会觉得绕习惯了就知道很方便比如笔记本换到不同办公室可以预存多套 WiFi 配置。先看现状nmcli device status # 设备和当前连接状态 nmcli connection show # 所有连接配置 nmcli connection show 有线连接 1 # 看某个配置的所有细节配一个静态 IP 的完整流程# 1. 先改配置此时不生效 sudo nmcli connection modify 有线连接 1 \ ipv4.method manual \ ipv4.addresses 192.168.1.50/24 \ ipv4.gateway 192.168.1.1 \ ipv4.dns 223.5.5.5 119.29.29.29 # 2. 再重新激活让它生效 sudo nmcli connection up 有线连接 1 # 3. 验证 ip -br addr show ip route注意这里ipv4.dns的值是空格分隔的字符串写在引号里而ipv4.addresses在较新版本里支持逗号分隔多个地址。nmcli connection modify是改配置文件不会立即生效必须up一次这个改和生效分离的机制经常把人绕进去。如果想退回去用 DHCPsudo nmcli connection modify 有线连接 1 ipv4.method auto ipv4.gateway ipv4.addresses ipv4.dns sudo nmcli connection up 有线连接 1这里把其他字段清空是好习惯。NetworkManager 在method auto时会忽略静态字段但有些版本会在两个配置之间反复横跳清干净最稳。# 新建一个连接配置不动原来的 sudo nmcli connection add type ethernet con-name static-ens33 ifname ens33 \ ipv4.method manual \ ipv4.addresses 192.168.1.60/24 \ ipv4.gateway 192.168.1.1 \ ipv4.dns 223.5.5.5 # 删除某个连接配置 sudo nmcli connection delete static-ens332.3 WiFi 连接与射频开关那些事无线网卡的问题比有线多一层射频开关。rfkill list能看到每个无线设备的软阻塞software blocked和硬阻塞hard blocked。硬阻塞一般是笔记本上的物理开关或者 Fn 组合键软阻塞可以用rfkill unblock wifi解除。rfkill list nmcli device wifi list # 扫描周边 WiFi sudo nmcli device wifi connect SSID名称 password 密码 nmcli connection show --active笔记本上有个很常见的坑有线连上后 WiFi 会自动断开这是 NetworkManager 的单连接策略在起作用。要两个都留着得把连接配置的connection.autoconnect-priority和connection.secondary改一下把 WiFi 设成ipv4.may-fail yes的辅助连接。这个配置在写多网卡分流脚本时很有用但普通人一般遇不到。2.4 DNS 缓存和 resolv.conf 的真实关系Ubuntu 18.04 以后用 systemd-resolved 做 DNS 缓存和转发/etc/resolv.conf实际上是一个软链接指向/run/systemd/resolve/stub-resolv.conf里面只写了一个127.0.0.53真正的 DNS 服务器地址在别处。很多人vi /etc/resolv.conf改了半天发现重启就丢原因就在这里。ls -l /etc/resolv.conf # 看它指向哪里 resolvectl status # 看每块网卡实际用的 DNS resolvectl query example.com # 用 systemd-resolved 查一次如果确实需要手写 resolv.conf比如某些容器环境先把它从软链接改成真实文件sudo rm /etc/resolv.conf sudo tee /etc/resolv.conf EOF nameserver 223.5.5.5 nameserver 119.29.29.29 EOF注意这么做会绕过 systemd-resolved 的缓存长期看反而更容易出问题。我的建议是优先在 NetworkManager 或 Netplan 里配 DNS让系统自己维护 resolv.conf不要直接改文件。3. 服务器版 Ubuntu 配网Netplan 是主角Server 版没有图形界面默认用 Netplan 加 systemd-networkd。配置文件放在/etc/netplan/下文件名一般长这样00-installer-config.yaml手动装的、50-cloud-init.yaml云主机自动生成的、01-netcfg.yaml老一点的版本。多个文件会按文件名排序合并后面的覆盖前面的所以改配置的时候先ls一下别只看一个文件就下手。3.1 一份能直接用的静态 IP 配置YAML 的缩进是硬要求必须用空格不能用 Tab缩进错了netplan apply会直接报错。下面这份是我在 22.04 和 24.04 上都在用的模板network: version: 2 renderer: networkd ethernets: ens33: dhcp4: false dhcp6: false addresses: - 192.168.1.50/24 routes: - to: default via: 192.168.1.1 nameservers: addresses: [223.5.5.5, 119.29.29.29] search: [local]24.04 之前的教程里常见gateway4: 192.168.1.1这种写法从 22.04 开始它被标记为废弃了虽然还能用但会打警告。现在统一用routes里的to: default好处是能写多条路由方便做策略路由或者多网卡分流。应用配置的标准动作是三步sudo chmod 600 /etc/netplan/*.yaml # 权限不对会报警告 sudo netplan generate # 只生成后端配置不生效 sudo netplan try # 试运行120 秒内不确认自动回滚 sudo netplan apply # 真正生效netplan try这个命令值得单独说一句它会临时应用配置然后等你按回车确认如果 120 秒内没确认比如你把自己 SSH 搞断了会自动回滚到之前的状态。远程改网络配置的时候一定要用try而不是直接apply这是保命操作。我第一次在云主机上改静态 IP 就是直接apply然后和机器失联了二十分钟最后靠控制台救回来。3.2 网卡名不固定怎么办match 加 set-name虚拟机克隆、云主机重建、换硬件都可能让网卡名变化写死了ens33就失效了。Netplan 提供了匹配的写法network: version: 2 renderer: networkd ethernets: lan: match: macaddress: 00:0c:29:aa:bb:cc set-name: lan0 dhcp4: true这样配置就跟着 MAC 地址走不管内核给它起什么名字最后都会被统一命名成lan0。多网卡服务器上这个技巧特别实用配置文件读起来清楚得多脚本里也不用改来改去。3.3 双网卡与多默认路由metric 决定谁优先服务器上经常是两块网卡一块接内网一块接外网或者一块管理一块业务。如果两块网卡都有默认网关系统就懵了到底从哪块出去解决办法是给路由加 metric数值小的优先。network: version: 2 ethernets: ens33: dhcp4: true dhcp4-overrides: route-metric: 100 ens34: addresses: [10.0.0.10/24] routes: - to: 10.10.0.0/16 via: 10.0.0.1 metric: 200这里ens33走默认路由metric 100ens34只负责10.10.0.0/16这个网段且不设默认网关。这是最干净的写法只有一块网卡有默认路由另一块只写明细路由。比两块都写默认路由再靠 metric 抢要可靠得多。3.4 云主机上的改了不生效问题云主机各家都类似第一次启动时cloud-init 会根据元数据生成一份 netplan 配置通常叫50-cloud-init.yaml。你手改之后重启发现配置被覆盖回去了这就是 cloud-init 在干活。标准做法是禁掉它的网络管理sudo tee /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg EOF network: {config: disabled} EOF然后再去改自己的 netplan 文件。另外要注意云主机的静态 IP 通常不能随便改很多平台是靠 DHCP 下发固定地址的你硬配一个别的地址可能直接失联。要改的话一般走控制台改弹性地址而不是改系统里的配置文件。4. 虚拟机与开发板场景的配网前面两节讲的是通用逻辑这一节说说几个高频场景因为大部分人第一次接触 Ubuntu 配网都是在虚拟机里。4.1 桥接、NAT、仅主机三种模式怎么选三种模式的差别用一句话概括就是虚拟机在不在你的局域网里。模式虚拟机 IP 来源局域网其他设备能否访问典型用途桥接和宿主机同一个网段的 DHCP能虚拟机像是局域网里一台独立主机需要被局域网访问、做服务端测试NAT宿主机分配的内部网段不能除非配端口转发只想上网不想被打扰仅主机宿主机内部网段无外网只能宿主机访问纯隔离测试、抓包实验桥接模式下最容易出的问题是IP 拿到了但上不了网通常是宿主机所在网络有 MAC 地址限制、或者公司网络对陌生设备做了准入。NAT 模式则相反能上网但 SSH 连不进去需要做端口转发。VMware 里在编辑 - 虚拟网络编辑器里配置 NAT 设置VirtualBox 里在网卡高级选项里点端口转发。# 在虚拟机里确认自己是不是 NAT ip route # 看到 192.168.x.0/24 且网关是 .1多半是 NAT ip -br addr show # 地址落在 10.0.2.x 段则基本可以确定是 NAT 模式4.2 虚拟机装完黑屏只有两个小图标先别慌有人在虚拟机里装 Ubuntu 时遇到黑屏屏幕下方只有两个小图标转圈第一反应是镜像坏了。实际上大概率是显卡和显示服务不兼容属于显示层面的问题跟配网没关系。处理办法是先等两三分钟如果确实卡死就在启动时按 Esc 进 GRUB在内核参数后面加nomodeset先进到系统再装合适的显卡驱动。装完之后网络配置照常做不受影响。注意虚拟机里配静态 IP 时一定要先确认宿主机的虚拟网卡网段。VMware 默认 NAT 网段是192.168.x.0/24里的一段VirtualBox 默认是10.0.2.0/24如果你在虚拟机里配的地址不在这两个网段里直接就不通跟写错网关是两回事。4.3 WSL 里的网络是另一套逻辑WSL2 本质上是一台轻量虚拟机网络默认是 NAT每次重启后 IP 都可能变。所以在 WSL 里配静态 IP 意义不大真正该做的是把服务监听地址设成0.0.0.0然后在 Windows 侧用端口转发或者防火墙规则放行。最近几个版本的 WSL 支持镜像网络模式在用户目录下的.wslconfig里加一行[wsl2] networkingModemirrored开了之后 WSL 会和 Windows 共享网络接口不再有独立的虚拟网卡localhost直接互通访问局域网设备也顺了。这个改动对开发体验提升挺大尤其是以前老是要去查 WSL 当前 IP 的人。不过它对 Windows 版本有要求太老的版本不支持改之前先确认一下自己的版本。4.4 开发板通过串口挂载网络共享的正确姿势拿开发板做 Zephyr 或者其他嵌入式开发的同学经常需要让开发板在没接网线的情况下联网做法是把 PC 的网络共享给开发板。PC 上的 USB 转串口芯片常见的 CH340、CP2102Ubuntu 内核自带驱动插上后dmesg | grep -i ch34能看到识别日志串口设备是/dev/ttyUSB0。用 picocom 或者 minicom 连上去sudo apt install picocom sudo picocom -b 115200 /dev/ttyUSB0 # 退出是 CtrlA 然后 CtrlX串口通了之后在开发板系统里配网网关指向 PC 的局域网地址就行。如果 PC 上用的是 NetworkManager还能用共享到其他计算机这个选项它会自动在 PC 上起一个内部网段并把这块网卡设成网关开发板从它拿 DHCP 地址省事不少。前提是开发板得有线口或者 USB 网卡。5. 连不上网时的排查顺序前面聊的都是怎么配这一节聊配完不通怎么办。我给的建议是严格按层排查别跳步。链路层、网络层、传输层、应用层一层一层看比东试西试快得多。5.1 第一步永远是看链路和地址ip -br link # DOWN 就是链路问题去查网线/虚拟机设置/驱动 ip -br addr # 没有 IP 就是配置或 DHCP 问题 ping -c 3 192.168.1.1 # 网关通不通这一步验证二层和三层 ping -c 3 223.5.5.5 # 直接 ping 公网 IP验证路由和出口 ping -c 3 example.com # 域名能解析说明 DNS 正常这四步的结果组合能直接定位问题链路 DOWN物理层跟配置无关。有 IP网关不通子网掩码或网段错了或者交换机 VLAN 隔离。网关通公网 IP 不通缺默认路由或者宿主机 NAT 没开。公网 IP 通域名不通DNS 配置问题去查 resolv.conf 或者 resolvectl。这个判断逻辑看起来简单但我见过太多人一上来就 ping 域名不通就以为没网实际上只是 DNS 没配。分层排查能把范围一下子收窄。5.2 SSH 连不上的完整排查链条SSH 连不上是高频问题排查顺序我一般是这样systemctl status ssh # 服务在不在跑 ss -tlnp | grep :22 # 有没有监听 22 端口监听的是 0.0.0.0 还是 127.0.0.1 sudo ufw status # 防火墙有没有拦 ip -br addr show # 是不是 IP 变了DHCP 租约到期很常见四个点里最容易忽略的是第三个。Ubuntu 桌面版默认不装 ufw 或者装了但没开Server 版有些镜像会默认开启。开了之后如果不放行 22 端口外面是永远连不上的而且本机测试ssh localhost还是通的特别容易误导人。还有一种情况是监听地址绑在了127.0.0.1外部连不上。这个是sshd_config里ListenAddress被改过改回0.0.0.0或者直接注释掉即可。改完记得sudo systemctl restart ssh。如果只在局域网内连不上但同一个网段的其他机器能连通它那问题多半在对端客户端所在网段和服务器之间被路由器隔离了或者服务器上有 iptables 规则。云主机的话还要看安全组这个经常被忘明明系统里所有配置都对就是连不上最后发现是控制台的安全组没放行 22 端口。5.3 常见问题速查表现象可能原因快速验证处理方向网卡显示 unmanagedNetworkManager 里被排除或 netplan 后端冲突nmcli device status检查/etc/NetworkManager/NetworkManager.conf和 netplan 的 renderer改了 netplan 不生效YAML 缩进用了 Tab或文件权限不对sudo netplan generate看报错改成空格缩进chmod 600重启后配置被覆盖cloud-init 在管理网络ls /etc/cloud/cloud.cfg.d/加99-disable-network-config.cfg能上网但解析不了域名resolv.conf 软链接被破坏或 DNS 没配resolvectl status在 netplan 或 nmcli 里补 nameservers多网卡时通时不通两条默认路由在抢ip route只保留一条默认路由其他写明细路由虚拟机 ping 不通外网宿主机 NAT 没开或防火墙拦了宿主机上抓包检查虚拟网络编辑器放行转发SSH 本机能通外部不通防火墙或监听地址问题ss -tlnp放行端口改 ListenAddress网卡名重启后变了硬件顺序或克隆导致ip -br link用 netplan 的 match set-name 绑定 MACWiFi 扫描不到射频被软/硬阻塞rfkill listrfkill unblock wifi或按物理开关静态 IP 和 DHCP 地址冲突手配的地址落在 DHCP 池里路由器后台看分配换一个池外地址或者做地址保留5.4 几个只有踩过才知道的细节说几个文档里不太会写、但实际会遇到的点。第一个是netplan apply之后网络会有短暂中断如果此时你正在用 SSH连接会卡一下但一般不会断因为 Netplan 是先配置新地址再摘旧地址。但如果你把网卡名改错了那就真的断了所以还是推荐netplan try。第二个是虚拟机快照。很多人配好网之后拍了个快照后面恢复快照发现网络又坏了。原因通常是快照恢复后 MAC 地址变了而你的 netplan 里写死了网卡名或者 MAC。要么改用 DHCP要么确认虚拟机设置里保留 MAC 地址是勾上的。第三个是时间同步。看起来跟配网无关但系统时间偏差太大时某些基于时间的认证会失败表现出来像是网络不通。装完系统先timedatectl status看一眼时间对不对顺手sudo timedatectl set-ntp true打开自动同步能省掉不少莫名其妙的麻烦。第四个是软件源。刚装完的系统如果连不上外网apt 装什么都失败看起来像是网络全坏了。实际上先ping一下源地址如果通就只是源站问题换一个源或者等一会儿再试就行别急着回滚网络配置。反过来说如果确实需要在没有外网的环境下装东西提前把 deb 包下好拷进去用dpkg -i装比在现场折腾网络靠谱。我自己这几年的习惯是任何一次网络配置改动之前先ip -br addr show /tmp/net-before.txt和ip route /tmp/net-before.txt存一份。改完之后如果不对照着这份记录手动退回去。这个习惯救了我不止一次尤其是那些隔了一层虚拟化、隔了一层云平台的机器你永远不知道中间哪一层在悄悄改你的配置。还有一个建议是给服务器配完静态 IP 之后把配置文件和当时的输出日志一起记到自己的笔记里。半年后机器出问题你翻笔记比翻系统快得多因为netplan生成的运行态配置在/run/systemd/network/下面机器重启后是空的想回溯都回溯不了。配网这事本身就是个做好记录比技术强的活。