大网数据广告活动
Azure 存储与备份

通过 Linux 使用 Azure 文件

· 52CE 我爱测

了解如何在 Linux 上通过 SMB 装载 Azure 文件共享。 请参阅先决条件列表。 查看 Linux 客户端上的 SMB 安全注意事项。

Azure 文件是 Microsoft 推出的易用云文件系统。 可以使用 SMB 内核客户端在 Linux 分发版中装载 Azure 文件共享。 本文介绍装载 Azure 文件共享的两种方法:使用 mount 命令按需装载,以及通过在 /etc/fstab 中创建一个条目在启动时装载。

在 Linux 上装载 Azure 文件共享的建议方法是使用 SMB 3.0。 默认情况下,Azure 文件存储要求进行传输中加密,而只有 SMB 3.0 支持传输中加密。 Azure 文件存储也支持 SMB 2.1,但后者不支持传输中加密,同时出于安全原因,不可以使用 SMB 2.1 从另一 Azure 区域或本地装载 Azure 文件共享。 除非应用程序专门需要用到 SMB 2.1,否则几乎没有任何理由使用它,因为最近发布的最流行 Linux 分发版都支持 SMB 3.0:

Linux 分发版 SMB 2.1 (装载在同一 Azure 区域内的 VM 上) SMB 3.0 (从本地和跨区域装载)
Ubuntu 14.04+ 16.04+
Red Hat Enterprise Linux (RHEL) 7+ 7.5+
CentOS 7+ 7.5+
Debian 8+ 10+
openSUSE 13.2+ 42.3+
SUSE Linux Enterprise Server 12+ 12 SP2+

如果使用的是上表中未列出的 Linux 分发版,可以通过检查 Linux 内核版本,来确定所用 Linux 分发版是否支持提供加密功能的 SMB 3.0。 提供加密功能的 SMB 3.0 已添加到 Linux 内核版本 4.11。 uname 命令将返回所用 Linux 内核的版本:

uname -r

先决条件

  • 确保已安装 cifs-utils 包。
    可在所选的 Linux 分发版上使用包管理器安装 cifs-utils 包。

    在 Ubuntu 和 基于 Debian 的分发版上,请使用 apt 包管理器:

    sudo apt update
    sudo apt install cifs-utils
    

    在“Fedora”、“Red Hat Enterprise Linux 8+”和“CentOS 8+”中,请使用 dnf 包管理器:

    sudo dnf install cifs-utils
    

    在旧版的“Red Hat Enterprise Linux”和“CentOS”中,请使用 yum 包管理器:

    sudo yum install cifs-utils 
    

    在 openSUSE 上,请使用 zypper 包管理器:

    sudo zypper install cifs-utils
    

    在其他分发版上,请使用相应的包管理器,或从源编译

  • 最新版本的 Azure 命令行接口 (CLI)。 若要详细了解如何安装 Azure CLI,请参阅安装 Azure CLI 并选择操作系统。 如果你想要在 PowerShell 6+ 中使用 Azure PowerShell 模块,也可以使用,不过,下面的说明适用于 Azure CLI。

  • 确保端口 445 处于打开状态:SMB 通过 TCP 端口 445 通信 - 请查看防火墙是否未阻止 TCP 端口 445 与客户端计算机通信。 替换 <your-resource-group> 和 <your-storage-account>,然后运行以下脚本:

    resourceGroupName="<your-resource-group>"
    storageAccountName="<your-storage-account>"
    
    # This command assumes you have logged in with az login
    httpEndpoint=$(az storage account show \
        --resource-group $resourceGroupName \
        --name $storageAccountName \
        --query "primaryEndpoints.file" | tr -d '"')
    smbPath=$(echo $httpEndpoint | cut -c7-$(expr length $httpEndpoint))
    fileHost=$(echo $smbPath | tr -d "/")
    
    nc -zvw3 $fileHost 445
    

    如果连接成功,应会看到如下所示的输出:

    Connection to <your-storage-account> 445 port [tcp/microsoft-ds] succeeded!
    

    如果无法在企业网络中打开端口 445,或者 ISP 阻止此类操作,可以使用 VPN 连接或 ExpressRoute 来解决端口 445 的相关问题。 有关详细信息,请参阅直接访问 Azure 文件共享时的网络注意事项。

装载 Azure 文件共享

若要在 Linux 分发版中使用 Azure 文件共享,必须创建一个充当 Azure 文件共享装入点的目录。 可以在 Linux 系统上的任何位置创建装入点,但是通用约定是在 /mnt 下创建此装入点。 创建装入点之后,使用 mount 命令访问 Azure 文件共享。

如果需要,可将同一个 Azure 文件共享装载到多个装入点。

使用 mount 按需装载 Azure 文件共享

  1. 为装入点创建一个文件夹:请将 <your-resource-group>、<your-storage-account> 和 <your-file-share> 替换为适合你的环境的信息。

    resourceGroupName="<your-resource-group>"
    storageAccountName="<your-storage-account>"
    fileShareName="<your-file-share>"
    
    mntPath="/mnt/$storageAccountName/$fileShareName"
    
    sudo mkdir -p $mntPath
    
  2. 使用装载命令来装载 Azure 文件共享。 在以下示例中,本地 Linux 文件和文件夹权限默认为 0755,表示所有者拥有读取、写入和执行权限(基于文件/目录 Linux 所有者),所有者组中的用户拥有读取和执行权限,系统中的其他用户拥有读取和执行权限。 可以使用 uid 和 gid 装载选项来设置装入点的用户 ID 和组 ID。 还可根据需要使用 dir_mode 和 file_mode 来设置自定义权限。 有关如何设置权限的详细信息,请参阅 Wikipedia 上的 UNIX 数值表示法。

    # This command assumes you have logged in with az login
    httpEndpoint=$(az storage account show \
        --resource-group $resourceGroupName \
        --name $storageAccountName \
        --query "primaryEndpoints.file" | tr -d '"')
    smbPath=$(echo $httpEndpoint | cut -c7-$(expr length $httpEndpoint))$fileShareName
    
    storageAccountKey=$(az storage account keys list \
        --resource-group $resourceGroupName \
        --account-name $storageAccountName \
        --query "[0].value" | tr -d '"')
    
    sudo mount -t cifs $smbPath $mntPath -o vers=3.0,username=$storageAccountName,password=$storageAccountKey,serverino
    

    NOTE
    上述装载命令装载 SMB 3.0。 如果你的 Linux 分发版不支持提供加密功能的 SMB 3.0,或者仅支持 SMB 2.1,则你只能从存储帐户所在的同一区域中的 Azure VM 进行装载。 若要在不支持提供加密功能的 SMB 3.0 的 Linux 分发版上装载 Azure 文件共享,需要对存储帐户禁用传输中加密。

使用完 Azure 文件共享后,可以使用 sudo umount $mntPath 卸载共享。

使用 /etc/fstab 为 Azure 文件共享创建持久装入点

  1. 为装入点创建一个文件夹:可以在文件系统上的任何位置创建装入点的文件夹,但是通用约定是在 /mnt 文件夹下创建此文件夹。 例如,以下命令(请将 <your-resource-group>、<your-storage-account> 和 <your-file-share> 替换为适用于你的环境的信息)会创建一个新目录:

    resourceGroupName="<your-resource-group>"
    storageAccountName="<your-storage-account>"
    fileShareName="<your-file-share>"
    
    mntPath="/mnt/$storageAccountName/$fileShareName"
    
    sudo mkdir -p $mntPath
    
  2. 创建凭据文件以存储文件共享的用户名(存储帐户名称)和密码(存储帐户密钥)。

    if [ ! -d "/etc/smbcredentials" ]; then
        sudo mkdir "/etc/smbcredentials"
    fi
    
    storageAccountKey=$(az storage account keys list \
        --resource-group $resourceGroupName \
        --account-name $storageAccountName \
        --query "[0].value" | tr -d '"')
    
    smbCredentialFile="/etc/smbcredentials/$storageAccountName.cred"
    if [ ! -f $smbCredentialFile ]; then
        echo "username=$storageAccountName" | sudo tee $smbCredentialFile > /dev/null
        echo "password=$storageAccountKey" | sudo tee -a $smbCredentialFile > /dev/null
    else 
        echo "The credential file $smbCredentialFile already exists, and was not modified."
    fi
    
  3. 更改凭据文件的权限,以便只有 root 才能读取或修改密码文件。 由于存储帐户密钥实质上是存储帐户的超级管理员密码,因此重要的是在文件上设置权限使只有 root 才能访问,这样较低权限的用户将无法检索存储帐户密钥。

    sudo chmod 600 $smbCredentialFile
    
  4. 使用以下命令将以下行追加到 /etc/fstab :在以下示例中,本地 Linux 文件和文件夹权限默认为 0755,表示所有者拥有读取、写入和执行权限(基于文件/目录 Linux 所有者),所有者组中的用户拥有读取和执行权限,系统中的其他用户拥有读取和执行权限。 可以使用 uid 和 gid 装载选项来设置装入点的用户 ID 和组 ID。 还可根据需要使用 dir_mode 和 file_mode 来设置自定义权限。 有关如何设置权限的详细信息,请参阅 Wikipedia 上的 UNIX 数值表示法。

    # This command assumes you have logged in with az login
    httpEndpoint=$(az storage account show \
        --resource-group $resourceGroupName \
        --name $storageAccountName \
        --query "primaryEndpoints.file" | tr -d '"')
    smbPath=$(echo $httpEndpoint | cut -c7-$(expr length $httpEndpoint))$fileShareName
    
    if [ -z "$(grep $smbPath\ $mntPath /etc/fstab)" ]; then
        echo "$smbPath $mntPath cifs nofail,vers=3.0,credentials=$smbCredentialFile,serverino" | sudo tee -a /etc/fstab > /dev/null
    else
        echo "/etc/fstab was not modified to avoid conflicting entries as this Azure file share was already present. You may want to double check /etc/fstab to ensure the configuration is as desired."
    fi
    
    sudo mount -a
    

    NOTE
    上述装载命令装载 SMB 3.0。 如果你的 Linux 分发版不支持提供加密功能的 SMB 3.0,或者仅支持 SMB 2.1,则你只能从存储帐户所在的同一区域中的 Azure VM 进行装载。 若要在不支持提供加密功能的 SMB 3.0 的 Linux 分发版上装载 Azure 文件共享,需要对存储帐户禁用传输中加密。

使用 autofs 自动装载 Azure 文件共享

  1. 确保已安装 autofs 包。

    可在所选的 Linux 分发版上使用包管理器安装 utofs 包。

    在 Ubuntu 和 基于 Debian 的分发版上,请使用 apt 包管理器:

    sudo apt update
    sudo apt install autofs
    

    在“Fedora”、“Red Hat Enterprise Linux 8+”和“CentOS 8+”中,请使用 dnf 包管理器:

    sudo dnf install autofs
    

    在旧版的“Red Hat Enterprise Linux”和“CentOS”中,请使用 yum 包管理器:

    sudo yum install autofs 
    

    在 openSUSE 上,请使用 zypper 包管理器:

    sudo zypper install autofs
    
  2. 为共享创建装入点:

     sudo mkdir /fileshares
    
  3. 创建新的自定义 autofs 配置文件

    sudo vi /etc/auto.fileshares
    
  4. 将以下条目添加到 /etc/auto.fileshares

    echo "$fileShareName -fstype=cifs,credentials=$smbCredentialFile :$smbPath"" > /etc/auto.fileshares
    
  5. 将以下条目添加到 /etc/auto.master

    /fileshares /etc/auto.fileshares --timeout=60
    
  6. 重启 autofs

    sudo systemctl restart autofs
    
  7. 访问为共享指定的文件夹

    cd /fileshares/$filesharename
    

保护 Linux

若要在 Linux 上装载 Azure 文件共享,端口 445 必须可访问。 由于 SMB 1 固有的安全风险,许多组织会阻止端口 445。 SMB 1(也称为通用 Internet 文件系统,简称 CIFS)是许多 Linux 分发版随附的一个传统文件系统协议。 SMB 1 是一个已过时的低效协议,最重要的是,它不安全。 好消息是 Azure 文件存储不支持 SMB 1,并且从 Linux 内核版本 4.18 开始,可在 Linux 中禁用 SMB 1。 我们始终强烈建议在生产环境中使用 SMB 文件共享之前,禁用 Linux 客户端上的 SMB 1。

从 Linux 内核 4.18 开始,SMB 内核模块(由于历史遗留原因,称作 cifs)会公开一个名为 disable_legacy_dialects 的新模块参数(在各种外部文档中通常名为 parm)。 尽管 Linux 内核 4.18 中已引入此项更改,但某些供应商会将此项更改向后移植到他们支持的旧内核。 为方便起见,下表详细描述了此模块参数在常用 Linux 分发版上的可用性。

分发 可以禁用 SMB 1
Ubuntu 14.04-16.04 否
Ubuntu 18.04 是
Ubuntu 19.04+ 是
Debian 8-9 否
Debian 10+ 是
Fedora 29+ 是
CentOS 7 否
CentOS 8+ 是
Red Hat Enterprise Linux 6.x-7.x 否
Red Hat Enterprise Linux 8+ 是
openSUSE Leap 15.0 否
openSUSE Leap 15.1+ 是
openSUSE Tumbleweed 是
SUSE Linux Enterprise 11.x-12.x 否
SUSE Linux Enterprise 15 否
SUSE Linux Enterprise 15.1 否

可通过以下命令检查所用 Linux 分发版是否支持 disable_legacy_dialects 模块参数。

sudo modinfo -p cifs | grep disable_legacy_dialects

此命令应输出以下消息:

disable_legacy_dialects: To improve security it may be helpful to restrict the ability to override the default dialects (SMB2.1, SMB3 and SMB3.02) on mount with old dialects (CIFS/SMB1 and SMB2) since vers=1.0 (CIFS/SMB1) and vers=2.0 are weaker and less secure. Default: n/N/0 (bool)

在禁用 SMB 1 之前,必须检查并确保 SMB 模块当前尚未加载到系统中(如果已装载 SMB 共享,则此模块会自动加载到系统中)。 可使用以下命令来执行此项检查。如果未加载 SMB,则此命令不会输出任何信息:

lsmod | grep cifs

若要卸载该模块,请先卸载所有 SMB 共享(使用上面所述的 umount 命令)。 可使用以下命令识别系统上所有已装载的 SMB 共享:

mount | grep cifs

卸载所有 SMB 文件共享后,可以安全地卸载该模块。 为此,可以使用 modprobe 命令:

sudo modprobe -r cifs

可以使用 modprobe 命令手动加载已卸载 SMB 1 的模块:

sudo modprobe cifs disable_legacy_dialects=Y

最后,可以通过查看 /sys/module/cifs/parameters 中加载的参数,来检查是否已使用相应参数加载了 SMB 模块:

cat /sys/module/cifs/parameters/disable_legacy_dialects

若要在 Ubuntu 和基于 Debian 的分发版上永久禁用 SMB 1,必须创建一个名为 /etc/modprobe.d/local.conf 且包含相应设置的新文件(如果尚未对其他模块使用自定义选项)。 为此,可以使用以下命令:

echo "options cifs disable_legacy_dialects=Y" | sudo tee -a /etc/modprobe.d/local.conf > /dev/null

可以通过加载 SMB 模块来验证上述操作是否成功:

sudo modprobe cifs
cat /sys/module/cifs/parameters/disable_legacy_dialects

后续步骤

请参阅以下链接,获取有关 Azure 文件的更多信息:

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 roygara)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 10/19/2019
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。