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 文件共享
-
为装入点创建一个文件夹:请将
<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 -
使用装载命令来装载 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,serverinoNOTE
上述装载命令装载 SMB 3.0。 如果你的 Linux 分发版不支持提供加密功能的 SMB 3.0,或者仅支持 SMB 2.1,则你只能从存储帐户所在的同一区域中的 Azure VM 进行装载。 若要在不支持提供加密功能的 SMB 3.0 的 Linux 分发版上装载 Azure 文件共享,需要对存储帐户禁用传输中加密。
使用完 Azure 文件共享后,可以使用 sudo umount $mntPath 卸载共享。
使用 /etc/fstab 为 Azure 文件共享创建持久装入点
-
为装入点创建一个文件夹:可以在文件系统上的任何位置创建装入点的文件夹,但是通用约定是在 /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 -
创建凭据文件以存储文件共享的用户名(存储帐户名称)和密码(存储帐户密钥)。
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 -
更改凭据文件的权限,以便只有 root 才能读取或修改密码文件。 由于存储帐户密钥实质上是存储帐户的超级管理员密码,因此重要的是在文件上设置权限使只有 root 才能访问,这样较低权限的用户将无法检索存储帐户密钥。
sudo chmod 600 $smbCredentialFile -
使用以下命令将以下行追加到
/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 -aNOTE
上述装载命令装载 SMB 3.0。 如果你的 Linux 分发版不支持提供加密功能的 SMB 3.0,或者仅支持 SMB 2.1,则你只能从存储帐户所在的同一区域中的 Azure VM 进行装载。 若要在不支持提供加密功能的 SMB 3.0 的 Linux 分发版上装载 Azure 文件共享,需要对存储帐户禁用传输中加密。
使用 autofs 自动装载 Azure 文件共享
-
确保已安装 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 -
为共享创建装入点:
sudo mkdir /fileshares -
创建新的自定义 autofs 配置文件
sudo vi /etc/auto.fileshares -
将以下条目添加到 /etc/auto.fileshares
echo "$fileShareName -fstype=cifs,credentials=$smbCredentialFile :$smbPath"" > /etc/auto.fileshares -
将以下条目添加到 /etc/auto.master
/fileshares /etc/auto.fileshares --timeout=60 -
重启 autofs
sudo systemctl restart autofs -
访问为共享指定的文件夹
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,规范化链接,移除外部媒体、发布器占位标签和导航标记。
