SMB/CIFS 挂载速查：各 Linux 发行版安装命令与挂载报错对照

适用于所有 Linux 发行版 — Synology DSM / Ubuntu / CentOS / Debian / Rocky / Arch 等Synology DSM • Ubuntu • CentOS • Debian • Rocky Linux

1 环境准备 — 检查系统工具

挂载 SMB 共享需要 cifs-utils 工具包。Synology DSM 通常已预装，先确认一下。

1.1 检查 mount.cifs 是否存在

Shell检查工具

# 检查 cifs 挂载工具是否可用
which mount.cifs

1.2 安装 cifs-utils（不同 Linux 发行版）

如果系统没有 mount.cifs 命令，需要先安装 cifs-utils 工具包。不同发行版使用不同的包管理器：

发行版	包管理器	安装命令
Debian / Ubuntu	apt	apt install cifs-utils
CentOS / RHEL 7	yum	yum install cifs-utils
CentOS / RHEL 8+ / Rocky / Alma	dnf	dnf install cifs-utils
Fedora	dnf	dnf install cifs-utils
Arch / Manjaro	pacman	pacman -S cifs-utils
openSUSE / SLES	zypper	zypper install cifs-utils
Synology DSM	预装	无需安装

1.3 安装 smbclient（可选，用于探测共享）

smbclient 不是必须的，但用来探测远程共享目录非常方便。

发行版	安装命令
Debian / Ubuntu	apt install smbclient
CentOS / RHEL 7	yum install samba-client
CentOS / RHEL 8+ / Rocky / Alma	dnf install samba-client
Fedora	dnf install samba-client
Arch / Manjaro	pacman -S smbclient
openSUSE / SLES	zypper install samba-client

1.4 检查 cifs 内核模块

Shell检查模块

# 查看 cifs 内核模块是否已加载
lsmod | grep cifs

# 如果未加载，手动加载
modprobe cifs

2 探测目标服务器的共享目录

用 smbclient 列出 192.168.1.10 上所有共享目录，分别用匿名和账号两种方式探测。

2.1 匿名探测（无需账号）

Shell匿名探测

# -L 列出远程共享  -N 匿名（空密码）
smbclient -L //192.168.1.10 -N

2.2 账号探测（使用 nasadmin 登录）

Shell账号探测

# -U 指定用户名%密码
smbclient -L //192.168.1.10 -U nasadmin%123

3 验证用户权限

挂载前先用 smbclient 验证 nasadmin 对 Btest 目录的读写权限。

3.1 测试读取权限

Shell读取测试

# 连接到 Btest 并列出文件
smbclient //192.168.1.10/Btest -U nasadmin%123 -c "ls"

3.2 测试写入权限

Shell写入测试

# 创建临时文件并上传到 Btest，验证后删除
echo "test" > /tmp/test_write.tmp
smbclient //192.168.1.10/Btest -U nasadmin%123 \
    -c "put /tmp/test_write.tmp test_write_check.tmp; rm test_write_check.tmp"

4 创建本地挂载点

在本机创建一个空目录，作为远程共享的挂载目标路径。Shell创建目录

# -p 递归创建多级目录
mkdir -p /volume1/remote/Btest

5 执行挂载命令

使用 mount -t cifs 将远程共享挂载到本地目录。

5.1 首次尝试（匿名 — 失败）

Shell失败演示

# 匿名挂载会失败，因为服务器要求认证
mount -t cifs //192.168.1.10/Btest /volume1/remote/Btest -o guest

5.2 第二次尝试（有账号但参数不全 — 失败）

Shell失败演示

# 只给了账号密码，没加兼容性参数
mount -t cifs //192.168.1.10/Btest /volume1/remote/Btest \
    -o username=nasadmin,password=123

5.3 最终挂载（成功）

Shell成功

mount -t cifs //192.168.1.10/Btest /volume1/remote/Btest \
    -o username=nasadmin,password=123,noperm,nounix

5.4 参数详解

参数	说明
-t cifs	指定文件系统类型为 CIFS（SMB 的 Linux 实现）
username=nasadmin	SMB 认证用户名
password=123	SMB 认证密码
noperm	跳过本地文件系统权限检查，允许所有用户访问
nounix	禁用 Unix 扩展，使用纯 CIFS 协议（Synology 兼容性更好）
_netdev	（fstab 用）标记为网络设备，启动时等网络就绪后再挂载
vers=1.0	（可选）指定 SMB 版本，Synology 默认协商为 1.0

6 验证挂载结果

6.1 查看挂载信息

Shell验证

mount | grep cifs

6.2 查看远程目录内容

Shell查看文件

ls -la /volume1/remote/Btest/

7 持久化配置 — 重启自动挂载

默认情况下重启 NAS 后挂载会丢失。需要配置 /etc/fstab + 启动脚本实现自动挂载。

7.1 备份原 fstab

Shell安全操作

# 先备份原 fstab，防止改错导致系统无法启动
cp /etc/fstab /etc/fstab.bak

7.2 查看当前 fstab

Shell查看

cat /etc/fstab

7.3 添加 fstab 挂载条目

Shell核心配置

# 追加 CIFS 挂载条目到 fstab
echo '//192.168.1.10/Btest /volume1/remote/Btest cifs username=nasadmin,password=123,noperm,nounix,_netdev 0 0' \
    >> /etc/fstab

7.4 验证 fstab 内容

Shell验证

cat /etc/fstab

7.5 创建开机启动脚本

Synology DSM 使用 /usr/local/etc/rc.d/ 目录下的脚本作为开机自启动项。Shell创建启动脚本

cat > /usr/local/etc/rc.d/S99mount_Btest.sh << 'EOF'
#!/bin/sh

# ========================================
# 开机自动挂载 Btest 共享目录
# ========================================

MOUNT_POINT="/volume1/remote/Btest"
REMOTE_SHARE="//192.168.1.10/Btest"
USERNAME="nasadmin"
PASSWORD="123"

case "$1" in
    start)
        # 创建挂载点（如不存在）
        mkdir -p "$MOUNT_POINT"

        # 检查是否已挂载
        if ! mount | grep -q "$MOUNT_POINT"; then
            echo "Mounting $REMOTE_SHARE to $MOUNT_POINT..."
            mount -t cifs "$REMOTE_SHARE" "$MOUNT_POINT" \
                -o username="$USERNAME",password="$PASSWORD",noperm,nounix,_netdev
            if [ $? -eq 0 ]; then
                echo "Successfully mounted $REMOTE_SHARE"
            else
                echo "Failed to mount $REMOTE_SHARE"
            fi
        else
            echo "$REMOTE_SHARE is already mounted"
        fi
        ;;
    stop)
        echo "Unmounting $MOUNT_POINT..."
        umount "$MOUNT_POINT" 2>/dev/null
        ;;
    *)
        echo "Usage: $0 {start|stop}"
        exit 1
        ;;
esac

exit 0
EOF

7.6 设置脚本可执行权限

Shell权限

chmod +x /usr/local/etc/rc.d/S99mount_Btest.sh

7.7 验证启动脚本

Shell测试

# 先卸载当前挂载
umount /volume1/remote/Btest

# 用启动脚本重新挂载
/usr/local/etc/rc.d/S99mount_Btest.sh start

8 常用管理命令速查

操作	命令
查看挂载状态	mount | grep cifs
查看挂载点内容	ls -la /volume1/remote/Btest/
手动卸载	umount /volume1/remote/Btest
强制卸载（占用时）	umount -l /volume1/remote/Btest
手动挂载	mount -t cifs //192.168.1.10/Btest /volume1/remote/Btest -o username=nasadmin,password=123,noperm,nounix
测试 fstab	mount -a
查看 fstab	cat /etc/fstab
备份 fstab	cp /etc/fstab /etc/fstab.bak
恢复 fstab	cp /etc/fstab.bak /etc/fstab

9 各 Linux 发行版持久化配置差异

挂载命令通用，但开机自动挂载的配置方式因发行版而异。

9.1 Debian / Ubuntu

Shellfstab

# 编辑 fstab
nano /etc/fstab

# 添加以下行：
//192.168.1.10/Btest /mnt/Btest cifs credentials=/root/.smbcreds,uid=1000,gid=1000,_netdev 0 0

# 创建密码文件（比明文写在 fstab 中更安全）
cat > /root/.smbcreds << 'EOF'
username=nasadmin
password=123
EOF
chmod 600 /root/.smbcreds

# 创建挂载点并测试
mkdir -p /mnt/Btest
mount -a

9.2 CentOS / RHEL 7

Shellfstab

# 编辑 fstab
vi /etc/fstab

# 添加以下行：
//192.168.1.10/Btest /mnt/Btest cifs username=nasadmin,password=123,noperm,nounix,_netdev 0 0

# 创建挂载点并测试
mkdir -p /mnt/Btest
mount -a

9.3 CentOS 8+ / Rocky / Alma / Fedora

Shellfstab

# 编辑 fstab
vi /etc/fstab

# 添加以下行：
//192.168.1.10/Btest /mnt/Btest cifs username=nasadmin,password=123,noperm,nounix,_netdev 0 0

# 创建挂载点并测试
mkdir -p /mnt/Btest
mount -a

9.4 Arch / Manjaro

Shellfstab

# 编辑 fstab
nano /etc/fstab

# 添加以下行（x-systemd.automount 可按需挂载）：
//192.168.1.10/Btest /mnt/Btest cifs username=nasadmin,password=123,noperm,nounix,_netdev,x-systemd.automount 0 0

# 创建挂载点并测试
mkdir -p /mnt/Btest
mount -a

9.5 Synology DSM（群晖）

Shellfstab + 启动脚本

# fstab 添加
echo '//192.168.1.10/Btest /volume1/remote/Btest cifs username=nasadmin,password=123,noperm,nounix,_netdev 0 0' >> /etc/fstab

# 创建开机启动脚本
cat > /usr/local/etc/rc.d/S99mount_Btest.sh << 'EOF'
#!/bin/sh
case "$1" in
    start)
        mkdir -p /volume1/remote/Btest
        mount -t cifs //192.168.1.10/Btest /volume1/remote/Btest \
            -o username=nasadmin,password=123,noperm,nounix,_netdev
        ;;
    stop)
        umount /volume1/remote/Btest 2>/dev/null
        ;;
esac
EOF
chmod +x /usr/local/etc/rc.d/S99mount_Btest.sh

9.6 通用 fstab 格式说明

字段	说明	示例
远程地址	SMB 服务器和共享名	//192.168.1.10/Btest
挂载点	本地目录（需提前创建）	/mnt/Btest
文件系统类型	固定为 cifs	cifs
挂载选项	认证 + 兼容性参数	username=xx,password=xx,noperm,nounix,_netdev
dump 备份	0 = 不备份	0
fsck 检查	0 = 不检查	0

10 常见问题 & 故障排查

问题 1：mount 报错 "No username specified"

原因： mount.cifs 参数格式不对，或 DSM 内核兼容性问题。
解决： 添加 noperm,nounix 参数。

问题 2：挂载后 ls 无权限

原因： 挂载成功但目录权限异常。
解决： 加 noperm 参数跳过本地权限检查。

问题 3：umount 报 "target is busy"

原因： 有进程正在使用挂载点。
解决： 使用懒卸载 umount -l /volume1/remote/Btest。

问题 4：DSM File Station 看不到挂载目录

原因： DSM 只显示共享文件夹，命令行创建的普通目录不在 File Station 中显示。
解决： 把文件放到 DSM 已有的共享文件夹中（如 /volume1/测试文件/）。

~ 本次操作完整流程

生成时间：2026-08-21 | 系统：Synology DSM (synology_broadwell_3617xs) | 挂载点：/volume1/remote/Btest