CoreOS系统下systemd管理NFS挂载启动不可靠问题排查求助

这种随机挂载失败的情况我碰到过好多次，大概率是systemd启动时网络还没完全就绪导致的——默认的挂载单元不会等网络彻底连通就尝试挂载NFS，而手动执行时网络已经稳定了，所以每次都能成功。下面是具体的解决步骤：

1. 给挂载单元添加正确的网络依赖 #

systemd里有两个关键的网络目标，得区分清楚：

• network.target：仅表示网络服务启动，但不一定能连通远程主机
• network-online.target：表示网络已经完全就绪，可以正常连接到远程节点

我们需要让NFS挂载单元明确依赖后者，同时加上_netdev挂载选项，告诉systemd这是一个依赖网络设备的挂载操作。

2. 创建/修改挂载单元文件 #

CoreOS的自定义systemd单元一般放在/etc/systemd/system/目录下，以你的mnt-documents.mount为例，编辑这个文件：

[Unit]
Description=Mount NFS share for documents
# 要求网络完全就绪后再执行挂载
Requires=network-online.target
After=network-online.target
# 依赖远程文件系统准备目标
Wants=remote-fs-pre.target
Before=remote-fs.target
# 如果NAS是通过DNS解析的，加上这个确保DNS服务就绪
After=nss-lookup.target

[Mount]
What=remote:/path/to/documents
Where=/mnt/documents
Type=nfs
# _netdev是核心选项，再加上超时和重试优化稳定性
Options=_netdev,auto,rw,sync,hard,intr,x-systemd.mount-timeout=30s,x-systemd.retry=3

[Install]
WantedBy=multi-user.target

对另外3个挂载单元做同样的修改，注意替换对应的What（NAS端路径）和Where（本地挂载点）。

3. 重新加载systemd并启用单元 #

执行以下命令让修改生效：

sudo systemctl daemon-reload
sudo systemctl enable mnt-documents.mount

对其他3个挂载单元重复enable操作即可。

4. 额外排查技巧 #

如果还是偶尔出现失败，可以查看挂载单元的日志找具体原因：

journalctl -u mnt-documents.mount -b

看看日志里是超时、权限错误还是其他问题——比如NAS的exports配置是否限制了CoreOS的IP，或者NFS版本兼容性问题（可以在Options里指定vers=4或vers=3试试）。

内容的提问来源于stack exchange，提问作者Nathaniel Waisbrot