Linux 挂载 Samba/CIFS 共享排错记录

问题现象

在 Ubuntu 系统上挂载 NAS 的 SMB 共享时，遇到以下情况：

使用命令行直接输入密码可以正常挂载：

sudo mount -t cifs //192.168.x.x/share /mnt/xnas/share -o username=xxx,password=xxx

但使用 credentials 文件挂载时失败：

sudo mount -t cifs //192.168.x.x/share /mnt/xnas/share -o credentials=/etc/smb-credentials
mount: /mnt/xnas/share: special device //192.168.x.x/share does not exist.

错误信息提示"设备不存在"，但同一时刻使用 smbclient 测试，凭据文件可以正常工作：

sudo smbclient -A /etc/smb-credentials -L //192.168.x.x/

排查过程

检查凭据文件格式

使用 cat -A 查看文件内容，确认无特殊字符：

user@ubuntu:~$ sudo cat -A /etc/smb-credentials
username=xxx$
password=xxx$

输出显示为 Unix 换行符（$），格式正确。

检查文件权限

user@ubuntu:~$ ls -la /etc/smb-credentials
-rw------- 1 root root 41 2月 28 08:47 /etc/smb-credentials

权限为 600，属主 root，符合安全要求。

尝试其他挂载选项

尝试添加 vers、domain、sec 等参数，问题依旧：

sudo mount -t cifs ... -o credentials=/etc/smb-credentials,vers=3.0
sudo mount -t cifs ... -o credentials=/etc/smb-credentials,domain=WORKGROUP
sudo mount -t cifs ... -o credentials=/etc/smb-credentials,sec=ntlmssp

均报相同的"设备不存在"错误。

安装 cifs-utils 后解决

执行以下命令安装 cifs-utils：

sudo apt install cifs-utils

安装后，使用完全相同的挂载命令，挂载成功。

原因分析

内核原生 CIFS 与 cifs-utils 的区别

Linux 内核原生支持 CIFS 文件系统，但仅实现基础功能：

• 支持通过命令行直接传递 username、password 参数
• 不支持 credentials 文件解析

安装 cifs-utils 后，系统提供 /sbin/mount.cifs 用户空间工具。此时 mount -t cifs 实际调用 mount.cifs，该工具提供完整功能：

• 解析 credentials 文件
• 支持更多高级选项（sec、vers、uid、gid 等）
• 更好的错误处理和调试信息

错误信息的误导性

错误"special device does not exist"并非设备真正不存在，而是内核遇到不认识的 credentials 选项后，认证流程失败，最终表现为设备无法访问的误导性错误。

smbclient 为何始终正常

smbclient 是独立的用户空间实现，完整实现了 SMB/CIFS 协议栈，不依赖内核 CIFS 模块，因此不受 cifs-utils 安装与否的影响。

完整配置方案

安装必要软件包

sudo apt update
sudo apt install cifs-utils

创建凭据文件

sudo tee /etc/smb-credentials << 'EOF'
username=xxx
password=xxx
domain=WORKGROUP
EOF

sudo chmod 600 /etc/smb-credentials
sudo chown root:root /etc/smb-credentials

手动挂载

sudo mkdir -p /mnt/xnas/share

sudo mount -t cifs //192.168.x.x/share /mnt/xnas/share \
-o credentials=/etc/smb-credentials,vers=3.0,iocharset=utf8

配置开机自动挂载

编辑 /etc/fstab，添加：

//192.168.x.x/share /mnt/xnas/share cifs credentials=/etc/smb-credentials,vers=3.0,iocharset=utf8,_netdev,x-systemd.automount 0 0

关键选项说明：

选项	作用
_netdev	声明为网络设备，确保网络就绪后再挂载
x-systemd.automount	按需挂载，避免开机阻塞
vers=3.0	指定 SMB 协议版本
iocharset=utf8	正确处理中文文件名

总结

现象	原因	解决
credentials 参数无效	未安装 cifs-utils	安装 cifs-utils
直接输密码能挂，凭据文件不能	同上	同上
smbclient 能连，mount 不能	同上	同上

核心要点：Linux 内核原生 CIFS 仅提供基础挂载功能，credentials 文件解析等高级功能依赖 cifs-utils 提供的用户空间工具 mount.cifs。